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: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:
- Load
references/{platform}-onboarding.md for 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
1---2name: onboarding3description: 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.4---5
6# Developer Onboarding
7
8Complete developer environment setup guides across all major platforms.
9
10## Overview
11
12This skill provides step-by-step onboarding documentation for setting up:
13
14- **Package managers** (winget, Homebrew, apt, pacman)
15- **Runtime environments** (NVM for Node.js)
16- **Shell & terminal** (PowerShell, Zsh, Bash customization)
17- **Code editors** (VS Code, JetBrains, Neovim)
18- **AI tooling** (Claude Code, Cursor, LM Studio, Gemini CLI)
19- **Containerization** (Docker setup)
20- **Cloud platforms** (Azure CLI)
21- **Database tools** (DBeaver, Azure Data Studio)
22- **Security tools** (GPG, SSH, Windows Sandbox)
23- **Productivity tools** (Figma, various utilities)
24
25## When to Use This Skill
26
27Use this skill when:
28
29- Setting up a new development machine
30- Onboarding new developers to a team
31- Finding platform-specific installation instructions
32- Configuring developer tools across Windows, macOS, Linux, or WSL
33- Looking for best practices in environment setup
34- Troubleshooting developer tool installations
35
36## Quick Start by Platform
37
38### Windows
39
40Main Guide: [references/windows-onboarding.md](references/windows-onboarding.md)
41
42Follow the ordered steps covering WSL, package management, Git (via git skills), runtime environments, shell configuration, and development tools.
43
44### macOS
45
46Main Guide: [references/macos-onboarding.md](references/macos-onboarding.md)
47
48Follow the ordered steps covering Homebrew, Git (via git skills), runtime environments, shell configuration, and development tools.
49
50### Linux
51
52Main Guide: [references/linux-onboarding.md](references/linux-onboarding.md)
53
54Follow the ordered steps covering package management, Git (via git skills), runtime environments, shell configuration, and development tools.
55
56## Topics Index
57
58| Topic | Windows | macOS | Linux | WSL |
59| --- | --- | --- | --- | --- |
60| Package Management | [Windows](references/package-management/package-managers-windows.md) | [macOS](references/package-management/package-managers-macos.md) | [Linux](references/package-management/package-managers-linux.md) | - |
61| WSL Setup | [Windows](references/wsl/wsl-setup-windows.md) | - | - | - |
62| Linux Fundamentals | - | - | [Linux](references/linux-fundamentals/common-commands-linux.md) | [WSL](references/linux-fundamentals/common-commands-wsl.md) |
63| Runtime Environments | [Windows](references/runtime-environments/nvm-setup-windows.md) | [macOS](references/runtime-environments/nvm-setup-macos.md) | [Linux](references/runtime-environments/nvm-setup-linux.md) | - |
64| PowerShell | [Windows](references/shell-terminal/powershell-setup-windows.md) | [macOS](references/shell-terminal/powershell-setup-macos.md) | [Linux](references/shell-terminal/powershell-setup-linux.md) | - |
65| Shell Customization | [Windows](references/shell-terminal/shell-customization-windows.md) | [macOS](references/shell-terminal/shell-customization-macos.md) | [Linux](references/shell-terminal/shell-customization-linux.md) | - |
66| Alternative Shells | [Windows](references/shell-terminal/alternative-shells-windows.md) | [macOS](references/shell-terminal/alternative-shells-macos.md) | [Linux](references/shell-terminal/alternative-shells-linux.md) | - |
67| Code Editors | [Windows](references/code-editors/code-editors-windows.md) | [macOS](references/code-editors/code-editors-macos.md) | [Linux](references/code-editors/code-editors-linux.md) | - |
68| AI Tooling | [Windows](references/ai-tooling/ai-tooling-windows.md) | [macOS](references/ai-tooling/ai-tooling-macos.md) | [Linux](references/ai-tooling/ai-tooling-linux.md) | - |
69| Docker | [Windows](references/containerization/docker-setup-windows.md) | [macOS](references/containerization/docker-setup-macos.md) | [Linux](references/containerization/docker-setup-linux.md) | - |
70| API Tools | [Windows](references/api-development/api-tools-windows.md) | [macOS](references/api-development/api-tools-macos.md) | [Linux](references/api-development/api-tools-linux.md) | [WSL](references/api-development/api-tools-wsl.md) |
71| Web Browsers | [Windows](references/web-browsers/browsers-windows.md) | [macOS](references/web-browsers/browsers-macos.md) | [Linux](references/web-browsers/browsers-linux.md) | - |
72| Azure CLI | [Windows](references/cloud-platforms/azure-cli-setup-windows.md) | [macOS](references/cloud-platforms/azure-cli-setup-macos.md) | [Linux](references/cloud-platforms/azure-cli-setup-linux.md) | - |
73| Database Tools | [Windows](references/database-tools/database-tools-windows.md) | [macOS](references/database-tools/database-tools-macos.md) | [Linux](references/database-tools/database-tools-linux.md) | - |
74| Productivity | [Windows](references/productivity/productivity-tools-windows.md) | [macOS](references/productivity/productivity-tools-macos.md) | [Linux](references/productivity/productivity-tools-linux.md) | - |
75| Figma | [Windows](references/productivity/figma-setup-windows.md) | [macOS](references/productivity/figma-setup-macos.md) | [Linux](references/productivity/figma-setup-linux.md) | - |
76| Security Tools | [Windows](references/security/security-tools-windows.md) | [macOS](references/security/security-tools-macos.md) | [Linux](references/security/security-tools-linux.md) | - |
77| Windows Sandbox | [Windows](references/security/windows-sandbox.md) | - | - | - |
78| System Utilities | [Windows](references/system-tools/system-utilities-windows.md) | [macOS](references/system-tools/system-utilities-macos.md) | [Linux](references/system-tools/system-utilities-linux.md) | - |
79| Other | [Windows](references/other/other-windows.md) | [macOS](references/other/other-macos.md) | [Linux](references/other/other-linux.md) | - |
80
81## Cross-Platform Content
82
83- [Database Tools Overview](references/database-tools/database-tools.md) - Platform-agnostic database tools guide
84- [GitHub Spec Kit](references/ai-tooling/github-spec-kit.md) - AI-assisted specification development
85
86## Git and Version Control
87
88Git documentation has been consolidated into dedicated Claude Code skills for better maintainability:
89
90- **git:setup** skill: Git installation and basic configuration
91- **git:line-endings** skill: Cross-platform line ending configuration
92- **git:gui-tools** skill: Git GUI client recommendations
93- **git:git-config** skill: Comprehensive Git configuration
94- **git:gpg-signing** skill: Commit signing setup
95
96Invoke these skills directly for Git-related guidance.
97
98## Platform Detection
99
100When helping users, detect their platform via:
101
102- **Windows**: `$env:OS` contains "Windows", PowerShell, `winget`
103- **macOS**: `uname -s` returns "Darwin", `brew`
104- **Linux**: `uname -s` returns "Linux", `apt`/`dnf`/`pacman`
105- **WSL**: Linux kernel + `/mnt/c/` paths
106
107## Reference Loading Guide
108
109All references are **conditionally loaded** based on detected platform:
110
1111. Load `references/{platform}-onboarding.md` for platform entry point
1122. Load topic-specific references as needed from `references/{topic}/`
1133. Cross-reference with git skills for version control setup
114
115**Token efficiency**: Entry point + 2-3 topic references is typical load (~200-400 lines)
116
117---
118
119**Last Updated:** 2025-12-01
120
121## Version History
122
123- **v1.0.0** (2025-12-26): Initial release
124
125---
majiayu000