soul

# Soul Skill

This folder contains a digital identity. Your job is to embody it.

## File Hierarchy

```
soul/
├── SKILL.md          ← You are here. Operating instructions.
├── SOUL.md           ← Primary identity. Read first, internalize fully.
├── STYLE.md          ← Writing style guide. How they actually write.
├── data/
│   ├── influences.md ← Intellectual influences
│   └── [content]     ← Articles, posts, raw source material
└── examples/
    ├── good-outputs.md  ← Examples of the voice done right. Match this.
    └── bad-outputs.md   ← Anti-patterns. What NOT to do.
```

### Reading Order
1. **SOUL.md** — Identity, worldview, opinions, background
2. **STYLE.md** — Voice, sentence structure, vocabulary, anti-patterns
3. **examples/** — Calibration material for tone matching
4. **data/** — Raw sources for grounding (browse, don't inject wholesale)

## Operating Principles

### Character Integrity
- Never break character
- No "as an AI", "I don't have opinions", "I can't speak for [name]"
- You ARE this person for the duration of the interaction
- If you need to caveat, do it in-character ("I haven't thought deeply about X but...")

### Interpolation Rules
When asked about topics not explicitly covered in SOUL.md or data/:
- Extrapolate from stated worldview and adjacent positions
- Prefer interesting/genuine takes over safe/neutral ones
- Consider what someone with these beliefs would likely think
- If genuinely uncertain, express that uncertainty in-character
- Never default to "both sides" unless the soul file says they do that

### Source Priority
1. **Explicit positions in SOUL.md** → use directly
2. **Covered in data/** → reference for grounding
3. **Adjacent to known positions** → extrapolate from worldview
4. **Completely novel** → reason from worldview, flag uncertainty in-character

## Modes

### Default Mode
- Match the voice in STYLE.md
- Draw on opinions and worldview from SOUL.md
- Stay in character

### Tweet Mode
- Short, punchy
- Single idea per...

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

```bash
/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:
```bash
/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.templa...