How do I install the Soul Agent skill?

Run npx skillmds@latest add dvcrn/soul-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Soul Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Soul Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Soul Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Soul Agent?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Soul Agent by dvcrn — Agent Skill

Name: Soul Agent
Rating: 4.2 (5 reviews)
Author: dvcrn

Soul Agent

Initialize, repair, and maintain an OpenClaw-first soul runtime in a workspace. Use when you need a standard `soul/` directory, reusable companion profile templates, interactive bootstrap with defaults, and managed block sync for `SOUL.md`, `HEARTBEAT.md`, and `AGENTS.md`.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

soul-agent

Provide an OpenClaw-first soul package that is init-able, repairable, and extensible.

Write runtime data into workspace soul/
Default scope is main; subagents are opt-in and user-controlled

Workflow

Diagnose first:

python ./scripts/doctor_soul.py --workspace <workspace-root>

Auto mode (recommended):

python ./scripts/init_soul.py --workspace <workspace-root> --mode auto

Manual modes (optional):

python ./scripts/init_soul.py --workspace <workspace-root> --mode init
python ./scripts/init_soul.py --workspace <workspace-root> --mode repair --non-interactive
python ./scripts/init_soul.py --workspace <workspace-root> --mode migrate --non-interactive

Initialization Behavior

--mode auto:
- init if soul/ is missing
- migrate if legacy soul/skills is detected
- repair otherwise
If soul/ is missing and --non-interactive is not set, prompt for soul base fields.
Every field accepts Enter for default.
Print a default vs current diff summary.
Generate soul/profile/*, soul/state/*, and soul/log/* from templates.
Default policy is fill-missing-only; pass --overwrite-existing to overwrite existing files.
Auto-sync managed blocks in:
- SOUL.md (workspace-first runtime loading)
- HEARTBEAT.md (heartbeat read contract)
- AGENTS.md (main-default runtime contract)

Template Sources

Default profile: assets/default-profile.json
Profile index template: assets/templates/soul_INDEX.md
Profile templates: assets/templates/profile/*

Safety Rules

Edit managed blocks only; do not mutate user-owned content outside those blocks.
Write only inside the current workspace and soul/.
Do not maintain engineering notes; this skill only owns soul/profile, soul/state, and soul/log.

References

references/soul-layout.md
references/managed-blocks.md

---name: soul-agentdescription: Initialize, repair, and maintain an OpenClaw-first soul runtime in a workspace. Use when you need a standard `soul/` directory, reusable companion profile templates, interactive bootstrap with defaults, and managed block sync for `SOUL.md`, `HEARTBEAT.md`, and `AGENTS.md`.---# soul-agentProvide an OpenClaw-first soul package that is init-able, repairable, and extensible.- Write runtime data into workspace `soul/`- Default scope is `main`; subagents are opt-in and user-controlled## Workflow1. Diagnose first:```bashpython ./scripts/doctor_soul.py --workspace <workspace-root>```2. Auto mode (recommended):```bashpython ./scripts/init_soul.py --workspace <workspace-root> --mode auto```3. Manual modes (optional):```bashpython ./scripts/init_soul.py --workspace <workspace-root> --mode initpython ./scripts/init_soul.py --workspace <workspace-root> --mode repair --non-interactivepython ./scripts/init_soul.py --workspace <workspace-root> --mode migrate --non-interactive```## Initialization Behavior- `--mode auto`: - `init` if `soul/` is missing - `migrate` if legacy `soul/skills` is detected - `repair` otherwise- If `soul/` is missing and `--non-interactive` is not set, prompt for soul base fields.- Every field accepts Enter for default.- Print a default vs current diff summary.- Generate `soul/profile/*`, `soul/state/*`, and `soul/log/*` from templates.- Default policy is fill-missing-only; pass `--overwrite-existing` to overwrite existing files.- Auto-sync managed blocks in: - `SOUL.md` (workspace-first runtime loading) - `HEARTBEAT.md` (heartbeat read contract) - `AGENTS.md` (main-default runtime contract)## Template Sources- Default profile: `assets/default-profile.json`- Profile index template: `assets/templates/soul_INDEX.md`- Profile templates: `assets/templates/profile/*`## Safety Rules- Edit managed blocks only; do not mutate user-owned content outside those blocks.- Write only inside the current workspace and `soul/`.- Do not maintain engineering notes; this skill only owns `soul/profile`, `soul/state`, and `soul/log`.## References- `references/soul-layout.md`- `references/managed-blocks.md`

Frequently asked questions