Agent skill · research science · davila7
skill-judge
Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Provides multi-dimensional scoring and actionable improvement suggestions.
Why this skill is useful
Adds a structured evaluation framework and scoring system for assessing AI skills that are not commonly documented.
What it needs
About 12k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.
What this skill does
Skill Judge Evaluate Agent Skills against official specifications and patterns derived from 17+ official examples. --- Core Philosophy What is a Skill? A Skill is NOT a tutorial. A Skill is a knowledge externalization mechanism. Traditional AI knowledge is locked in model parameters. To teach new capabilities: Skills change this: This is the paradigm shift from "training AI" to "educating AI" — like a hot-swappable LoRA adapter that requires no training. You edit a Markdown file in natural language, and the model's behavior changes. The Core Formula Good Skill = Expert-only Knowledge − What Claude Already Knows A Skill's value is measured by its knowledge delta — the gap between what it provides and what the model already knows. Expert-only knowledge: Decision trees, trade-offs, edge cases, anti-patterns, domain-specific thinking frameworks — things that take years of experience to accumulate What Claude already knows: Basic concepts, standard library usage, common programming patterns, general best practices When a Skill explains "what is PDF" or "how to write a for-loop", it's compressing knowledge Claude already has. This is token waste — context window is a public resource shared with system prompts, conversation history, other Skills, and user requests. Tool vs Skill Concept Essence Function Example --------- --------- ---------- --------- Tool What model CAN do Execute actions bash, readfile, writefile, WebSearch Skill What model KNOWS how to do Guide decisions PDF processing, MCP building, frontend design Tools define capability boundaries — without bash tool, model can't execute commands. Skills inject knowledge — without frontend-design Skill, model produces generic UI. The equation: Same Claude model, different Skills loaded, becomes different experts. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills davila7/skill-judge