skill-issue
"Audit and review all installed agent skills. Run on-demand or via cron to get a health report: skill inventory, usage tracking, version checks, dependency health, and actionable recommendations (keep, update, review, remove). Use when asked to review skills, check for skill updates, find unused skills, or audit the skill ecosystem."
Resources
3Install
npx skillscat add shubhgaji/skill-issue Install via the SkillsCat registry.
We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no calls to action, no bullet points, no headings, no markdown formatting. At most 60 words. Must be only the summary text, no quotes, no extra. Provide 2-3 sentences. Let's craft: "The skill audits all installed agent skills, generating a health report that lists inventory, usage, version checks, dependency status, and recommendations such as keep, update, review, or remove.
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.mdEnvironment 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
Categories
Install
npx skillscat add shubhgaji/skill-issue Install via the SkillsCat registry.