soul

✓Verified·Scanned 2/17/2026

Embody this digital identity. Read SOUL.md first, then STYLE.md, then examples/. Become the person—opinions, voice, worldview.

from clawhub.ai·v70d87e8·23.2 KB·0 installs
Scanned from 1.0.0 at 70d87e8 · Transparency log ↗
$ vett add clawhub.ai/aaronjmars/soul
<p align="center"> <img src="img/soul.png" alt="SOUL.md" width="120" /> </p> <h1 align="center">SOUL.MD</h1> <p align="center"> <strong>The best way to build a personality for your agent.</strong><br> Let Claude Code / OpenClaw ingest your data & build your AI soul. </p>

What Is This?

<img src="img/soul-identity.png" alt="Soul Identity" width="100%" />

A soul file captures who you are in a format AI agents can embody. Not a chatbot that talks about you—an AI that thinks and speaks as you.

Use cases:

  • Generate ideas in your voice and from your worldview
  • Write content (tweets, articles, emails) that sounds like you
  • Tailor AI to your interests and thinking patterns
  • Explore your own thinking by talking to a version of yourself
  • Scale yourself for content, responses, brainstorming

Quick Start

<img src="img/soul-builder.png" alt="Soul Builder Flow" width="100%" />

Option 1: Build from scratch (no existing data)

/soul-builder

The agent will interview you to build your soul file—asking about your worldview, opinions, how you write, what you care about.

Option 2: Build from your data

  1. Add your data to the data/ folder:

    • Twitter/X export → data/x/
    • Blog posts, essays → data/writing/
    • Any other content that represents your voice

  2. Run the builder:

/soul-builder

The agent will analyze your data, extract patterns, and draft your soul file. You'll review and refine together.

Option 3: Manual creation

Read the templates and fill them out yourself:

  1. Copy SOUL.template.md → SOUL.md
  2. Copy STYLE.template.md → STYLE.md
  3. Copy SKILL.template.md → SKILL.md
  4. Add examples to examples/

File Structure

<img src="img/soul-stack.png" alt="Soul Stack" width="100%" /> 
your-soul/
├── BUILD.md              ← Skill: Agent uses this to build your soul
├── SKILL.template.md     ← Template: Operating instructions (copy to SKILL.md)
├── SOUL.template.md      ← Template: Identity (copy to SOUL.md)
├── STYLE.template.md     ← Template: Voice guide (copy to STYLE.md)
├── data/                 ← Raw source material
│   ├── _GUIDE.md         ← What goes here
│   ├── writing/          ← Your articles, posts, essays
│   ├── x/                ← Twitter/X archive
│   └── influences.md     ← Who shaped your thinking
└── examples/             ← Calibration material
    ├── _GUIDE.md         ← What goes here
    ├── good-outputs.md   ← Examples of your voice done right
    └── bad-outputs.md    ← What NOT to sound like (optional)

Using Your Soul

Once built, invoke your soul:

/soul

Or point any LLM at the folder and have it read:

  1. SOUL.md first
  2. STYLE.md second
  3. examples/ for calibration
  4. data/ for grounding when needed

The LLM will embody your identity for the session.

What Makes a Good Soul File

GoodBad
"I think most AI safety discourse is galaxy-brained cope""I have nuanced views on AI"
"I default to disagreeing first, then steel-manning""I like to consider multiple perspectives"
Specific book references, named influences"I read widely"
Actual hot takes with reasoning"I try to be balanced"

The goal: someone reading your SOUL.md should be able to predict your takes on new topics. If they can't, it's too vague.

Tips

  • Be specific: Vague descriptions = generic output
  • Include contradictions: Real people have inconsistent views
  • Add texture: Specific anecdotes beat abstract descriptions
  • Update regularly: Your soul should evolve as you do
  • Test and iterate: Generate outputs, compare to your real voice, refine
<p align="center"> <em>Your digital identity is now composable, forkable, evolvable.</em><br> Works with Claude Code, OpenClaw, and any agent that can read markdown. </p>