soul-guardian

Detect unauthorized modifications to workspace markdown files and restore baselines.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/dfpalhano/openclaw-workspace --skill soul-guardian-dfpalhano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: soul-guardian
Source: https://github.com/dfpalhano/openclaw-workspace/tree/main/skills/soul-guardian
Command: npx skills add https://github.com/dfpalhano/openclaw-workspace --skill soul-guardian-dfpalhano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill protects your agent's critical workspace files from unauthorized or accidental modifications, ensuring the integrity of your AI's operational environment.

Core Features & Use Cases

  • Drift Detection: Monitors key files like SOUL.md and AGENTS.md for unexpected changes.
  • Auto-Restoration: Automatically reverts modified critical files back to their last approved baseline.
  • Tamper-Evident Auditing: Maintains a secure log of all file integrity events.
  • Use Case: Prevent accidental edits or malicious tampering with your agent's core instructions and identity files, ensuring consistent and secure operation.

Quick Start

Run python3 skills/soul-guardian/scripts/soul_guardian.py check --output-format alert to check for file integrity issues.

Frequently Asked Questions about soul-guardian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect unauthorized modifications to agent workspace files?

Drift detection identifies unauthorized modifications by comparing agent workspace files against an approved baseline. It monitors markdown files like SOUL.md and AGENTS.md to catch unexpected changes and prevent tampering.

What is file integrity monitoring for AI agents and why is it needed?

File integrity monitoring for AI agents tracks critical workspace files to prevent accidental edits or malicious tampering. It ensures the agent's core instructions and identity files remain consistent and secure during operation.

Can I automatically restore modified markdown files to a previous baseline?

Yes, you can automatically restore modified markdown files by reverting them back to their last approved baseline. This auto-restoration protects critical agent files from persistent unauthorized or accidental changes.

Does this file integrity check require Python 3 to run?

Yes, this file integrity check requires Python 3 to execute. You run the script directly from the workspace to perform drift detection and generate tamper-evident audit logs for compliance.

What is the best way to audit file changes and maintain tamper-evident logs for agents?

The best way to audit file changes is using tamper-evident logging that records all file integrity events. This maintains a secure audit trail of modifications, restorations, and drift detections for compliance.

When should I not use automatic restoration for agent file drift detection?

You should not use automatic restoration when you intentionally update critical workspace files and have not yet approved a new baseline. Doing so would revert your deliberate markdown edits back to the previous version.