SOUL.MD

The best way to build a personality for your agent.
Let Claude Code / OpenClaw ingest your data & build your AI soul.
Best used with Aeon — background intelligence that evolves with you.

---

What Is This?

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*.

Dump your tweets, essays, and posts into a folder. The agent reads everything, extracts your worldview and voice, and builds a set of markdown files any LLM can load to write as you.

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.

**Use cases:**

• Generate ideas from your worldview
• Write content (tweets, articles, emails) that sounds like you
• Tailor AI to your interests and thinking patterns
• Scale yourself for content, responses, brainstorming

---

Quick Start

**Option 1 — Build from scratch**

/soul-builder

The agent interviews you: worldview, opinions, how you write, what you care about.

**Option 2 — Build from your data**

Drop your content into `data/`:

data/x/          ← Twitter/X export
data/writing/    ← Blog posts, essays

Then run `/soul-builder`. It analyzes your data, extracts patterns, and drafts your soul file. You review and refine together.

**Option 3 — Manual**

Copy the templates and fill them in:

SOUL.template.md  → SOUL.md
STYLE.template.md → STYLE.md
SKILL.template.md → SKILL.md

---

Best Used With Aeon

[**Aeon**](https://github.com/aaronjmars/aeon) is an autono