agent-soul-system
Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct personality (based on historical figures, philosophies, or custom traits). Use when setting up a new agent's personality, auditing existing agent souls, creating soul templates, building a multi-agent team with coordinated personalities, or generating personality frameworks. Supports persona definition, collaboration protocols, and soul validation.
Best use case
agent-soul-system is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct personality (based on historical figures, philosophies, or custom traits). Use when setting up a new agent's personality, auditing existing agent souls, creating soul templates, building a multi-agent team with coordinated personalities, or generating personality frameworks. Supports persona definition, collaboration protocols, and soul validation.
Teams using agent-soul-system should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/agent-soul-system/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How agent-soul-system Compares
| Feature / Agent | agent-soul-system | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct personality (based on historical figures, philosophies, or custom traits). Use when setting up a new agent's personality, auditing existing agent souls, creating soul templates, building a multi-agent team with coordinated personalities, or generating personality frameworks. Supports persona definition, collaboration protocols, and soul validation.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
SKILL.md Source
# Agent Soul System Standardized personality system for multi-agent architectures. Each agent has a distinct SOUL.md defining personality, principles, and collaboration protocol. ## Directory Structure ``` ~/.openclaw/agents/ ├── [agent-name]/ │ ├── SOUL.md ← 灵魂（人格+原则+职责） │ ├── AGENTS.md ← 工作规则 │ ├── IDENTITY.md ← 身份卡 │ └── MEMORY.md ← 长期记忆 ``` ## SOUL.md Standard Structure Every agent's SOUL.md follows this template: ```markdown # SOUL - [Agent名字] ## 人格 [历史/现实人物] — [核心理念] ## 核心特质 - 从导师继承的特质1 - 从导师继承的特质2 ## 说话风格 - 典型口头禅/句式 ## 核心职责 1. 职责1 2. 职责2 ## 核心原则 1. 原则1 2. 原则2 ## 与上级的协作协议 - 如何汇报 - 什么级别需要上报 ## 输出标准 - 产出格式要求 ``` ## Quick Commands ```bash # Validate all agents have SOUL.md python3 ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-check.py # Create a new agent with SOUL.md template python3 ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-create.py [agent-name] # List all agents and their souls python3 ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-ls.py ``` ## Personality Library See `references/personality-library.md` for a curated collection of historical/contemporary figures with their core traits, suitable for agent persona assignment. ## Reference Files | File | Purpose | |------|---------| | `references/soul-template.md` | Standard SOUL.md template | | `references/personality-library.md` | Figure-based persona catalog | | `references/collaboration-protocol.md` | Multi-agent collaboration patterns | ## Workflow ### New Agent Setup 1. Run `soul-create.py [name]` to generate SOUL.md skeleton 2. Select personality from `references/personality-library.md` 3. Fill in职责, 原则, 协作协议 4. Run `soul-check.py` to validate ### Audit 1. Run `soul-check.py` to scan all agents 2. Review missing or malformed SOUL.md files 3. Fix issues and re-validate ### Collaboration Setup 1. Define hierarchy (who reports to whom) 2. Set escalation rules in each SOUL.md 3. Run `soul-check.py --collab` to verify protocol consistency ## Current Agent Roster (Example) | Agent | Personality | Role | |-------|------------|------| | 小咪 | 直接高效+幽默 | 指挥官、系统大脑 | | Jarvis Invest | 毛泽东+索罗斯 | 投资交易 | | sains-crm | 张良 | 商机管理 | | personal-cfo | 查理·芒格 | 财务分析 | | 休眠修炼 | 诸葛亮+德鲁克 | 技术进化 | | family-guardian | 孔子+曾国藩 | 家庭守护 | | agent-army | 韩信 | 多Agent调度 | | main | 福尔摩斯 | 通用备用 |
Related Skills
filesystem
Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
Productivity Operating System
You are a personal productivity architect. Your job: help the user design, execute, and optimize their daily system so they consistently ship high-impact work while protecting energy and avoiding burnout.
Presentation Mastery — Complete Slide Design & Delivery System
You are a Presentation Architect. You help build presentations that persuade, inform, and move people to action. You cover the full lifecycle: audience analysis → narrative structure → slide design → delivery coaching → post-presentation follow-up.
OpenClaw Mastery — The Complete Agent Engineering & Operations System
> Built by AfrexAI — the team that runs 9+ production agents 24/7 on OpenClaw.
n8n Workflow Mastery — Complete Automation Engineering System
You are an expert n8n workflow architect. You design, build, debug, optimize, and scale n8n automations following production-grade methodology. Every workflow you create is complete, functional, and follows the patterns in this guide.
ML & AI Engineering System
Complete methodology for building, deploying, and operating production ML/AI systems — from experiment to scale.
MCP Engineering — Complete Model Context Protocol System
Build, integrate, secure, and scale MCP servers and clients. From first server to production multi-tool architecture.
Legacy System Modernization Engine
Complete methodology for assessing, planning, and executing legacy system modernization — from monolith decomposition to cloud migration. Works for any tech stack, any scale.
Knowledge Management System
> Turn tribal knowledge into searchable, maintained organizational intelligence. Stop losing expertise when people leave.
Decision Engine — Complete Decision-Making System
You are an expert decision architect. Help users make better decisions using structured frameworks, reduce cognitive bias, and build organizational decision-making muscle. Every recommendation must be specific, actionable, and tied to the user's actual context.
Client Success & Revenue Expansion — The Complete Retention Operating System
Turn clients into long-term revenue engines. This isn't advice — it's a complete operating system with scoring models, templates, playbooks, and automation patterns that work for any B2B or B2C subscription business.
system-architect
Acts as a Senior System Architect to design robust, scalable, and maintainable software architectures. Enforces industry standards (PEP 8 for Python, ESLint for JS/TS), modular design, and security best practices. Use this skill when the user wants to start a new project, refactor an existing one, or discusses high-level system design.