agent-toolkit/skill-judge

Score SKILL.md files and skill packages across design and usability dimensions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/edupazogle/agentic_cockpit --skill agent-toolkit-skill-judge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-toolkit/skill-judge
Source: https://github.com/edupazogle/agentic_cockpit/tree/main/.agents/skills/agent-toolkit/skill-judge
Command: npx skills add https://github.com/edupazogle/agentic_cockpit --skill agent-toolkit-skill-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill Judge evaluates whether a skill package actually adds expert value or wastes tokens by duplicating knowledge that the model already has, while also checking structural compliance with the SKILL specification.

Core Features & Use Cases

  • Multi-dimensional skill scoring (120 points): Assesses knowledge delta, procedures, anti-pattern quality, specification compliance, progressive disclosure, freedom calibration, pattern recognition, and practical usability.
  • Actionable improvement guidance: Flags critical issues and provides prioritized fixes to make skills more usable and activation-ready.
  • Knowledge delta classification: Categorizes sections into Expert / Activation / Redundant to pinpoint what to keep, refine, or remove.

Quick Start

Ask the Skill Judge to evaluate the target skill’s SKILL.md and produce a structured report with a grade and concrete improvement recommendations.

Frequently Asked Questions about agent-toolkit/skill-judge

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

FAQPage Schema
How do I evaluate if my SKILL.md file adds expert value or just wastes tokens?

Evaluating SKILL.md files for expert value involves scoring knowledge delta, specification compliance, and anti-pattern quality. This skill audits packages to classify content as Expert, Activation, or Redundant, generating a structured report with actionable fixes.

What is the best way to audit YAML frontmatter and detect anti-patterns in skill packages?

Auditing YAML frontmatter and detecting anti-patterns requires checking structural compliance and pattern recognition. This skill reviews frontmatter quality and flags critical issues, producing a graded report with prioritized recommendations for skill activation readiness.

How do I score specification compliance and usability before publishing a skill package?

Scoring specification compliance and usability before publishing involves a multi-dimensional assessment out of 120 points. This skill evaluates progressive disclosure, freedom calibration, and practical usability to generate a final grade and concrete improvement guidance.

Can I validate workflow usability and knowledge delta for a SKILL.md file?

Validating workflow usability and knowledge delta for a SKILL.md file categorizes sections to pinpoint what to keep, refine, or remove. This skill estimates the knowledge delta to ensure your package adds genuine expert knowledge rather than redundant content.

Does the skill evaluation process require any external dependencies or components?

The skill evaluation process requires no external dependencies or components. It operates independently to audit SKILL.md files, validating YAML frontmatter and assessing anti-pattern quality to produce a self-contained structured report with scores and grades.

What are the limitations of automated skill evaluation for token efficiency and spec compliance?

Automated skill evaluation for token efficiency and spec compliance focuses on structural and content analysis rather than runtime behavior. It assesses pattern recognition and progressive disclosure but relies on the provided SKILL.md content to estimate the knowledge delta accurately.