skill-judge

Evaluate SKILL.md files across eight quality dimensions and return structured reports.

Updated Nov 29, 2025

Search Tags:#anti-patterns #usability #frontmatter #pattern-recognition #skill-evaluation #knowledge-delta

Ready to run

npx skills add https://github.com/thimslugga/agent-skills --skill skill-judge-thimslugga

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/thimslugga/agent-skills/tree/main/skills/agent/skill-judge
Command: npx skills add https://github.com/thimslugga/agent-skills --skill skill-judge-thimslugga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Judge provides a rigorous framework to evaluate agent Skills by focusing on knowledge delta, structural quality, and practical usability, preventing token waste and ensuring publish-ready quality.

Core Features & Use Cases

Comprehensive evaluation across eight dimensions (Knowledge Delta, Mindset, Anti-Patterns, Specification, Progressive Disclosure, Freedom, Pattern Recognition, Usability).
Generates actionable improvement suggestions, validity checks, and a detailed evaluation report for SKILL.md based Skill units.
Use Cases: pre-publish auditing, skill-pack audits, and design pattern alignment for high-quality Skill units.

Quick Start

Provide the path to the SKILL.md for evaluation.

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 before publishing?▼

Assess SKILL.md quality by measuring knowledge delta, structure, and usability through an eight-dimension scoring protocol. The evaluation generates a structured report containing scores, critical issues, and actionable improvement suggestions.

What is knowledge delta in skill evaluation and why does it matter?▼

Knowledge delta in skill evaluation measures the actual informational value a Skill provides beyond common knowledge. Assessing it ensures the Skill delivers meaningful insights and prevents token waste by eliminating redundant or low-value content.

How do I audit frontmatter and loading patterns for agent Skills?▼

Audit frontmatter and loading patterns by applying an evaluation protocol that checks structural quality and progressive disclosure. This process validates the SKILL.md configuration, identifies anti-patterns, and scores pattern recognition efficiency.

Can I use this to check for anti-patterns in my Skill design?▼

Yes, you can check for anti-patterns in Skill design through the dedicated anti-patterns evaluation dimension. The assessment scans the SKILL.md structure to identify flawed design patterns and returns actionable suggestions to correct them.

What dimensions are scored when evaluating a Skill unit?▼

Evaluating a Skill unit scores eight dimensions: Knowledge Delta, Mindset, Anti-Patterns, Specification, Progressive Disclosure, Freedom, Pattern Recognition, and Usability. These criteria combine to determine if the Skill is publish-ready.

Does this skill evaluation tool require any dependencies to run?▼

No, this skill evaluation tool requires no dependencies to run. You simply provide the path to the SKILL.md file for evaluation, and it independently applies the scoring protocol to generate the report.