skill-judge

Evaluate SKILL.md files for knowledge delta and activation quality.

1|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/RamonsDka/the-architect-overlay --skill skill-judge-ramonsdka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-judge
Source: https://github.com/RamonsDka/the-architect-overlay/tree/main/skills/skill-judge
Command: npx skills add https://github.com/RamonsDka/the-architect-overlay --skill skill-judge-ramonsdka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured framework to evaluate whether a Skill truly adds value by measuring its knowledge delta against what Claude already knows, enabling targeted, expert-level design improvements.

Core Features & Use Cases

  • Assess frontmatter validity, description quality, progressive disclosure, and loading triggers to ensure reliable activation and minimal token waste.
  • Detect anti-patterns, supply NEVER lists with concrete reasoning, and guide three-layer content loading for on-demand resources.
  • Generate a formal evaluation report with actionable improvements for SKILL.md files and skill packages, facilitating calibration and standardization.

Quick Start

Analyze a sample SKILL.md to produce a concise evaluation and a remediation plan.

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 quality and measure the knowledge delta of a SKILL.md file?

To evaluate Skill quality, you assess the knowledge delta a SKILL.md delivers against the model's baseline, checking frontmatter validity, description quality, and progressive disclosure to ensure reliable activation and minimal token waste.

What are common anti-patterns in Skill design and how do I fix them?

Common anti-patterns in Skill design include poor frontmatter validity and missing loading triggers. You can fix them by detecting these issues, supplying NEVER lists with concrete reasoning, and guiding three-layer content loading for on-demand resources.

How does progressive disclosure work for on-demand resource loading in Skills?

Progressive disclosure works by structuring a SKILL.md body to load only required content initially, utilizing loading triggers across optional references and asset directories on-demand to ensure activation and minimize token consumption.

What is required to generate a formal Skill evaluation report and remediation plan?

Generating a formal Skill evaluation report requires a valid SKILL.md with a concise name and description. The process analyzes frontmatter, description quality, and loading triggers to produce actionable improvements for skill packages.

Can I assess frontmatter validity and loading triggers for skill packages without external dependencies?

Yes, you can assess frontmatter validity and loading triggers for skill packages without external dependencies. The Skill operates standalone to quantify value by measuring expert knowledge delivered as knowledge delta against the baseline.