skill-judge — Claude Code plugin: validate skill design quality
skill-judge — a Claude Code plugin that evaluates Agent Skills against official specifications and best practices. Use it to review SKILL.md files and skill packages, catching structural and formatting issues before publication.
MIT ★ 2,707 updated 2026-03-05
/plugin marketplace add softaworks/agent-toolkit
/plugin install skill-judge@agent-toolkitWhat skill-judge does
skill-judge audits Agent Skill design for compliance with specifications. It helps you identify problems in SKILL.md files and improve skill packages ahead of release. Useful for reviewing existing skills and refactoring them to meet standards.
The plugin works directly with SKILL.md files and skill package structure, checking them against official requirements. Point it at a file or skill directory, and it returns a list of findings with recommendations for each issue.
What it helps with
- validate SKILL.md against the official specification
- audit a skill package before publishing
- spot structural and formatting errors in a skill
- improve the design quality of an agent skill
Example prompts for the agent
- Validate the skill in
./skills/my-skillagainst the spec - Review a SKILL.md file for design quality
- Find spec violations in a skill package
How to install skill-judge
Plugin marketplace
/plugin marketplace add softaworks/agent-toolkit/plugin install skill-judge@agent-toolkitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about skill-judge
How do I install skill-judge in Claude Code?
Run two commands in order: /plugin marketplace add softaworks/agent-toolkit, then /plugin install skill-judge@agent-toolkit. The plugin will be ready to use after installation.
What does skill-judge do?
The plugin checks skills against official specifications and best practices. It analyzes SKILL.md structure, flags formatting errors, and suggests ways to improve your skill's design.
Why review a skill before publishing?
Auditing catches quality issues before you release your skill to a catalog or marketplace. It saves rework and increases the chance that other developers will actually use it.
Source text
skill-judge · MIT
Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Skills: skills/skill-judge
© softaworks · MIT · softaworks/agent-toolkit