← Back to Skills Marketplace
theshadowrose

Sentinel - AI Agent State Guardian

by Shadow Rose · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
278
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install sentinel
Description
Automated backup, integrity monitoring, and self-healing for AI agent workspaces. Detects unexpected changes, creates automatic backups, self-heals from corr...
Usage Guidance
This skill appears to do what it says: local monitoring, backup, manifest, and restore. Before installing or running it, do the following: 1) Review and edit sentinel_config.py to point WORKSPACE_ROOT only at the workspace you intend to monitor (do NOT set it to / or other system-wide paths). 2) Set BACKUP_DIR to a location with sufficient space, ideally on a separate disk or encrypted volume; be aware backups are stored unencrypted and can contain secrets. 3) Set STATE_FILE, LOG_FILE, and ALERT_FILE to safe paths and verify file permissions. 4) Disable AUTO_RESTORE_ON_CORRUPTION until you run several --once cycles and confirm behavior. 5) Run python3 sentinel.py --once to test and inspect generated backups and state files. 6) If you need off-site archival or encryption, integrate a separate tool (rclone, encrypted disk) as suggested in LIMITATIONS.md. 7) Because the code is included and uses only stdlib, you can audit the files locally; if you need network/webhook alerting, note WEBHOOK_URL is optional/not implemented and would require configuration to contact external endpoints.
Capability Analysis
Type: OpenClaw Skill Name: sentinel Version: 1.0.1 The Sentinel skill bundle is a legitimate utility designed for monitoring file integrity and performing automated backups within an AI agent's workspace. The code (sentinel.py, sentinel_manifest.py, sentinel_restore.py) uses standard Python libraries to perform SHA-256 hashing, directory walking, and file copying without any evidence of data exfiltration, obfuscation, or unauthorized execution. The instructions in SKILL.md correctly guide the AI agent on how to use the tool for its stated purpose of state protection and recovery.
Capability Assessment
Purpose & Capability
Name/description match implementation: code scans a configured WORKSPACE_ROOT, computes hashes, writes a state file, creates timestamped backups, and offers restore/manifest tools. No unrelated cloud or service credentials are requested and required files and operations align with a backup/integrity tool.
Instruction Scope
SKILL.md and code instruct the agent to copy config_example.py to sentinel_config.py and then scan the configured workspace recursively. That means the tool will read any files under WORKSPACE_ROOT and write to BACKUP_DIR and STATE_FILE — expected for this purpose, but potentially wide in scope if WORKSPACE_ROOT is misconfigured (e.g., set to /). The instructions advise running as a service; nothing in SKILL.md asks the agent to read unrelated system credentials or external files.
Install Mechanism
No install spec or external dependencies; code is pure Python stdlib. There is no remote download or archive extraction. This is low risk from supply-chain/install perspective.
Credentials
The skill requests no environment variables or external credentials (ok). It does, however, require write/read access to user-specified filesystem paths (WORKSPACE_ROOT, BACKUP_DIR, STATE_FILE, LOG_FILE, ALERT_FILE). Those locations may contain secrets or sensitive files; storing backups in plain form (no encryption) is documented as a limitation and is expected but important to note.
Persistence & Privilege
Skill is not always-enabled and is user-invocable. It can be run continuously or installed as a systemd/launchd service (documented), which grants it persistent filesystem activity. AUTO_RESTORE_ON_CORRUPTION defaults to True in examples — this can cause automatic overwrites/restores if enabled, so users should test with AUTO_RESTORE disabled until confident.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install sentinel
  3. After installation, invoke the skill by name or use /sentinel
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fixed SKILL.md API docs (correct class names, constructor signatures, CLI usage); removed quality-verified artifact from README
v1.0.0
Initial release
Metadata
Slug sentinel
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Sentinel - AI Agent State Guardian?

Automated backup, integrity monitoring, and self-healing for AI agent workspaces. Detects unexpected changes, creates automatic backups, self-heals from corr... It is an AI Agent Skill for Claude Code / OpenClaw, with 278 downloads so far.

How do I install Sentinel - AI Agent State Guardian?

Run "/install sentinel" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Sentinel - AI Agent State Guardian free?

Yes, Sentinel - AI Agent State Guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Sentinel - AI Agent State Guardian support?

Sentinel - AI Agent State Guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Sentinel - AI Agent State Guardian?

It is built and maintained by Shadow Rose (@theshadowrose); the current version is v1.0.1.

💬 Comments