Soul
Persona files that make an agent write in a specific person's voice
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 28, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Jul 30, 2026 · 5d30cb1
⚠ This skill is no longer available upstream. Our re-check on Aug 10, 2026 couldn't find it any more (repo unreachable/deleted). The test below is what we measured on Jul 28, 2026 and we're leaving it up as a record — but there is nothing left to install, so we've removed the command.
Installs cleanly but arrives empty: SKILL.md opens with 'Read SOUL.md first', and a fresh clone has no SOUL.md, no STYLE.md and no examples/good-outputs.md - only .template.md stubs, so out of the box the skill changes nothing. Loading one of the bundled personas instead does work and is measurable: asked for a three-tweet thread on overengineered agent frameworks, the no-skill version hit three items from that persona's own never-say list ('at the end of the day', 'it depends', and a rocket emoji the style file says he would never use), while the run that followed SKILL.md's reading order hit zero and picked up four documented voice markers plus two concrete grounding numbers. The bundled STYLE.md files are unusually good - vocabulary in/out lists, wrong-voice examples with reasons, and a six-question grader checklist - and each example SOUL.md carries a fan-made, do-not-use-for-deceptive-impersonation header. Scored setup because you must author the identity files yourself first, the README's advertised /soul-builder command is not installed by any documented step, and the repo gives no Claude Code install instructions at all.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 3/5
- Triggers reliably 4/5
- Output vs. baseline 7/10
- Docs & honesty 3/5
What Soul does
A four-file format - SOUL.md for identity and opinions, STYLE.md for voice rules, MEMORY.md for a session log, examples/ for calibration - that an agent reads in order so it writes as a specific person rather than about them. Ships templates plus eight worked persona examples, each with a never-say list and a grader checklist. Triggers when you want output in a documented individual voice: tweets, replies, essays or idea generation in character.
How to install Soul
Nothing to install: the source repository no longer has this skill. If the author brings it back, our daily re-check will pick it up and the command will reappear here.
Commands — how to trigger Soul
-
/soulPersona files that make an agent write in a specific person's voice
It also activates on plain-language prompts like these:
-
Write this reply in Andrej Karpathy's voice using his SOUL and STYLE files -
Draft a three-tweet thread about AI agents in this documented persona's voice -
Generate a blog post outline that sounds exactly like this persona writes
Frequently asked questions
- Is the Soul skill free?
- Yes. The skill itself is free from aeonfun/soul.md. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Soul work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 28, 2026. Verdict: Works with setup. Installs cleanly but arrives empty: SKILL.md opens with 'Read SOUL.md first', and a fresh clone has no SOUL.md, no STYLE.md and no examples/good-outputs.md - only .template.md stubs, so out of the box the skill changes nothing. Loading one of the bundled personas instead does work and is measurable: asked for a three-tweet thread on overengineered agent frameworks, the no-skill version hit three items from that persona's own never-say list ('at the end of the day', 'it depends', and a rocket emoji the style file says he would never use), while the run that followed SKILL.md's reading order hit zero and picked up four documented voice markers plus two concrete grounding numbers. The bundled STYLE.md files are unusually good - vocabulary in/out lists, wrong-voice examples with reasons, and a six-question grader checklist - and each example SOUL.md carries a fan-made, do-not-use-for-deceptive-impersonation header. Scored setup because you must author the identity files yourself first, the README's advertised /soul-builder command is not installed by any documented step, and the repo gives no Claude Code install instructions at all.
- What is the Soul SkillProof Score?
- 6.8/10 — installs cleanly 3/5, triggers reliably 4/5, output vs. baseline 7/10, docs & honesty 3/5.
- How do I install Soul?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Soul with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.