Skill Issue — Skill Auditor
Audit all installed skills and produce a markdown report with recommendations.
Quick Start
# 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