skill-judge

Evaluate SKILL.md content using an 8-dimension framework and generate a structured report.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/program-the-brain-not-the-heartbeat/dotfiles --skill skill-judge-program-the-brain-not-the-heartbeat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/program-the-brain-not-the-heartbeat/dotfiles/tree/main/config/claude/skills/skill-judge
Command: npx skills add https://github.com/program-the-brain-not-the-heartbeat/dotfiles --skill skill-judge-program-the-brain-not-the-heartbeat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill Judge addresses the challenge of measuring Skill design quality to prevent token waste and ensure Skills activate reliably. It provides a rigorous evaluation framework that highlights expert content, loading structure, and actionable improvements for SKILL.md and related packages.

Core Features & Use Cases

  • An 8-dimension evaluation framework (D1–D8) that covers Knowledge Delta, Mindset + Procedures, Anti-Pattern Quality, Specification Compliance, Progressive Disclosure, Freedom Calibration, Pattern Recognition, and Practical Usability, with clear scoring guidance and a final grade.
  • Generates a structured Skill Evaluation Report detailing dimension scores, critical issues, and prioritized improvements to accelerate publishing, auditing, and quality benchmarking.
  • Ideal for pre-publish reviews, internal audits, and calibration across Skill units to ensure consistency with official patterns and best practices.

Quick Start

Run an evaluation pass on SKILL.md to generate a structured report.

Frequently Asked Questions about skill-judge

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

FAQPage Schema
How do I evaluate Skill design quality before publishing?▼

You can evaluate Skill design quality by applying an 8-dimension evaluation framework covering Knowledge Delta and Anti-Pattern Quality to generate a structured report with actionable improvements for SKILL.md.

What is the Knowledge Delta in content analysis?▼

Knowledge Delta in content analysis identifies gaps between expert knowledge and existing model knowledge by evaluating a Skill's content to ensure reliable activation and prevent token waste.

How do I audit SKILL.md loading behavior and frontmatter?▼

You can audit SKILL.md loading behavior and frontmatter by scoring Specification Compliance and Progressive Disclosure dimensions, which produces a practical improvement plan for loading structure.

Does this skill evaluation framework work for internal audits?▼

Yes, the skill evaluation framework works for internal audits by calibrating across Skill units to ensure consistency with official patterns and best practices during pre-publish reviews.

What are the limitations of pattern recognition in skill evaluation?▼

Pattern recognition limitations in skill evaluation arise when existing model knowledge fails to match expert content, requiring Freedom Calibration and specification compliance adjustments to resolve critical issues.