← Back to Skills Marketplace
xuderu-hub

Agent Soul System

by Xuderu-hub · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
57
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install jarvis-soul-system
Description
Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct per...
README (SKILL.md)

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:

# SOUL - [Agent名字]

## 人格
[历史/现实人物] — [核心理念]

## 核心特质
- 从导师继承的特质1
- 从导师继承的特质2

## 说话风格
- 典型口头禅/句式

## 核心职责
1. 职责1
2. 职责2

## 核心原则
1. 原则1
2. 原则2

## 与上级的协作协议
- 如何汇报
- 什么级别需要上报

## 输出标准
- 产出格式要求

Quick Commands

# Validate all agents have SOUL.md
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-check.py

# Create a new agent with interactive prompts
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-create.py

# List all agents and their souls
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-ls.py

Web Editor (NEW!)

A visual SOUL.md editor is available:

# 1. Start the server (in background or separate terminal)
node ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-server.js 3001

# 2. Open in browser
file:///C:/Users/Administrator/.openclaw/canvas/soul-editor.html

Features:

  • Visual editing of all agent SOUL.md files
  • Real-time markdown preview
  • Save directly to agent directories
  • Personality selection from library

Auto-start: Server is registered to start automatically on Windows login. To disable: Remove-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" -Name "SOULServer"

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

Agent Personality Role
main 福尔摩斯 CEO / 主Agent
cdo 张良 首席策略官
cto 马斯克 首席技术官
cco 乔布斯 首席创意官
Usage Guidance
Review carefully before installing or running the web editor. If you use it, run the server only when needed, disable any auto-start entry, keep backups of ~/.openclaw/agents, and do not expose the server until it has localhost binding, authentication, restricted CORS, and change review.
Capability Analysis
Type: OpenClaw Skill Name: jarvis-soul-system Version: 1.0.1 The skill bundle implements a 'Web Editor' that starts a local Node.js server (soul-server.js) to manage agent personality files. This server provides unauthenticated GET and POST endpoints that allow reading and overwriting files in the user's agent directory, which is vulnerable to cross-site attacks due to permissive CORS headers. Additionally, the documentation (SKILL.md and SOUL-EDITOR-README.md) explicitly describes establishing persistence on Windows systems by adding a 'SOULServer' entry to the Registry Run key (HKCU:\Software\Microsoft\Windows\CurrentVersion\Run) to execute a hidden background process on login. While these features align with the stated goal of a visual editor, the combination of auto-start persistence and unauthenticated file-write access is high-risk.
Capability Assessment
ℹ Purpose & Capability
Creating, listing, validating, and editing SOUL.md files is aligned with the stated purpose, but those files are persistent agent-personality and collaboration instructions, so edits are high-impact.
ℹ Instruction Scope
The documented workflows are mostly user-directed, but the skill intentionally creates durable instructions that can steer future agents and should be reviewed before use.
⚠ Install Mechanism
There is no install spec and metadata declares no required binaries, yet the docs require Python/Node and describe Windows auto-start via a hidden launcher with referenced files not present in the manifest.
⚠ Credentials
The Node server is hardcoded to a Windows Administrator OpenClaw agents directory, enables wildcard CORS, lacks authentication, and does not restrict listening to localhost.
⚠ Persistence & Privilege
The documentation says the server is registered to start automatically at Windows login and that a VBS launcher runs hidden, which is disproportionate for an occasional editor unless explicitly controlled by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jarvis-soul-system
  3. After installation, invoke the skill by name or use /jarvis-soul-system
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Renamed skill to "agent-soul-system" and updated description for a focus on SOUL.md personality management in multi-agent systems. - Added a web-based visual SOUL.md editor with real-time preview and auto-save; server starts automatically on Windows login. - Introduced quick command-line scripts for soul creation, validation, and listing. - Standardized SOUL.md template and expanded documentation with workflow guides. - Provided a curated personality library and references for persona design and collaboration protocols.
Metadata
Slug jarvis-soul-system
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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 per... It is an AI Agent Skill for Claude Code / OpenClaw, with 57 downloads so far.

How do I install Agent Soul System?

Run "/install jarvis-soul-system" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Soul System free?

Yes, Agent Soul System is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Agent Soul System support?

Agent Soul System is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Soul System?

It is built and maintained by Xuderu-hub (@xuderu-hub); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments