skill-test

Validate .claude/skills directories for frontmatter, phase structure, and protocol compliance.

1|Updated May 5, 2026
One-click install
npx skills add https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios --skill skill-test-xganqaq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios --skill skill-test-xganqaq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you ensure every skill in .claude/skills is structurally correct and behaviorally aligned with its defined test expectations, preventing broken or inconsistent studio workflows.

Core Features & Use Cases

  • Structural compliance (static linting): Detect missing required frontmatter fields, missing phase structure, missing verdict keywords, and other format/protocol gaps across one skill or all skills.
  • Behavioral verification (spec testing): Evaluate skill instructions against assertions defined in the CCGS Skill Testing Framework spec files.
  • Category rubric evaluation: Check skills against category-specific quality metrics defined in the quality rubric.
  • Coverage auditing (audit reports): List which skills/specs/agent specs exist and show what has or has not been tested yet.
  • Use Case: Before launching a new studio skill or modifying an existing one, run static or spec tests to catch formatting/protocol issues early and maintain team-wide reliability.

Quick Start

Use the skill-test tool to validate structural compliance by running /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 and phase structure in skill directories?

To validate YAML frontmatter and phase structure, you check required frontmatter fields, phase structure, and verdict keywords across skill directories. This structural compliance linting detects format and protocol gaps to maintain consistent studio workflows.

What is behavioral testing for skill instructions using spec files?

Behavioral testing for skill instructions evaluates skill logic against assertions defined in spec files. This spec-driven approach verifies that instructions meet expected behaviors and pass defined test assertions within the testing framework.

How do I run a coverage audit for untested skills and specs?

To run a coverage audit, you generate audit reports listing which skills, specs, and agent specs exist. The audit identifies exactly what has or has not been tested yet, ensuring full test coverage across the directory.

Does skill validation work for CI-like maintenance workflows and all skills at once?

Skill validation works for CI-like maintenance workflows by checking one skill or the full set at once. It applies deterministic rule-based validations to ensure studio behaviors remain consistent before agents rely on them.

What is the best way to check skill quality against category-specific rubrics?

The best way to check skill quality is evaluating skills against category-specific quality metrics defined in the quality rubric. This category rubric evaluation ensures skills meet required standards for their designated category.

Why does skill testing fail when required frontmatter fields are missing?

Skill testing fails when required frontmatter fields are missing because static linting detects these format and protocol gaps. Missing frontmatter breaks structural compliance, preventing skills from passing deterministic rule-based validations.