onboarding

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

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:

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

Version History

• v1.0.0 (2025-12-26): Initial release