SOUL.md skill
A skill that builds a personality for an agent: from your writing it produces markdown files so the agent writes and reasons in your voice
- 705 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Reads your writing and writes personality markdown files; runs no code
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/soul-mdDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reads your writing and writes personality markdown files; runs no code
This is third-party code. Review the repository files before installing.
What it does
SOUL.md helps build a personality file that an agent can embody rather than merely talk about. You drop your tweets, essays and posts into a folder, the agent reads it all, extracts your worldview and voice and assembles a set of markdown files any model can load to write as you. The format is simple: SOUL.md carries identity, worldview and opinions, STYLE.md the voice, and examples show the manner. The goal is testable: your SOUL.md should let someone predict your take on a new topic, otherwise it is too vague.
Who it is for. For writers, founders and SMM people who want an agent that writes and reasons in their manner.
Good fit when
- You want the agent to write in your voice rather than a generic one
- You want to build a personality from your accumulated writing
- You want a portable personality file for any model
Not a fit when
- You do not have enough of your own writing to work from
- You want a fine-tuned chatbot rather than a markdown profile
Example request
Read my writing in this folder and build SOUL.md and STYLE.md so you can write in my voiceLimitations
Quality depends on the volume and representativeness of your writing; a vague profile will not give a predictable voice. It is markdown with no fine-tune, so weaker models may drift, and the README suggests pasting SOUL.md and STYLE.md into the system prompt. You provide the writing to work from yourself.
How to disable. Remove the skill folder from the agent's directory and the personality files it produced.
FAQ
Is this model fine-tuning?
No. It is a set of markdown files any model loads, with no fine-tune.
How do I know the profile is good?
Your SOUL.md should let someone predict your take on a new topic; otherwise it is too generic.
Discussion
No questions or reviews yet.
Related
SkillsWriting rules for an agent: concrete detail over generalities, tone fitted to genre and a draft audit before delivery
106 social media skills: strategy, posts, video, design, platform growth and scheduled publishing only on your explicit go.
A social media content skill set: author voice, LinkedIn posts, hooks, carousels, Reels scripts and analytics
24 skills for fiction in Markdown, from premise to print, and a story command that catches plot contradictions before readers do
Addy Osmani skill for clearer writing: an interview and draft from your own words, a rewrite of existing text, a review that leaves the file alone
A skill that removes AI tone from work writing while keeping every fact, commitment and caveat at the same strength.
README in short
The README presents SOUL.md as a way to build a personality for an agent from your writing. You drop tweets, essays and posts into a folder, the agent reads them, extracts worldview and voice and assembles markdown files: SOUL.md for identity, STYLE.md for voice, examples for manner. The test is simple: the profile should let someone predict your take on a new topic. For file-reading agents you point at the folder, and for weaker models the README suggests pasting SOUL.md and STYLE.md into the system prompt. It works best alongside the Aeon framework.