skill-judge

Evaluate AI agent skill design quality against best practices and official patterns.

9|2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/stephanj/claude-code-collections --skill skill-judge-stephanj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/stephanj/claude-code-collections/tree/main/skills/skill-judge
Command: npx skills add https://github.com/stephanj/claude-code-collections --skill skill-judge-stephanj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of token waste and ineffective agent behavior by evaluating whether a Skill provides genuine expert knowledge or merely repeats information the AI already knows.

Core Features & Use Cases

  • Knowledge Delta Analysis: Measures the gap between provided content and the AI's existing knowledge base.
  • Multi-Dimensional Scoring: Evaluates Skills across 8 dimensions including anti-patterns, progressive disclosure, and specification compliance.
  • Use Case: Use this before publishing a new Skill to ensure it is a high-value, compressed expert brain rather than a redundant tutorial.

Quick Start

Use the skill-judge to evaluate the design quality of the skill located at skills/my-new-skill/SKILL.md.

Frequently Asked Questions about skill-judge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit AI agent skills for token waste?

To audit AI agent skills for token waste, evaluate whether the skill provides genuine expert knowledge or merely repeats information the model already knows. This process identifies redundant content and ensures high-density knowledge transfer.

What is knowledge delta analysis in skill design?

Knowledge delta analysis in skill design measures the gap between the content provided in a skill and the AI's existing knowledge base. It minimizes token waste by filtering out redundant instructions that do not add value.

How do I evaluate agent skill quality against best practices?

You evaluate agent skill quality by applying multi-dimensional scoring across eight dimensions, including anti-patterns, progressive disclosure, and specification compliance. This ensures the skill meets established official patterns.

When do I need to optimize AI agent skills before publishing?

You need to optimize AI agent skills before publishing to ensure the final output is a high-value, compressed expert brain rather than a redundant tutorial. This prevents ineffective agent behavior during execution.

Can I review skill-based agent instructions for specification compliance?

Yes, you can review skill-based agent instructions for specification compliance as part of a multi-dimensional evaluation. This checks the instructions against established best practices and official patterns to ensure quality.

What are common anti-patterns in AI agent skill development?

Common anti-patterns in AI agent skill development include low knowledge delta and redundant content that wastes tokens. Evaluating skills against established best practices helps identify and eliminate these ineffective design patterns.