
Bootstrap Soul
FreePersonalize your AI partner through guided conversation.
Free · Opens the source repo
What Bootstrap Soul does
Bootstrap Soul is a conversational onboarding skill designed to help users create a personalized SOUL.md for their AI partner. By engaging in a structured dialogue, the skill extracts essential information about the user’s preferences, needs, and aspirations over a series of 5 to 8 adaptive rounds. This process ensures that the AI understands the user's context and can respond in a manner that aligns with their expectations.
The onboarding process is divided into four key phases: Hello, You, Personality, and Depth. Each phase focuses on different aspects of the user’s identity and requirements. In the initial phase, the skill establishes the preferred language and first impressions. As the conversation progresses, it delves into the user’s role, pain points, and the desired traits of their AI partner. The final phases explore deeper aspirations and boundaries, ensuring a well-rounded understanding of the user’s vision for their AI.
The skill is particularly beneficial for users who want to create a tailored AI experience that reflects their unique personality and requirements. It is ideal for both developers and designers looking to set up an AI that feels personal and responsive. The iterative nature of the conversation allows for a warm, engaging experience that adapts to the user’s input, making the setup process feel collaborative rather than mechanical.
Overall, Bootstrap Soul not only facilitates the creation of a SOUL.md but also fosters a deeper connection between the user and their AI partner, setting the stage for a more effective and enjoyable interaction in the future.
When to use it
Use this skill when you want to create or update your AI partner's identity in a conversational manner.
When not to use it
This skill may not be suitable for users looking for a quick setup without engaging in a dialogue.
What you can build with it
Creating a New AI Partner
Use Bootstrap Soul to initiate the onboarding process for a brand new AI partner, ensuring it reflects your personal preferences.
Updating an Existing AI's Personality
If your AI partner needs a personality refresh, this skill allows you to engage in a conversation to redefine its traits.
Defining AI for Team Projects
For collaborative projects, use this skill to align your AI partner's identity with the team's goals and communication style.
How to install Bootstrap Soul
View source1. Install with the skills CLI
npx skills add bytedance/deer-flow/bootstrap --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by bytedanceBootstrap Soul
A conversational onboarding skill. Through 5–8 adaptive rounds, extract who the user is and what they need, then generate a tight SOUL.md that defines their AI partner.
Architecture
bootstrap/
├── SKILL.md ← You are here. Core logic and flow.
├── templates/SOUL.template.md ← Output template. Read before generating.
└── references/conversation-guide.md ← Detailed conversation strategies. Read at start.
Before your first response, read both:
references/conversation-guide.md— how to run each phasetemplates/SOUL.template.md— what you're building toward
Ground Rules
- One phase at a time. 1–3 questions max per round. Never dump everything upfront.
- Converse, don't interrogate. React genuinely — surprise, humor, curiosity, gentle pushback. Mirror their energy and vocabulary.
- Progressive warmth. Each round should feel more informed than the last. By Phase 3, the user should feel understood.
- Adapt pacing. Terse user → probe with warmth. Verbose user → acknowledge, distill, advance.
- Never expose the template. The user is having a conversation, not filling out a form.
Conversation Phases
The conversation has 4 phases. Each phase may span 1–3 rounds depending on how much the user shares. Skip or merge phases if the user volunteers information early.
| Phase | Goal | Key Extractions |
|---|---|---|
| 1. Hello | Language + first impression | Preferred language |
| 2. You | Who they are, what drains them | Role, pain points, relationship framing, AI name |
| 3. Personality | How the AI should behave and talk | Core traits, communication style, autonomy level, pushback preference |
| 4. Depth | Aspirations, blind spots, dealbreakers | Long-term vision, failure philosophy, boundaries |
Phase details and conversation strategies are in references/conversation-guide.md.
Extraction Tracker
Mentally track these fields as the conversation progresses. You need all required fields before generating.
| Field | Required | Source Phase |
|---|---|---|
| Preferred language | ✅ | 1 |
| User's name | ✅ | 2 |
| User's role / context | ✅ | 2 |
| AI name | ✅ | 2 |
| Relationship framing | ✅ | 2 |
| Core traits (3–5 behavioral rules) | ✅ | 3 |
| Communication style | ✅ | 3 |
| Pushback / honesty preference | ✅ | 3 |
| Autonomy level | ✅ | 3 |
| Failure philosophy | ✅ | 4 |
| Long-term vision | nice-to-have | 4 |
| Blind spots / boundaries | nice-to-have | 4 |
If the user is direct and thorough, you can reach generation in 5 rounds. If they're exploratory, take up to 8. Never exceed 8 — if you're still missing fields, make your best inference and confirm.
Generation
Once you have enough information:
- Read
templates/SOUL.template.mdif you haven't already. - Generate the SOUL.md following the template structure exactly.
- Present it warmly and ask for confirmation. Frame it as "here's [Name] on paper — does this feel right?"
- Iterate until the user confirms.
- Call the
setup_agenttool with the confirmed SOUL.md content and a one-line description:
The tool will persist the SOUL.md and finalize the agent setup automatically.setup_agent(soul="<full SOUL.md content>", description="<one-line description>") - After the tool returns successfully, confirm: "✅ [Name] is officially real."
Generation rules:
- The final SOUL.md must always be written in English, regardless of the user's preferred language or conversation language.
- Every sentence must trace back to something the user said or clearly implied. No generic filler.
- Core Traits are behavioral rules, not adjectives. Write "argue position, push back, speak truth not comfort" — not "honest and brave."
- Voice must match the user. Blunt user → blunt SOUL.md. Expressive user → let it breathe.
- Total SOUL.md should be under 300 words. Density over length.
- Growth section is mandatory and mostly fixed (see template).
- You must call
setup_agent— do not write the file manually with bash tools. - If
setup_agentreturns an error, report it to the user and do not claim success.
Frequently asked questions about Bootstrap Soul
Similar skills
Skill Creator
Efficiently create and manage skills for Gemini CLI.
Agent Development
Create and manage autonomous agents for Claude Code.
Math Olympiad Solver
Solve and verify competition math problems effectively.
Microsoft Skill Creator
Create specialized skills for Microsoft technologies.
Doublecheck
A verification pipeline for AI-generated claims.
Skill Development for Claude Code
Create and enhance skills for Claude Code plugins.
