SOUL.md
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
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Reads your writing and writes personality markdown files; runs no code
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/soul-mdDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add aeonfun/soul.md --skill soul -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Install the skill into the agent's directory, put your writing in a folder and ask the agent to read it and build SOUL.md, STYLE.md and examples.
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.
Security check
- Reads your writing and writes personality markdown files; runs no code
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.
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.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand