/analyze-skill

name: analyze-skill
description: Analyze skill file complexity metrics and generate modularization recommendations for splitting or progressive loading.
usage: /analyze-skill [skill-path]

Analyze Skill Complexity

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

When To Use

Use this command when you need to:

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

When NOT To Use

Avoid this command if:

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

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
• **Code blocks**: Embedded code examples
• **Estimated tokens**: Context window impact

Recommendations Generated

• **MODULARIZE**: File exceeds thresholds, should be split
• **CONSIDER**: Approaching limits, evaluate for future growth
• **OK**: Within acceptable complexity bounds

Examples

/analyze-skill skills/modular-skills/SKILL.md
# Output:
# === Analysis for: skills/modular-skills/SKILL.md ===
# Line count: 180 (threshold: 150)
# Estimated tokens: 1,847
# === Recommendations ===
# MODULARIZE: File exceeds threshold (180 > 150)
# GOOD: Token usage in optimal range

/analyze-skill skills/skills-eval --verbose
# Includes detailed section breakdown

Integration with Modular Skills

This command is the first step in the modular-skills workflow:

1. **Analyze** → Use this command to assess complexity 2. **Design** → Plan module structure based on recommendations 3. **Estimate** → Use `/context-report` for token budgeting 4. **Validate** → Use `/skills-eval` for quality checks

Implementation

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/skill_analyzer.py --file "${1:-.}"