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.