analyze-skill

name	analyze-skill
description	Analyze skill complexity and get modularization recommendations
usage	/analyze-skill [skill-path]

Analyze Skill Complexity

triggers: analyze skill, skill complexity, skill metrics, modularization, skill size, skill structure, skill analysis, complexity analysis

use_when:

• Assessing skill file complexity before adding content
• Planning modularization strategies
• Checking if a skill needs to be split
• Validating progressive disclosure design

do_not_use_when:

• Evaluating skill quality - use /skills-eval instead
• Estimating token usage only - use /estimate-tokens instead
• Creating new skills - use /create-skill instead

Analyzes a skill file for complexity metrics and provides modularization recommendations based on the modular-skills framework.

Usage

# Analyze specific skill file
/analyze-skill skills/my-skill/SKILL.md

# Analyze skill directory
/analyze-skill skills/my-skill

# Analyze current directory (if in a skill folder)
/analyze-skill .

What It Analyzes

The analyzer evaluates several complexity dimensions:

Metrics Collected

• Line count: Total lines vs threshold (default: 150)
• Word/character count: Content density indicators
• Theme sections: Number of # level headings
• Subsections: Number of level headings