skill-test

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/JunnnnyWon/Codex-Game-Studios --skill skill-test-junnnnywon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/JunnnnyWon/Codex-Game-Studios/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/JunnnnyWon/Codex-Game-Studios --skill skill-test-junnnnywon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates the structural compliance and behavioral correctness of .claude/skills/*/SKILL.md files, ensuring a consistent quality gate for skill units.

Core Features & Use Cases

  • Structural linter: performs seven checks on each skill's SKILL.md, including frontmatter, phase count, and presence of verification keywords.
  • Behavioral verifier: cross-checks skill instructions against test specs to assess expected outcomes.
  • Category rubrics: evaluates skills against category-specific metrics via the CCGS Skill Testing Framework catalog.
  • Coverage reporting: supports audit mode to summarize skill and agent test status across the catalog.

Quick Start

Invoke the static mode for a single skill or all skills to begin validation.

Frequently Asked Questions about skill-test

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

FAQPage Schema
How do I validate Claude skill files for structural compliance?

To validate Claude skill files, run a structural linter that checks SKILL.md frontmatter, phase count, and verification keywords. This ensures each skill meets required quality gates for the Claude Skill Testing Framework.

What does static mode check when validating SKILL.md files?

Static mode performs seven structural checks on SKILL.md files, enforcing required frontmatter fields, multi-phase structure, and the presence of verification keywords to ensure skill compliance.

Can I audit an entire catalog of Claude skills at once?

Yes, you can use audit mode to summarize skill and agent test status across an entire catalog. This coverage reporting mode evaluates the full scope of your Claude Skill Testing Framework implementation.

Do I need external dependencies to run skill testing and validation?

No external dependencies are required. The validation executes entirely within the existing skill, hook, and template architecture, enforcing collaboration protocols without needing external packages.

How do I cross-check skill instructions against test specs?

Use the behavioral verifier to cross-check skill instructions against test specs. This assesses expected outcomes to verify behavioral correctness across static, spec, category, and audit validation modes.

Why does my skill fail category rubrics in the testing framework?

Skills fail category rubrics when they do not meet category-specific metrics defined by the CCGS Skill Testing Framework catalog. Use category mode to evaluate skills against these particular standards.