ClawHub

Agent Soul System

v1.0.0

Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct per...

⭐ 0· 12·0 current·0 all-time
byAdam@adamwgp
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description align with the included scripts and reference files. The three Python scripts implement creation, listing, and validation of SOUL.md files and the references match the stated persona/collaboration features.
ℹ
Instruction Scope
The SKILL.md and scripts operate on the user's filesystem (AGENTS_DIR = ~/.openclaw/agents) and on files bundled in the skill workspace (references/*). Metadata declared no required config paths, but the runtime instructions clearly read and write under ~/.openclaw/agents — this is expected for the skill's purpose but is worth noting because it accesses user files.
✓
Install Mechanism
No install spec or external downloads. All code is bundled with the skill (three small Python scripts and markdown refs). No network fetches or archive extraction observed.
✓
Credentials
The skill requires no environment variables, no credentials, and the scripts do not read environment secrets. That matches the local, filesystem-only functionality.
ℹ
Persistence & Privilege
The skill is not always-enabled and does not request elevated privileges, but it will create directories and write SOUL.md files under ~/.openclaw/agents. soul-create.py will prompt before overwriting existing SOUL.md, but the skill does persist data to the user's home directory.
Assessment
What to consider before installing: (1) This skill is local-only and reads/writes files under ~/.openclaw/agents and uses bundled reference files; it does not use the network or request credentials. (2) If you already have agents under ~/.openclaw/agents, back up that directory first — soul-create.py can create or overwrite SOUL.md (it prompts before overwriting). (3) Review the three included Python scripts (soul-create.py, soul-ls.py, soul-check.py) yourself if you want to confirm behavior; they're short and only perform filesystem operations and stdout printing. (4) Be aware the personality library includes historical and political figures — that is content, not functionality; decide whether those examples are acceptable for your environment. (5) If you prefer additional safety, run the scripts in a sandbox or a test account before using them on production agent data.

Like a lobster shell, security has layers — review code before you run it.

latestvk97epdazwq54acrbmq2exyardd848g7a

License

MIT-0
Free to use, modify, and redistribute. No attribution required.
Termshttps://spdx.org/licenses/MIT-0.html

Comments