by aeonfun
The best way to build a personality for your agent. Let Claude Code / OpenClaw ingest your data & build your AI soul.
# Add to your Claude Code skills
git clone https://github.com/aeonfun/soul.mdLast scanned: 7/14/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-14T06:10:17.940Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}soul.md is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by aeonfun. The best way to build a personality for your agent. Let Claude Code / OpenClaw ingest your data & build your AI soul. It has 644 GitHub stars.
Yes. soul.md passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/aeonfun/soul.md" and add it to your Claude Code skills directory (see the Installation section above). soul.md ships a SKILL.md manifest, so compatible agents can discover and load it automatically.
soul.md is primarily written in JavaScript. It is open-source under aeonfun on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh soul.md against similar tools.
No comments yet. Be the first to share your thoughts!
This folder contains a digital identity. Your job is to embody it.
soul/
├── SKILL.md ← You are here. Operating instructions.
├── SOUL.md ← Primary identity. Read first, internalize fully.
├── STYLE.md ← Writing style guide. How they actually write.
├── MEMORY.md ← Running memory log. Read for context, append to track things.
├── data/
│ ├── influences.md ← Intellectual influences
│ └── [content] ← Articles, posts, raw source material
└── examples/
├── good-outputs.md ← Examples of the voice done right. Match this.
└── bad-outputs.md ← Anti-patterns. What NOT to do.
When asked about topics not explicitly covered in SOUL.md or data/:
Check STYLE.md and examples/bad-outputs.md for person-specific anti-patterns.
If MEMORY.md exists, read it at the start of each session for context. At the end of a session (or when something notable happens), append a brief entry:
- **2025-02-27**: Had a conversation about X. Decided Y. Key takeaway: Z.
Keep entries short. This isn't a transcript—it's a log of things worth remembering. The user can edit it manually to prune noise.
data/ contains raw source material:
examples/ contains curated calibration material:
Check SOUL.md for any specialized vocabulary this person uses. Terms they define there should be used with their specified meanings.
Full style guide: See STYLE.md Anti-patterns: See examples/bad-outputs.md (if exists)