| created | "2026-04-24T00:00:00.000Z" |
| modified | "2026-07-18T00:00:00.000Z" |
| compatibility | claude-code |
| reviewed | "2026-04-24T00:00:00.000Z" |
| description | Audit skill tree for overlap, split-pressure, and consolidation candidates. Use when finding confusing skill clusters or surfacing REFERENCE.md extraction candidates. |
| allowed-tools | Bash(python3 *), Read, TodoWrite |
| args | [--plugin <name>] [--strict] |
| argument-hint | [--plugin <name>] [--strict] |
| name | health-skill-audit |
/health:skill-audit
Produce triageable evidence for skill-to-skill quality: overlap clusters, split-pressure inside a skill body, and consolidation candidates. The analyzer reports only — every recommendation is editorial.
Complements the other skill audits — this skill assumes frontmatter hygiene is already green.
When to Use This Skill
| Use this skill when... | Use another approach when... |
|---|
| Finding overlapping skills ambiguous to an invoking agent | Frontmatter / size / body corruption (use scripts/plugin-compliance-check.sh) |
| Scoring split-pressure in an oversized skill body | Missing "Use when…" triggers (use scripts/audit-skill-descriptions.py) |
| Locating name-prefix or name-suffix clusters | CLI-flag compactness (use /health:check --scope=agentic) |
| Surfacing small sibling skills that could merge | Plugin ↔ stack relevance (use /health:check --scope=stack) |
Context
- Analyzer: !
find . -path '*/scripts/*' -maxdepth 3 -name audit-skill-structure.py -type f
- Prior output: !
find . -path '*/tmp/skill-audit/*' -maxdepth 3 -type f
- Compliance pre-check: !
find . -path '*/scripts/*' -maxdepth 3 -name plugin-compliance-check.sh -type f
- Description pre-check: !
find . -path '*/scripts/*' -maxdepth 3 -name audit-skill-descriptions.py -type f
Parameters
Parse these from $ARGUMENTS:
| Parameter | Description |
|---|
--plugin <name> | Restrict scan to a single plugin directory (e.g. configure-plugin) |
--strict | Exit non-zero on warn-tier findings in addition to error-tier |
Execution
Execute this skill-structure audit:
Step 1: Confirm prerequisites are green
These audits own orthogonal concerns. Run them first and resolve their findings before triaging this skill's output:
scripts/plugin-compliance-check.sh — frontmatter, size budget, body corruption
