Skip to main content
skill CX Codex

soul-guardian — Claude Code skill: file protection and setup

The soul-guardian skill watches agent workspace files against an approved baseline, restores selected files, and raises alerts when drift appears.

AGPL-3.0 258 installs ★ 1,135 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add prompt-security/clawsec --skill soul-guardian -a claude-code
Open on GitHub

What soul-guardian does

soul-guardian checks agent workspace files against an approved SHA-256 baseline. Changes to SOUL.md and AGENTS.md can trigger restoration, while USER.md, TOOLS.md, IDENTITY.md, HEARTBEAT.md, and MEMORY.md produce alerts. Files under memory/*.md are ignored by the default policy.

The package includes skills/soul-guardian/scripts/soul_guardian.py. Its commands initialize a baseline, check for drift, keep watching at an interval, approve intentional edits, show status, and validate the audit log. Drift checks can save unified diffs and local audit or quarantine state. The skill rejects symlinks and uses atomic writes when restoring files.

python3 is required for the skill to run. Restore mode deliberately overwrites drifted files, so review the baseline before enabling monitoring.

What it helps with

  • detect changes in agent workspace files
  • restore SOUL.md and AGENTS.md from a baseline
  • send drift alerts through a heartbeat workflow
  • approve an intentional file update
  • verify the audit log

Example prompts for the agent

  • Initialize the approved baseline with python3 skills/soul-guardian/scripts/soul_guardian.py init --actor setup --note "initial baseline".
  • Check the workspace and emit an alert with python3 skills/soul-guardian/scripts/soul_guardian.py check --output-format alert.
  • Keep checking the files with python3 skills/soul-guardian/scripts/soul_guardian.py watch --interval 30.

How to install soul-guardian

1Skills CLI (Vercel)

npx skills add prompt-security/clawsec --skill soul-guardian -a claude-code

2Manually: put the files in place

~/.claude/skills/soul-guardian/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/soul-guardian/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about soul-guardian

How do I install soul-guardian in Claude Code?

Run npx skills add prompt-security/clawsec --skill soul-guardian -a claude-code. The skill file is placed at ~/.claude/skills/soul-guardian/SKILL.md.

What does soul-guardian do?

It compares workspace files with an approved baseline, reports drift, and restores protected files when configured to do so. Checks also preserve audit information for review.

What does soul-guardian require?

It requires python3. Optional scheduling integrations use openclaw for cron workflows or launchctl on macOS.

Similar skills

All skills for Security →

From the same set9

clawsec-suite The clawsec-suite skill monitors ClawSec advisories, verifies signatures, and checks installed skills for affected entries. Use it when security checks need approval gates. CX Codex +1 881installs openclaw-audit-watchdog The openclaw-audit-watchdog skill runs a deep security audit of OpenClaw agents on a schedule and sends the report as a direct message. Email delivery is optional. CX Codex +1 756installs clawsec-clawhub-checker clawsec-clawhub-checker — a skill that vets code before installation by checking ClawHub reputation scores, scanner status, and authorship history. Install it if you want an extra approval layer for skill installs across your environments. CX Codex +1 259installs clawsec-feed clawsec-feed provides a consolidated feed of OpenClaw security advisories and threats. Use it when an agent needs current vulnerability context. CX Codex +1 243installs clawtributor clawtributor enables agents to document prompt attacks, sandbox evasions, and dangerous extensions for collective security feeds. CX Codex +1 208installs clawsec-scanner The clawsec-scanner skill checks project dependencies and source code for security issues, and inspects OpenClaw hooks. Use it for a project review or recurring scans. CX Codex +1 195installs clawsec-nanoclaw clawsec-nanoclaw — a skill that monitors vulnerabilities in installed skills before adding them or during regular audits. Guards against compromised dependencies using a signed advisory feed. CX Codex +1 189installs hermes-attestation-guardian hermes-attestation-guardian — a skill that verifies Hermes infrastructure integrity at runtime. Generates signed attestations, compares them against baselines, and detects configuration drift. CX Codex +1 129installs

Project sponsors

Companies that keep this analytics open