onboarding

Collect user identity details and write soul.md and persona.md files.

38|14|Updated Mar 1, 2026

Search Tags:#onboarding #configuration #persona #identity #agent-setup #soul

Ready to run

npx skills add https://github.com/ericwang915/PythonClaw --skill onboarding-ericwang915

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: onboarding
Source: https://github.com/ericwang915/PythonClaw/tree/main/pythonclaw/templates/skills/system/onboarding
Command: npx skills add https://github.com/ericwang915/PythonClaw --skill onboarding-ericwang915

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

First-time setup for a PythonClaw agent often requires manual configuration of the agent's identity. This skill automates that process by guiding the user to provide their name, personality, focus area, and language, then generates the foundational soul and persona.

Core Features & Use Cases

Guided prompts to collect name, personality, focus, and language in a friendly, conversational flow.
Automatically writes context/soul/SOUL.md and context/persona/persona.md to establish the agent's core identity.
Supports reconfiguration flows to reset or update soul and persona when requested by the user.

Quick Start

Run the onboarding skill on first startup to generate soul.md and persona.md and initialize the agent's identity.

Frequently Asked Questions about onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I set up an agent's identity and persona configuration on first startup?▼

Agent identity configuration on first startup is handled by a guided conversational flow that collects your name, personality, focus area, and language, then automatically writes the foundational soul and persona files.

Can I reset or update my agent's persona and soul after the initial setup?▼

Yes, you can update persona and soul configurations by requesting reconfiguration, which triggers the setup flow again to rewrite soul.md and persona.md with your new identity details.

What files are generated when configuring an agent's identity and where are they stored?▼

Configuring agent identity generates SOUL.md and persona.md, which are stored under ~/.pythonclaw/context/soul and ~/.pythonclaw/context/persona to establish the agent's core identity.

Do I need any external dependencies to initialize my agent's identity configuration?▼

No external dependencies are required to initialize agent identity configuration, as the setup process relies solely on the bundled write_identity.py script to handle the end-to-end flow.

What's the best way to automate first-time agent setup instead of manual configuration?▼

Automating first-time agent setup is best done by running the onboarding skill, which guides you through conversational prompts to collect identity details and automatically writes the foundational context files.

Why does my agent need soul and persona files configured before use?▼

Soul and persona files are needed to establish the agent's core identity, personality, and focus area, ensuring the agent responds with a consistent identity and behavioral context.