skill-test

Skill structure validation parses SKILL.md frontmatter to verify required fields like name, description, argument-hint, user-invocable, and allowed-tools. It executes static checks on markdown files to confirm structural correctness and specification compliance across all defined skill units.

Spec verification checks multi-phase structure, proper keyword usage, and collaboration guidance within skill definitions. You need spec verification when auditing skills to ensure behavioral correctness and that phase headings, exit guidance, and collaboration prompts meet required specifications.

You can validate all skills at once by running the static all command, or validate a single skill by specifying its name. Both methods generate audit-ready reports covering frontmatter fields, keywords, and structural sections across static and audit modes.

Auditing skill correctness involves running static, spec, category, and audit modes to evaluate structural and behavioral integrity. This multi-mode approach identifies missing frontmatter fields, verifies phase headings, and generates comprehensive audit reports for every skill unit under the skills directory.

Skill testing verifies that the markdown body contains required sections and guidance by checking for phase headings, keywords, collaboration prompts, and exit guidance. It ensures every skill unit includes the necessary structural components alongside valid frontmatter fields.