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.mdsoul.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 614 GitHub stars.
soul.md's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
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!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
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)