julien-dev-skill-reviewer

Quality review evaluates your SKILL.md against a nine-dimension rubric covering clarity, completeness, discoverability, context efficiency, actionability, resource organization, examples, skill chaining, and error handling. Run the reviewer on your skill directory to generate a structured report with scores and refactoring priorities.

Production-ready skills meet frontmatter validation, structured organization, progressive disclosure via references/, one-level reference depth, error-handling guidance, and automated tooling compatibility. The reviewer checks these standards and flags violations so you can refactor systematically.

The reviewer detects repeated content, redundant explanations, and DRY violations across your SKILL.md and references tree. It proposes a refactoring plan prioritizing which duplications to remove first and how to restructure content for clarity without repetition.

Yes. The reviewer supports progressive disclosure through a references/ directory tree. Content moves to references while SKILL.md stays focused, reducing cognitive load while maintaining full context availability for users who need it.

The rubric scores clarity, completeness, discoverability, context efficiency, actionability, resource organization, examples, skill chaining, and error handling across use cases and edge cases. Each dimension receives a score, and low-scoring areas drive the refactoring plan.

Your skill must contain a SKILL.md file and a references/ directory. The reviewer analyzes YAML frontmatter, content structure, and reference organization to generate a quality report and actionable refactoring steps.