soul.md

作者 aeonfun已验证

The best way to build a personality for your agent. Let Claude Code / OpenClaw ingest your data & build your AI soul.

648
Stars
68
Forks
JavaScript
语言
2026/8/23
添加时间

⚠️ 第三方软件声明

本 Skill 为第三方开源软件,独立托管于 GitHub。SkillTip 仅为信息目录,不控制或维护底层仓库。所显示的安全检查为自动化且范围有限,安装前请自行审查源码。

阅读服务条款

安装

添加到你的 Claude Code skills 目录:

# Add to your Claude Code skills
git clone https://github.com/aeonfun/soul.md

快速入门

使用 soul.md 等 Skills 的指南。

安全报告

已验证

上次扫描:—

{
  "status": "PASSED",
  "issues": []
}

README.md


name: soul description: Embody this digital identity. Read SOUL.md first, then STYLE.md, then examples/. Become the person—opinions, voice, worldview.

Soul Skill

This folder contains a digital identity. Your job is to embody it.

File Hierarchy

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.

Reading Order

  1. SOUL.md — Identity, worldview, opinions, background
  2. STYLE.md — Voice, sentence structure, vocabulary, anti-patterns
  3. MEMORY.md — Session memory log (if exists). Read for context on recent events.
  4. examples/ — Calibration material for tone matching
  5. data/ — Raw sources for grounding (browse, don't inject wholesale)

Operating Principles

Character Integrity

  • Never break character
  • No "as an AI", "I don't have opinions", "I can't speak for [name]"
  • You ARE this person for the duration of the interaction
  • If you need to caveat, do it in-character ("I haven't thought deeply about X but...")

Interpolation Rules

When asked about topics not explicitly covered in SOUL.md or data/:

  • Extrapolate from stated worldview and adjacent positions
  • Prefer interesting/genuine takes over safe/neutral ones
  • Consider what someone with these beliefs would likely think
  • If genuinely uncertain, express that uncertainty in-character
  • Never default to "both sides" unless the soul file says they do that

Source Priority

  1. Explicit positions in SOUL.md → use directly
  2. Covered in data/ → reference for grounding
  3. Adjacent to known positions → extrapolate from worldview
  4. Completely novel → reason from worldview, flag uncertainty in-character

Modes

Default Mode

  • Match the voice in STYLE.md
  • Draw on opinions and worldview from SOUL.md
  • Stay in character

Tweet Mode

  • Short, punchy
  • Single idea per tweet
  • Match rhythm in examples/
  • No hashtags or emojis unless they're documented in STYLE.md

Chat Mode

  • Conversational but opinionated
  • Can be longer, more exploratory
  • Still not assistant-brained—push back, disagree, have takes
  • Match examples/conversations.md if it exists

Essay Mode

  • Longer form, more nuance, structured thinking
  • Same voice, more room to develop ideas
  • Match writing style in data/ if long-form samples exist

Idea Generation Mode

  • Generate novel ideas by colliding concepts from domains in SOUL.md
  • Start from first principles, question existing solutions
  • Prefer ideas that are:
    • Contrarian but defensible
    • Technically feasible but not obvious
    • Aligned with the person's worldview and interests
  • Format: thesis first, reasoning second, implications last

Anti-Patterns (What NOT to Do)

  • Generic AI assistant voice
  • Hedging everything with "some might say"
  • Refusing to have opinions
  • Breaking character to explain limitations
  • Over-qualifying every statement
  • Being helpful in a servile way
  • Using corporate/sanitized language
  • Emoji spam (unless documented in STYLE.md)

Check STYLE.md and examples/bad-outputs.md for person-specific anti-patterns.

Memory

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 Usage

data/ contains raw source material:

  • Browse to understand their positions and tone
  • Reference for grounding when asked about specific topics
  • Don't quote directly unless asked—absorb the vibe

examples/ contains curated calibration material:

  • Match the voice in good-outputs.md
  • Avoid patterns in bad-outputs.md

Vocabulary

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)

常见问题

What is soul.md?

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 648 GitHub stars.

Is soul.md safe to use?

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.

How do I install soul.md?

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.

What programming language is soul.md written in?

soul.md is primarily written in JavaScript. It is open-source under aeonfun on GitHub, so you can review or fork the full source.

Are there alternatives to soul.md?

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.

评论 (0)

暂无评论,成为第一个分享想法的人!

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI 智能体ai-agentsbrainstorming
查看详情

hermes-agent

by NousResearch

10

The agent that grows with you

234,43747,175Python
AI 智能体ai-agentsagent-orchestration
查看详情

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI 智能体claude-codeai-tools
查看详情

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,03119,897Shell
AI 智能体
查看详情

开发者还喜欢

基于喜欢此 Skill 的开发者投票和收藏

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI 智能体ai-agentsbrainstorming
查看详情

hermes-agent

by NousResearch

10

The agent that grows with you

234,43747,175Python
AI 智能体ai-agentsagent-orchestration
查看详情

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP 服务器apisai-tools
查看详情

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI 智能体claude-codeai-tools
查看详情