| 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:OScontains "Windows", PowerShell,winget - macOS:
uname -sreturns "Darwin",brew - Linux:
uname -sreturns "Linux",apt/dnf/pacman - WSL: Linux kernel +
/mnt/c/paths
Reference Loading Guide
All references are conditionally loaded based on detected platform:
- Load
references/{platform}-onboarding.mdfor platform entry point - Load topic-specific references as needed from
references/{topic}/ - 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
Version History
- v1.0.0 (2025-12-26): Initial release