PythonClaw onboarding

First-time setup wizard that collects user name, agent personality, focus area, and language preference, then writes soul.md and persona.md. Use when: agent starts for the first time with no soul/persona configured, or user says reconfigure, setup, change my agent. NOT for: incremental edits to persona or soul (use change_persona or change_soul instead).

install

source · Clone the upstream repo

git clone https://github.com/ericwang915/PythonClaw

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ericwang915/PythonClaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/pythonclaw/templates/skills/system/onboarding" ~/.claude/skills/ericwang915-pythonclaw-onboarding && rm -rf "$T"

manifest: pythonclaw/templates/skills/system/onboarding/SKILL.md

source content

Onboarding Skill

First-time setup wizard that guides users through configuring their agent identity.

When to Use

✅ USE this skill when:

Agent starts with empty/default soul.md and persona.md
User says "reconfigure", "setup", "change my agent", "first-time setup"
User wants a guided flow to set name, personality, focus, and language in one go

When NOT to Use

❌ DON'T use this skill when:

User wants to tweak one aspect of persona (e.g., "be more formal") → use change_persona
User wants to change soul only (e.g., "call me Alex") → use change_soul
Agent already has configured soul and persona and user just wants small edits

Usage/Commands

Onboarding flow — Ask these questions one at a time in a friendly, conversational tone:

Name: "What should I call you?"
Personality: "What kind of personality would you like me to have? (e.g. professional & concise, friendly & casual, humorous, formal, encouraging)"
Focus area: "What area would you like me to focus on? (e.g. software development, finance, research, daily assistant, creative writing)"
Language preference: "What language do you prefer I respond in? (English, Chinese, etc.)"

Write soul.md:

python {skill_path}/write_identity.py --type soul \
  --user-name "NAME" \
  --personality "PERSONALITY" \
  --focus "FOCUS" \
  --language "LANGUAGE"

Write persona.md:

python {skill_path}/write_identity.py --type persona \
  --user-name "NAME" \
  --personality "PERSONALITY" \
  --focus "FOCUS" \
  --language "LANGUAGE"

After writing, tell the user: "Setup complete! Your preferences have been saved. Use

/clear

to start a fresh conversation with your new identity, or just keep chatting."

Notes

Uses bundled
```
write_identity.py
```
to generate soul.md and persona.md

Files are written to

context/soul/SOUL.md

and

context/persona/persona.md