# 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).

- **Type:** Skill
- **Install:** `agentstack add skill-ericwang915-pythonclaw-onboarding`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ericwang915](https://agentstack.voostack.com/s/ericwang915)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ericwang915](https://github.com/ericwang915)
- **Source:** https://github.com/ericwang915/PythonClaw/tree/main/pythonclaw/templates/skills/system/onboarding
- **Website:** https://github.com/ericwang915/PythonClaw

## Install

```sh
agentstack add skill-ericwang915-pythonclaw-onboarding
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

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

**Write soul.md:**
```bash
python {skill_path}/write_identity.py --type soul \
  --user-name "NAME" \
  --personality "PERSONALITY" \
  --focus "FOCUS" \
  --language "LANGUAGE"
```

**Write persona.md:**
```bash
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`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ericwang915](https://github.com/ericwang915)
- **Source:** [ericwang915/PythonClaw](https://github.com/ericwang915/PythonClaw)
- **License:** MIT
- **Homepage:** https://github.com/ericwang915/PythonClaw

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ericwang915-pythonclaw-onboarding
- Seller: https://agentstack.voostack.com/s/ericwang915
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.