Skill Auditor

Workflow

Step 1: Discover All Skills

SKILL.md

~/.claude/skills/*/SKILL.md

.claude/skills/*/SKILL.md

plugins/*/skills/*/SKILL.md

• Name: from frontmatter

  name:

  field (fall back to directory name)
• Level: global / project / plugin (include plugin name for plugin skills)
• Lines: total line count of

  SKILL.md

• Has allowed-tools: yes/no
• Description length: character count of

  description:

  field

Step 2: Present Summary Table

| # | Level | Plugin | Skill Name | Lines | Status |

• OVER

  — exceeds 500-line limit

• HEAVY

  — 300-499 lines (approaching limit)

• OK

  — under 300 lines

• Total skills per level
• Total lines across all skills
• Average lines per skill
• Skills exceeding limits

Step 3: Ask User for Selection

AskUserQuestion

• All skills marked OVER or HEAVY
• Top 5 largest skills by line count
• Option to review by plugin name
• Option to review all skills at a specific level

Step 4: Deep Review (per selected skill)

• Lines that don't change LLM behavior (fluff, attribution, personas)
• Redundant explanations of concepts Claude already knows
• Verbose examples that could be compressed
• Sections that repeat CLAUDE.md rules

• Ambiguous instructions that could be interpreted multiple ways
• Missing context that forces Claude to guess
• Inconsistent terminology within the skill

• Compare skill's purpose against other skills at same level
• Flag skills that cover substantially similar ground
• Identify candidates for merging or splitting

• Frontmatter completeness (name, description, allowed-tools)
• Description quality (too short = undiscoverable, too long = wasteful)
• Section organization (follows marketplace conventions?)

Step 5: Report Findings

## {skill-name} ({lines} lines)

**Verdict:** {TRIM | RESTRUCTURE | MERGE | OK}

**Issues:**
- [CONCISENESS] {specific finding with line reference}
- [CLARITY] {specific finding}
- [OVERLAP] overlaps with {other-skill}: {shared scope}

**Suggested savings:** ~{N} lines ({percentage}% reduction)
**Recommended actions:**
1. {specific action}
2. {specific action}

Step 6: Summary

• Total potential line savings
• Skills recommended for merging (with rationale)
• Priority order for improvements (highest token savings first)