skill-issuelisted
Install: claude install-skill diegosouzapw/awesome-omni-skill
# 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