---

name: onboarding description: Developer environment setup guides for Windows, macOS, Linux, and WSL. Use when setting up development machines, installing tools, configuring environments, or following platform-specific setup guides. Covers package management, shell/terminal, code editors, AI tooling, containerization, databases, and more. allowed-tools: Read, Glob, Grep, Bash

Developer Onboarding

Complete developer environment setup guides across all major platforms.

Overview

This skill provides step-by-step onboarding documentation for setting up:

• Package managers (winget, Homebrew, apt, pacman)
• Runtime environments (NVM for Node.js)
• Shell & terminal (PowerShell, Zsh, Bash customization)
• Code editors (VS Code, JetBrains, Neovim)
• AI tooling (Claude Code, Cursor, LM Studio, Gemini CLI)
• Containerization (Docker setup)
• Cloud platforms (Azure CLI)
• Database tools (DBeaver, Azure Data Studio)
• Security tools (GPG, SSH, Windows Sandbox)
• Productivity tools (Figma, various utilities)

When to Use This Skill

Use this skill when:

• Setting up a new development machine
• Onboarding new developers to a team
• Finding platform-specific installation instructions
• Configuring developer tools across Windows, macOS, Linux, or WSL
• Looking for best practices in environment setup
• Troubleshooting developer tool installations

Quick Start by Platform

Windows

Main Guide: references/windows-onboarding.md

Follow the ordered steps covering WSL, package management, Git (via git skills), runtime environments, shell configuration, and development tools.

macOS

Main Guide: references/macos-onboarding.md

Follow the ordered steps covering Homebrew, Git (via git skills), runtime environments, shell configuration, and development tools.

Linux

Main Guide: references/linux-onboarding.md

Follow the ordered steps covering package management, Git (via git skills), runtime environments, shell configuration, and development tools.

Topics Index

Topic	Windows	macOS	Linux	WSL
Package Management	Windows	macOS	Linux	-
WSL Setup	Windows	-	-	-
Linux Fundamentals	-	-	Linux	WSL
Runtime Environments	Windows	macOS	Linux	-
PowerShell	Windows	macOS	Linux	-
Shell Customization	Windows	macOS	Linux	-
Alternative Shells	Windows	macOS	Linux	-
Code Editors	Windows	macOS	Linux	-
AI Tooling	Windows	macOS	Linux	-
Docker	Windows	macOS	Linux	-
API Tools	Windows	macOS	Linux	WSL
Web Browsers	Windows	macOS	Linux	-
Azure CLI	Windows	macOS	Linux	-
Database Tools	Windows	macOS	Linux	-
Productivity	Windows	macOS	Linux	-
Figma	Windows	macOS	Linux	-
Security Tools	Windows	macOS	Linux	-
Windows Sandbox	Windows	-	-	-
System Utilities	Windows	macOS	Linux	-
Other	Windows	macOS	Linux	-

Cross-Platform Content

• Database Tools Overview - Platform-agnostic database tools guide
• GitHub Spec Kit - AI-assisted specification development

Git and Version Control

Git documentation has been consolidated into dedicated Claude Code skills for better maintainability:

• git:setup skill: Git installation and basic configuration
• git:line-endings skill: Cross-platform line ending configuration
• git:gui-tools skill: Git GUI client recommendations
• git:config skill: Comprehensive Git configuration
• git:gpg-signing skill: Commit signing setup

Invoke these skills directly for Git-related guidance.

Platform Detection

When helping users, detect their platform via:

• Windows: $env:OS contains "Windows", PowerShell, winget
• macOS: uname -s returns "Darwin", brew
• Linux: uname -s returns "Linux", apt/dnf/pacman
• WSL: Linux kernel + /mnt/c/ paths

Reference Loading Guide

All references are conditionally loaded based on detected platform:

1. Load references/{platform}-onboarding.md for platform entry point
2. Load topic-specific references as needed from references/{topic}/
3. Cross-reference with git skills for version control setup

Token efficiency: Entry point + 2-3 topic references is typical load (~200-400 lines)

---

Last Updated: 2025-12-01