Skill Health Monitor — v1.0 Release Notes
Version: 1.0
Released: 2026-04-20
Price: $4.99
Category: orchestration
QA Status: APPROVED_FOR_RELEASE (Viper 2026-04-20)
What It Does
Skill Health Monitor scans your entire installed OpenClaw skill library for health issues — broken Python scripts, missing files, syntax errors, unresolvable imports, stale metadata, and crash indicators — and reports a clear ✅/⚠️/❌ status for every skill. It catches problems before they cause silent failures in production, with a watch mode that runs continuously and fires webhook alerts the moment a skill goes unhealthy. Think of it as a linting + diagnostics layer that runs across your full skill estate in seconds.
Use Cases
- Operators managing 10+ installed skills who need a fast weekly audit to catch broken scripts, stale metadata, or syntax errors before they surface as mysterious cron failures at 3 AM
- Developers installing or updating skills from ClawHub who want an instant post-install verification that all scripts parse cleanly and dependencies are available
- Anyone debugging a skill that stopped working — the single-skill scan mode (
--skill) gives a structured diagnostic rather than manual file inspection
Requirements
| Requirement | Detail |
|-------------|--------|
| OpenClaw | Any current version |
| Python | 3.8+ |
| Dependencies | stdlib only (py_compile, importlib, json, os, pathlib) — no pip installs |
| API Keys | None required |
| Optional | Webhook URL for watch mode alerting |
Example Usage
Full health scan of all installed skills:
python3 scripts/skill_health_monitor.py --mode scan
Scan a single skill:
python3 scripts/skill_health_monitor.py --mode scan --skill email-triage-agent
Syntax check only (fastest — good for CI):
python3 scripts/skill_health_monitor.py --mode syntax-check
Issues only (suppress healthy skills):
python3 scripts/skill_health_monitor.py --mode scan --issues-only
Watch mode with webhook alerts:
python3 scripts/skill_health_monitor.py --mode watch --interval 60 --webhook $WEBHOOK_URL
Schedule a weekly Monday 4 AM audit:
schedule: cron 0 4 * * 1
payload: python3 /path/to/skills/skill-health-monitor/scripts/skill_health_monitor.py --mode scan --issues-only --webhook $WEBHOOK_URL
Expected output (scan mode):
🔍 Skill Health Monitor — Scan 2026-04-20 05:00 UTC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ competitor-intel-tracker HEALTHY
✅ multi-agent-orchestrator HEALTHY
⚠️ smart-model-router WARN — last modified 45 days ago
❌ email-triage-agent ERROR — scripts/triage.py: SyntaxError line 47
Summary: 9 scanned | 7 healthy | 1 warning | 1 error