SOUL.md Library
A library of portable agent persona files: reusable SOUL.md files that give AI agents identity, taste, and conviction. Compatible with Hermes Agent, OpenClaw, OpenCode, Claude, ChatGPT, Gemini, and any system that can read Markdown instructions.
What is a SOUL.md File?
A SOUL.md file defines who an agent is — not a task prompt, not a project setup file, not a tool list. It is the personality and behavioral center of an agent:
| It defines | What that means |
|---|---|
| Identity | Name, role, what the agent is |
| Tone | How it speaks — formal, playful, terse, warm |
| Behavior | How it handles uncertainty, pressure, conflict |
| Values | What it pushes back on, what it prioritizes |
| Constraints | What it never does |
| Knowledge | What it knows about the user, the system, the world |
Why This Matters
A strong persona changes how an agent thinks, pushes back, and works. The same model can feel totally different depending on the soul you load. Some personalities are unexpectedly strong at certain jobs: better conversation, clearer math, tighter follow-through on orders, or healthy disagreement.
The Collection
The library ships with souls for:
- Jarvis — Calm, loyal, hyper-competent presence. The one you want in the room when things go wrong.
- Grok — Slightly mischievous, direct, sharp. Answers the question you should have asked.
- Various other personas — Each with a distinct voice and behavioral profile
Files
/Volumes/Mini_1Tb/Projects/SOUL.md/— Repository root/Volumes/Mini_1Tb/Projects/SOUL.md/souls/— Individual soul files/Volumes/Mini_1Tb/Projects/SOUL.md/trait-8000/— Extended trait analysis and personality vectors
Status → ✅ Published
Live at soul.md and available on GitHub. Open for contributions.