skill-evaluator

Skills that do not activate on relevant queries waste the entire investment in writing them. A skill can have deep, well-structured content and still deliver zero value if its frontmatter description lacks the trigger phrases users actually type. Quality evaluation catches trigger gaps, missing sections, and shallow content before deployment — turning

a skill from a static document into a reliable tool.

| references/evaluation-rubric.md | Detailed 1-5 scoring criteria per dimension, weight justifications, worked examples for calibration |

Evaluate Claude Code skill quality across 6 weighted dimensions: frontmatter quality, trigger coverage, structural completeness, content depth, consistency and integrity, and CONTRIBUTING.md compliance. Produces scored audit reports with severity-classified findings and actionable recommendations. Two modes: (1) Quick Audit — single skill, full per-dimension report with weighted scoring; (2) Full Audit — all skills in repo, comparative ranking table plus per-skill summaries. Triggers on: "evaluate skill", "audit skill quality", "score skill", "skill review", "check skill completeness", "rate this skill", "skill quality check", "grade skill", "assess skill", "skill audit", "how good is this skill", or when a user asks for feedback on a SKILL.md file. Use this skill when reviewing skills before deployment, comparing skill quality across a repo, or diagnosing why a skill fails to activate on relevant queries. Source: mathews-tom/praxis-skills.