skill-test

To validate Claude Code skill files, run static checks against the SKILL.md frontmatter to ensure required fields like name, description, and allowed-tools are present and structurally coherent across the .claude/skills directory.

YAML frontmatter validation checks that SKILL.md files contain required metadata fields such as name and description, optional context, and a defined allowed-tools set to ensure quality assurance and structural compliance.

To audit skill coverage, run the audit mode which aggregates static, spec, and category validation results to surface gaps across the skillset, cross-checking test specs and catalog links to verify behavioral correctness.

Yes, you can check skill files against category rubrics by running the category mode, which evaluates skills against category guidelines to ensure alignment with governance and reports PASS, WARN, or FAIL with remediation guidance.

No external dependencies are required to run skill testing and validation, as the tool operates directly on the repository's .claude/skills directory and requires only a SKILL.md frontmatter with name and description fields.

A FAIL status during skill validation indicates structural or behavioral non-compliance, and the tool outputs actionable remediation guidance detailing which required frontmatter fields or test specs are missing or incorrect.