Skill Issue — Skill Auditor
Audit all installed skills and produce a markdown report with recommendations.
Quick Start
bash
# Basic — scans ./skills and ./memory node scripts/audit.mjs # Custom directories SKILL_DIRS="./skills,/path/to/more/skills" MEMORY_DIR="./memory" node scripts/audit.mjs # Save report node scripts/audit.mjs > /tmp/skill-audit-report.md
Environment Variables
| Variable | Default | Description |
|---|---|---|
SKILL_DIRS | ./skills | Comma-separated skill directories to scan |
MEMORY_DIR | ./memory | Dated markdown logs for usage tracking |
AUDIT_DAYS | 7 | Days back to scan for usage |
What It Checks
- •Inventory — Finds every subdirectory containing a
SKILL.mdwith YAML frontmatter - •Usage — Scans recent memory/log files for skill name mentions
- •Health — Verifies required binaries (
requires.bins) and env vars (requires.env) - •Versions — Checks ClawdHub registry if
clawdhubCLI is available - •Recommendations — keep (active+healthy), update (outdated), review (unused), remove (broken deps)
Safety
- •Read-only — Never modifies, installs, or removes anything
- •Advisory only — Recommendations require manual action