onboard

name	onboard
version	2.0
category	utilities
execution_speed	fast
token_efficiency	high
triggers	["/onboard","onboard","first run","get started","what skills do I have","show me my skills","new here"]
cache_key	onboard-2.0
dependencies	[]
disable-model-invocation	true
description	Interactive first-run experience for new Claude-ITect installs. Asks 3 short questions about workflow style, project type, and communication preference. Generates a personalized 5-skill starter roadmap. Runs once per install via sentinel file; re-run manually with /onboard --reset.

What This Skill Does

Guides new users from "installed 54 skills, now what?" to a personalized starter pack in under 3 minutes. On first run, presents a 3-question questionnaire and outputs a green-themed skill roadmap. On repeat runs, shows the existing roadmap or skips if --reset not passed.

First-Run Detection

Before doing anything:

1. Check if .claude/.onboard-seen exists in the project root.
2. If file exists and --reset was NOT passed: skip questionnaire. Say: "Already onboarded. Run /onboard --reset to redo." Then show a brief summary of the 5 skills from first run if the file contains them.
3. If file does not exist (or --reset was passed): run the questionnaire below.

Questionnaire

Ask questions ONE AT A TIME. Wait for user response before continuing. Numbered choices only -- no open input.

---

Question 1 of 3 -- What is your style?

[ 1 ] Speed demon    -- Move fast, stay terse, cut token overhead
[ 2 ] Nitpicker      -- Deep review, thorough analysis, catch every issue
[ 3 ] Builder        -- Execute plans, ship features, orchestrate agents

---

Question 2 of 3 -- What are you working on?

[ 1 ] Application code   -- Features, bugs, refactors
[ 2 ] Architecture       -- Design decisions, ADRs, planning
[ 3 ] Writing / docs     -- Articles, READMEs, technical writing

---

Question 3 of 3 -- How should Claude talk to you?

[ 1 ] Caveman mode   -- Compressed, minimal, fast (saves ~300 tokens/session)
[ 2 ] Normal         -- Clear, complete, standard responses
[ 3 ] Structured     -- Formal, section-headed, doc-style output

---

Routing Table

Run node .claude/skills/onboard/route.js <Speed|Nitpick|Builder> <App|Arch|Writing> <Caveman|Normal|Structured> with the three answers. Prints the 5 suggested skill names, one per line, no repeats. The lookup table lives in route.json next to this file.

Output Format

After collecting all 3 answers, output this block. Use ASCII only -- no emoji, no Unicode special chars. Replace placeholders with actual values:

[################] 100% -- Onboarding complete

Welcome, Claude-Itect!

You now have 51 skills. Here are yours.

Based on your answers: [STYLE] / [PROJECT TYPE] / [COMMUNICATION]

Your starter pack:
  1. /[skill-1]  -- [one-line what it does]
  2. /[skill-2]  -- [one-line what it does]
  3. /[skill-3]  -- [one-line what it does]
  4. /[skill-4]  -- [one-line what it does]
  5. /[skill-5]  -- [one-line what it does]

Run any skill: /skill-name
See all skills: /audit
Reset this:    /onboard --reset

The one-line descriptions should be pulled from the skill's description frontmatter field if accessible; otherwise use your knowledge of the skill.

Completion

After outputting the roadmap:

1. Write .claude/.onboard-seen in the project root containing an ISO timestamp and the 5 recommended skill names, one per line:

   2026-05-24T00:00:00Z
   skill-1
   skill-2
   skill-3
   skill-4
   skill-5
   

2. Do not say "I wrote the file" -- the output block is the completion signal.
3. Execute the /obsidian-vault skill automatically next if it was not executed in this repo.
4. Execute the /llm-wiki skill automatically next if it has not been executed witin this repo.
5. Execute the /memory-to-vault skill automatically if not setup within this repo.
6. Execute the /setup-joseph-childree-skills skill automatically if it was not setup for this project.

Boundaries

• Never re-run the full questionnaire without --reset flag.
• Never suggest more than 5 skills.
• If a skill name from the routing table does not exist in .claude/skills/, substitute audit as fallback.
• Tone: direct, efficient, confident. Not corporate. Not gushing. The user just installed 51 skills -- treat them as a builder, not a tourist.