skill-evaluator

Evaluate SKILL.md files for structure gaps and routing gaps.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/cr330326/AgentSkill --skill skill-evaluator-cr330326
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-evaluator
Source: https://github.com/cr330326/AgentSkill/tree/main/skill-evaluator
Command: npx skills add https://github.com/cr330326/AgentSkill --skill skill-evaluator-cr330326

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Identify design gaps, routing weaknesses, and improvement opportunities by evaluating Skills against progressive-disclosure standards.

Core Features & Use Cases

  • Assess three-layer architecture compliance (description, SKILL.md router, on-demand resources)
  • Produce structured, evidence-based recommendations to improve Skill quality
  • Support quick audits, full rewrites, or baseline checks of Skill documents

Quick Start

Run the analyzer on a Skill directory or SKILL.md to generate a baseline assessment.

Frequently Asked Questions about skill-evaluator

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

FAQPage Schema
How do I audit a SKILL.md file for structure gaps and routing weaknesses?

To audit a SKILL.md file, run the evaluator to analyze frontmatter, body references, contracts, and supporting files, generating a structured scorecard that identifies design gaps and routing improvements.

What is progressive disclosure in Skill architecture and when do I need to evaluate it?

Progressive disclosure in Skill architecture separates description, SKILL.md router, and on-demand resources. You evaluate it to ensure references, assets, and scripts are structured for efficient routing and quality compliance.

How can I validate three-layer architecture compliance for my Skills?

You validate three-layer architecture compliance by applying the evaluator to check the description, SKILL.md router, and on-demand resources, producing evidence-based recommendations and a structured scorecard.

Does the Skill evaluator require specific frontmatter to generate a scorecard?

Yes, the Skill evaluator requires frontmatter containing name and description fields to analyze the SKILL.md body and output a structured scorecard identifying structure and routing gaps.

What is the best way to identify improvement opportunities in existing Skill documents?

The best way to identify improvement opportunities is running a full evaluation to audit existing SKILL.md files, validating tool usage and supporting files against progressive-disclosure standards to generate actionable recommendations.

Can I perform a quick baseline check on a Skill directory without a full rewrite?

Yes, you can perform a quick baseline check by running the analyzer on a Skill directory or SKILL.md to generate a baseline assessment without committing to a full rewrite.