{'>'}_
English 繁體中文 日本語 한국어 Deutsch Español Français
Login

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.

20 stars
0 forks
JavaScript
31 views
View on GitHub Add to Favorites

SKILL.md

name: skill-issue description: "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."

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

  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