reviewing-skills

Reviewing a skill checks naming conventions, description quality, file structure, and progressive disclosure against Claude's official standards. Provide the skill directory path to receive a detailed compliance report with prioritized actionable feedback on structure, naming, and content organization.

Progressive disclosure organizes skill content into three levels: Level 1 introduces core functionality, Level 2 expands with details, and Level 3 provides advanced options. The review validates that each level loads appropriately and content increases in complexity without overwhelming users initially.

Skills must use gerund form for names (e.g., reviewing-skills), maintain concise descriptions free of redundancy, and follow consistent structure. The review identifies violations like passive voice, unclear wording, or oversized sections that compromise clarity.

Yes, the skill parses YAML frontmatter and validates SKILL.md files, directory structure, and reference organization across skill repositories. It generates prioritized feedback applicable to analyzing multiple skills systematically for compliance.

The review assesses reference depth, organization, and relevance to ensure supporting materials enhance skill understanding without redundancy. It flags missing, shallow, or disorganized references that weaken instructional clarity.

Effective descriptions are concise, avoid repetition between sections, and progress from core features to implementation details. The review identifies oversized sections, redundant phrasing, and structural violations that dilute messaging and user comprehension.