skill-audit
Analyze Claude Code skills for compliance and token efficiency. Use when reviewing skills.
Resources
2Install
npx skillscat add bahayonghang/my-claude-code-settings/skill-audit Install via the SkillsCat registry.
SKILL.md
Audit the skill at $ARGUMENTS.
Steps
- If
$ARGUMENTSempty or no SKILL.md found, report error. - Run:
python "$SKILL_DIR/scripts/analyze_skill.py" "$ARGUMENTS" - Read
$SKILL_DIR/resources/CHECKLIST.mdand$SKILL_DIR/resources/PATTERNS.md. - Cross-reference JSON with CHECKLIST and PATTERNS.
- If parent directory has sibling skills, run:
python "$SKILL_DIR/scripts/detect_overlap.py" "<parent>" --target "<name>" - Present: Critical → Recommended → Optional, each with before/after fix.
- Output optimized SKILL.md resolving Critical and Recommended issues.
Output
Issues by severity, token budget table (Before/After/Δ), overlap report (if any), optimized SKILL.md.
Rules
- Official frontmatter fields only.
- Body < 300 tokens, imperative voice, no educational content.
- Preserve intent. Move reference content to resources/.
Categories
Install
npx skillscat add bahayonghang/my-claude-code-settings/skill-audit Install via the SkillsCat registry.