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