skill-judge

Evaluate SKILL.md files against an official framework and return dimension scores.

1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/bamecho/my-claude-skills --skill skill-judge-bamecho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/bamecho/my-claude-skills/tree/main/skills/skill-judge
Command: npx skills add https://github.com/bamecho/my-claude-skills --skill skill-judge-bamecho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluate a Skill's design quality against official specifications and best practices. Use this to audit, calibrate, and improve SKILL.md files and skill packages to ensure they load correctly and activate reliably.

Core Features & Use Cases

  • Multidimensional evaluation across 8 dimensions (Knowledge Delta, Mindset, Anti-Pattern Quality, Specification Compliance, Progressive Disclosure, Freedom Calibration, Pattern Recognition, Practical Usability).
  • Clear scoring rubric and actionable improvement guidance for Skill authors.
  • Suitable for periodic audits of Skill units and for onboarding new contributors to the Skill ecosystem.

Quick Start

Run a full Skill evaluation on the target SKILL.md following this evaluation protocol.

Frequently Asked Questions about skill-judge

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

FAQPage Schema
How do I evaluate a SKILL.md file to see if it loads and activates correctly?

Evaluating a SKILL.md file involves auditing its design against an official specification to measure dimensions like knowledge delta, anti-pattern quality, and loading discipline. This Skill returns a structured report with dimension scores and actionable improvements for the next edit.

What is skill evaluation and how does it quantify knowledge delta?

Skill evaluation is the process of scoring a SKILL.md design against best practices to ensure reliable activation. Quantifying knowledge delta measures the distinct value a Skill adds over baseline reasoning, returning concrete scores across eight evaluation dimensions.

How do I audit frontmatter and loading triggers in a Skill package?

Auditing frontmatter and loading triggers requires checking specification compliance and progressive disclosure within the SKILL.md. This evaluation protocol reviews loading discipline and pattern recognition to identify critical issues preventing reliable Skill activation.

Can I use skill evaluation for onboarding new contributors to the Skill ecosystem?

Yes, skill evaluation is suitable for onboarding new contributors to the Skill ecosystem. Running periodic audits with a clear scoring rubric and multidimensional evaluation helps calibrate SKILL.md designs and ensures authors understand loading triggers and anti-pattern quality.

What are common anti-patterns in SKILL.md design and how do I fix them?

Common anti-patterns in SKILL.md design include poor loading discipline, weak pattern recognition, and inadequate freedom calibration. Evaluating anti-pattern quality surfaces these critical issues and provides top improvements to act on in the next edit.

Best way to review specification compliance for a Skill unit?

The best way to review specification compliance for a Skill unit is applying a multidimensional evaluation framework. This protocol audits frontmatter, checks loading triggers, and returns a structured report with actionable improvement guidance for Skill authors.