onboardinglisted

# Onboarding Welcome to . This skill guides new users through initial setup and daily usage. ## When to use - User asks "where do I start?" or "how does this work?" - First-time setup after `chezmoi apply` - Troubleshooting a broken installation - Onboarding a teammate ## Step 1 — Validate setup ```bash doctor ``` Expected: `result: COMPLIANT`. If any check fails, `doctor` shows the fix command. For persistent issues: ```bash update-check # check for available updates skills list # verify skills are installed skills sync # re-sync symlinks to AI tools ``` ## Step 2 — Understand the hierarchy ```text User message ↓ Orchestrator (assistant) ↓ routes to Workflow skill (WHAT — decides scope and gates) e.g. workflow-generic-project ↓ delegates to Tool skill (HOW — executes CLI commands) e.g. clickup-cli, github-cli-workflow ``` **Skills** are invoked via the skill tool (e.g. `/planning`). **Agents** are invoked via `@mention` (e.g. `@planner`). Never use the skill tool for agents. ## Step 3 — First commands by role ### Developer ```bash # Start any task /workflow-generic-project # After code changes — review before PR @code-reviewer # CI failing /gh-fix-ci ``` ### Product Manager / Tech Lead ```bash # Plan a feature @planner # Create a ClickUp task /clickup-cli # then: clickup task create --current --name "..." # Project health check /project-assessment ``` ### Anyone ```bash # Check workstation health d