onboarding

Onboarding

Run this once when Claw is freshly installed.

Detect cold start

Read ${CLAUDE_PLUGIN_ROOT}/identity/USER.md. If it still contains the literal placeholder text _(your name)_, you are in a cold-start state. Otherwise, this skill is a no-op — tell the user "already onboarded" and stop.

Conversation flow

Ask only these questions, one at a time, in this order. Don't bundle. Don't add clarifications unless the user asks.

1. "What's your name and email?"
2. "What do you do? (one or two sentences)"
3. "What are you working on right now?"
4. "How do you want me to talk to you — terse, normal, or detailed?"
5. "Should I act on low-risk decisions or always confirm first?"

After each answer, immediately write the relevant section into USER.md using Edit. Don't batch — write as you go so a crash doesn't lose the answers.

Voice tuning

After question 4, also update SOUL.md:

• terse → keep "Short sentences. The user reads quickly." and add "No headers, no bullet lists unless asked."
• detailed → soften "Short sentences" to "Be thorough but skimmable. Use headers for anything over five lines."

Wrap-up

Once USER.md has all five sections filled in:

1. Re-read USER.md and SOUL.md to confirm.
2. Send: "You're set up. From now on I'll boot with what you just told me. Run /boot after editing identity files to reload."
3. Suggest one of: /cron add (set up a daily routine), /skill list (see what I can do), or "just ask me something."

Do not

• Do not ask about API keys here. The installer handles those.
• Do not ask about messaging platforms here. That's a separate gateway setup — point at docs/messaging-gateway.md.
• Do not run any external tools. This skill is text-only.