| name | commands-audit |
| description | Audit custom commands for structural completeness across global and project scopes. Auto-activates when auditing commands, checking command quality, or inventorying slash commands. Trigger keywords: commands audit, audit commands, command quality, missing usage. |
| license | MIT |
| metadata | {"version":"1.2.0","hermes":{"tags":["Claude-Code","Commands","Audit","Quality"],"related_skills":["custom-command-audit","claude-audit"]}} |
Commands Audit
Scan Locations
~/.claude/commands/*.md (global)
.claude/commands/*.md (project)
Plugin-provided commands are out of scope; say so in the summary if plugins are installed.
Same name in both scopes: audit BOTH files — each copy is live somewhere (project wins inside the project, global everywhere else). Show one row per name only when the copies are identical; if they differ, show both rows and flag DIVERGED. Collapsing divergent copies audits a file that stays broken elsewhere.
Checklist
All checks are deterministic — pattern match only, no subjective judgment.
| Check | Pattern | Triage | Deep |
|---|
| Usage | ## Usage or code block with /command-name | NO-USAGE / OK | YES / NO |
| Instructions | ## Instructions, ## Steps, or ### Phase | NO-STEPS / OK | YES / NO |
| Output format | ## Output or output example in code block | — | YES / NO |
| Size | wc -l | show | show |
| Stale references | Paths matching *.md, .claude/skills/* — verify each path exists (Glob or equivalent); resolve relative paths against the scanned file's scope root (project root for project commands, ~ for global) | — | CLEAN / list |
Triage (no argument)
Run checklist (triage columns) on every command. Present as table sorted: flagged first, then by line count descending. End with: "X flagged / Y total (Z global, W project)."
Deep Audit (with argument)
Search both scopes for <name>.md. Run full checklist. For each failed check, suggest a specific fix.