skill-judge — Claude Code skill: review SKILL.md
This skill reviews SKILL.md files and skill packages against specifications and design practices. Use it to audit a skill and get suggestions for improvement.
npx claude-code-templates@latest --skill productivity/skill-judgeWhat skill-judge does
skill-judge assesses how much useful knowledge a skill adds beyond what the model already knows, and flags material that repeats familiar concepts. It also considers whether the instructions shape the model’s reasoning and include relevant domain procedures. The output includes scores across multiple dimensions and actionable suggestions.
Its evaluation draws on official specifications and patterns derived from skill examples. The described criteria include knowledge delta and the balance between thinking frameworks and procedures. This reviews skill design; it is not a test of whether your project code runs. Install it in Claude Code with npx claude-code-templates@latest --skill productivity/skill-judge.
What it helps with
- audit a
SKILL.mdbefore publishing it - spot repeated explanations of basic concepts
- check whether a skill adds expert knowledge
- get concrete suggestions for improving a skill package
Example prompts for the agent
- Audit
SKILL.mdfor knowledge the model already has and suggest ways to improve it. - Review this skill package against design practices and flag redundant explanations.
- Assess whether these instructions guide domain-specific reasoning and procedures.
How to install skill-judge
1claude-code-templates
npx claude-code-templates@latest --skill productivity/skill-judge2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill skill-judge -a claude-code3Manually: put the files in place
~/.claude/skills/skill-judge/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-judge/
Manually: put the files in place
.agents/skills/skill-judge/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/skill-judge/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates skill-judge2Manually: put the files in place
.github/skills/skill-judge/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/skill-judgeManually: put the files in place
.devin/skills/skill-judge/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-judge
How do I install skill-judge in Claude Code?
Run npx claude-code-templates@latest --skill productivity/skill-judge to install the skill with claude-code-templates.
What does skill-judge do?
It evaluates the design of SKILL.md files and skill packages, provides scores across multiple dimensions, and suggests improvements.
What does skill-judge look for in a skill?
It considers whether the skill contributes knowledge beyond what the model already knows, and whether it guides reasoning and provides relevant domain procedures.