skill-judge

To evaluate SKILL.md design quality, run a formal specification framework assessment that scores frontmatter validity, structure, and activation readiness, generating a structured evaluation report with actionable improvements.

The best way to audit skill documentation is applying a multi-dimension scoring framework that analyzes loading triggers, activation triggers, and progressive disclosure to reveal structural gaps and optimize loading behavior.

Yes, you can use an automated evaluation framework to check specification compliance by scoring dimensions like Knowledge Delta, Pattern Recognition, Anti-Patterns, and Usability to ensure robust skill package activation reliability.

Skill evaluation requires no external dependencies or separate components; it applies directly to any SKILL.md containing frontmatter, a body, and optional references or assets to determine how well it guides usage.

Skill designs score poorly on usability and progressive disclosure when they fail to guide activation, loading, and usage effectively, which a rigorous evaluation framework identifies through standardized multi-dimension scoring.

You should not use a formal skill evaluation framework when the target file lacks the required SKILL.md structure, specifically frontmatter and a body, as the assessment relies on these elements to generate actionable improvements.