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.