skill-judge

Evaluate SKILL.md files against an 8-dimension, 120-point scoring rubric.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill skill-judge-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/leonardoacosta/skills/tree/main/meta/skills/skill-judge
Command: npx skills add https://github.com/leonardoacosta/skills --skill skill-judge-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Agent Skills often fail because they repeat what the model already knows, have weak descriptions that never trigger, or lack structure. This Skill audits any SKILL.md file against official specifications and patterns from 17+ official examples, producing a scored report with concrete fixes. ## Core Features & Use Cases - 8-Dimension Scoring (120 points): Grades knowledge delta, mindset transfer, anti-patterns, description quality, progressive disclosure, freedom calibration, pattern recognition, and usability, with A-F grade thresholds. - Knowledge Delta Analysis: Classifies content as Expert, Activation, or Redundant (E:A:R ratio) to identify token-wasting sections. - Failure Pattern Diagnosis: Matches low-scoring skills against 9 named failure patterns (The Tutorial, The Dump, The Invisible Skill, etc.) to pinpoint root causes. - Use Case: You wrote a new SKILL.md for PDF processing. Run the judge to get a scored report showing your description lacks trigger keywords and your references have no loading triggers, with specific rewrite guidance. ## Quick Start Evaluate the SKILL.md file in my skill directory and give me the full scored report with improvement suggestions.

Frequently Asked Questions about skill-judge

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

FAQPage Schema
How do I evaluate the quality of a SKILL.md file?

Run the skill-judge evaluation protocol: read the SKILL.md completely, classify each section as Expert, Activation, or Redundant knowledge, then score 8 dimensions totaling 120 points. The output is a graded report with critical issues and top improvements.

What makes a good skill description in YAML frontmatter?

A good description answers three questions: WHAT the skill does, WHEN it should be used, and which KEYWORDS trigger it. It must list specific capabilities, include explicit trigger scenarios like "Use when...", and contain searchable terms so the agent activates it correctly.

How is the skill-judge score calculated and graded?

The total is the sum of 8 dimension scores out of 120 points, converted to a percentage. Grades are A (>=90%), B (>=82.5%), C (>=70%), D (>=60%), and F (<60%). Scores below 70% trigger mandatory failure-pattern diagnosis.

What are common failure patterns in Agent Skills?

Nine named patterns exist, including The Tutorial (explaining basics the model knows), The Dump (800+ line SKILL.md with no progressive disclosure), The Invisible Skill (vague description that never triggers), and The Freedom Mismatch (rigid scripts for creative tasks).

When should I not use skill-judge for a review?

The quick checklist in references/checklist.md is intended for fast audits, not full evaluations. The full 8-dimension protocol is for thorough scoring; loading the checklist during a full evaluation is explicitly discouraged.