⭐ Found this useful? Star this repo to help others discover it!

Validates all installed OpenClaw skills by checking their declared dependencies (binaries, OS requirements) and reports which are healthy, broken, or missing deps.

📌 If you find this useful, please ⭐ star this repo! It helps other developers maintain healthy OpenClaw installations.

# Clone and run
git clone https://github.com/jugaad-lab/skilldoc.git
cd skilldoc
pip install pyyaml  # optional but recommended
python3 skilldoc.py check

OpenClaw skills declare binary dependencies in their SKILL.md frontmatter, but there's no way to know which skills will actually work on your system until you try to use them and they fail. With 50+ skills installed, debugging "command not found" errors one at a time is painful.

# Full health check (shows broken skills)
python3 skilldoc.py check

# Verbose — also show healthy skills  
python3 skilldoc.py check -v

# List all skills with status
python3 skilldoc.py list

# Get copy-pasteable fix commands
python3 skilldoc.py fix-hints

# Check a specific skill
python3 skilldoc.py check --skill apple-notes

# JSON output (for automation/heartbeats)
python3 skilldoc.py check --json

# Filter
python3 skilldoc.py check --filter broken

Add to HEARTBEAT.md for periodic skill health monitoring:

python3 ~/workspace/agent-forge/2026-02-11-skilldoc/skilldoc.py check --json

Run skilldoc check after updates to see if new skills need dependencies installed.

1. Scans /opt/homebrew/lib/node_modules/openclaw/skills/ (builtin) and ~/workspace/skills/ (custom)
2. Parses YAML frontmatter from each SKILL.md
3. Extracts metadata.openclaw.requires.bins and metadata.openclaw.os
4. Checks each binary with which
5. Reports status with install hints from metadata.openclaw.install

• Python 3.10+
• PyYAML (pip install pyyaml) — falls back to regex parsing if unavailable

⭐ Found these useful? Star the repos you like!

Found a bug? Have an idea? Open an issue or submit a PR!

If this tool saved you time, please ⭐ star this repo — it helps others find it.