← Back to Skills Marketplace
3875
Downloads
1
Stars
38
Active Installs
3
Versions
Install in OpenClaw
/install soul-guardian
Description
Drift detection + baseline integrity guard for agent workspace files with automatic alerting support
Usage Guidance
Install only after initializing baselines from known-good files. Use --no-restore or change the policy to alert-only if you do not want automatic overwrites, keep the state directory private, and enable cron or launchd only when you want ongoing background enforcement.
Capability Analysis
Type: OpenClaw Skill
Name: soul-guardian
Version: 0.0.6
The soul-guardian skill is a comprehensive file integrity monitoring tool designed to protect agent workspace files (like SOUL.md and AGENTS.md) from unauthorized modifications. It implements robust security practices including SHA256 hashing for baselines, atomic file writes, and a tamper-evident audit log using hash chaining in `soul_guardian.py`. While it includes scripts for macOS persistence via launchd (`install_launchd_plist.py`) and file restoration capabilities, these are transparently documented and strictly aligned with the tool's stated purpose of maintaining workspace integrity. No evidence of data exfiltration, malicious prompt injection, or unauthorized remote execution was found.
Capability Assessment
Purpose & Capability
The file hashing, diffing, audit logging, quarantine copies, and restore behavior match the stated purpose, but auto-restoring SOUL.md and AGENTS.md is high-impact if the baseline is wrong or stale.
Instruction Scope
The protected file list and restore/alert modes are documented; some trigger phrases are broad, so users should invoke it intentionally for integrity tasks.
Install Mechanism
Installation and use are local Python workflows; cron, heartbeat, watch mode, and launchd scheduling are documented and opt-in, with launchd loading requiring an explicit install flag.
Credentials
The default behavior is local-only and proportionate, but the state directory can contain sensitive approved snapshots, patches, and quarantined copies of workspace instruction files.
Persistence & Privilege
No hidden persistence or privilege escalation was found; persistence is available only through documented heartbeat, cron, watch, or launchd setup.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-guardian - After installation, invoke the skill by name or use
/soul-guardian - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.6
Release 0.0.6 via CI
v0.0.5
Release 0.0.5 via CI
v0.0.2
Release 0.0.2 via CI
Metadata
Frequently Asked Questions
What is soul-guardian?
Drift detection + baseline integrity guard for agent workspace files with automatic alerting support. It is an AI Agent Skill for Claude Code / OpenClaw, with 3875 downloads so far.
How do I install soul-guardian?
Run "/install soul-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is soul-guardian free?
Yes, soul-guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does soul-guardian support?
soul-guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created soul-guardian?
It is built and maintained by davida-ps (@davida-ps); the current version is v0.0.6.
More Skills