skill-reviewer

You can validate SKILL.md files by evaluating them against 11 defined dimensions, which generates a detailed scorecard and specific actionable feedback for improvement.

A SKILL.md quality assurance review checks 11 dimensions: discoverability, persona definition, context handling, information gathering, core principles, methodology depth, output specification, brand voice alignment, progressive disclosure, cross-referencing, and overall relevance.

Automated evaluation grades your markdown documentation and identifies specific problems, providing actionable suggestions to enforce strict quality standards before finalizing your AI skills.

No dependencies are required to review SKILL.md files against project guidelines, as the evaluation operates independently using only the provided markdown file.

You should use an automated skill reviewer after developing a new skill or making edits to an existing SKILL.md file to get an objective, detailed review before it is finalized.

Your SKILL.md file receives a low score when the evaluation identifies insufficient methodology depth and poor progressive disclosure structure, outputting specific feedback to correct these dimensions.