skill-test

Validate `.claude/skills/*/SKILL.md` files for structural compliance and behavioral correctness.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill skill-test-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/easonlao/jiazi-game --skill skill-test-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you detect structural non-compliance and behavioral mismatches in .claude/skills/*/SKILL.md files so skill instructions stay reliable and consistent.

Core Features & Use Cases

  • Static structural linting: Checks that required frontmatter fields exist, that skills have enough phase structure, include verdict keywords, follow collaborative protocol expectations, and end with a next-step handoff.
  • Behavioral verification (spec mode): Evaluates how well a skill satisfies assertions defined in a corresponding test spec, focusing on instruction clarity rather than running code.
  • Category rubric evaluation: Applies category-specific metrics from the CCGS Skill Testing Framework quality rubric to identify gaps.
  • Coverage auditing: Produces a coverage report across skills and agents using the catalog to show what has (or has not) been tested.

Quick Start

Run the static linter for all skills by executing: /skill-test static all

Frequently Asked Questions about skill-test

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

FAQPage Schema
How do I validate YAML frontmatter in SKILL.md files?

You can validate YAML frontmatter in SKILL.md files by running a static structural linter that checks for required frontmatter fields, phase structure, verdict keywords, and next-step handoffs. This ensures skill instructions remain structurally compliant and consistent.

What is behavioral verification for skill testing?

Behavioral verification for skill testing evaluates how well a skill satisfies assertions defined in a corresponding test spec, focusing on instruction clarity rather than running code. It produces deterministic PASS/FAIL/WARN style outputs to highlight behavioral mismatches.

How do I audit test coverage across multiple skills?

You audit test coverage across multiple skills by using catalog-driven coverage auditing that produces a report showing what has or has not been tested across skills and agents. This identifies testing gaps without requiring external dependencies.

Does skill structural linting require external dependencies?

Skill structural linting does not require external dependencies. It parses YAML frontmatter and locates optional spec and rubric sources from the testing framework to produce deterministic PASS/FAIL/WARN style test outputs entirely without external dependencies.

When do I need category rubric evaluation for developer tooling?

You need category rubric evaluation for developer tooling when applying category-specific metrics from the CCGS Skill Testing Framework quality rubric to identify gaps. This ensures skills meet quality standards specific to their category.