skill-issue

# 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 1. **Inventory** — Finds every subdirectory containing a `SKILL.md` with YAML frontmatter 2. **Usage** — Scans recent memory/log files for skill name mentions 3. **Health** — Verifies required binaries (`requires.bins`) and env vars (`requires.env`) 4. **Versions** — Checks ClawdHub registry if `clawdhub` CLI is available 5. **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