skill-test

To lint skill files for structural compliance, run the skill-test validator to scan your skills before merging changes. It identifies and reports structural and behavioral issues in skill definitions to prevent drift and publishing errors in static mode.

Frontmatter validation checks YAML frontmatter, body structure, and cross-reference integrity to ensure skills load safely in Claude Code contexts. It enforces structural compliance and reports issues that could cause drift or publishing errors.

Yes, you can run spec-mode validation against predefined fixtures when fixtures exist. This applies alongside library-wide audits and static lint checks for YAML frontmatter and body structure across all skill definitions.

Your skill definition fails to load safely due to structural and behavioral issues like invalid YAML frontmatter, broken body structure, or cross-reference integrity errors. The skill-test validator identifies and reports these drift and compliance issues.

No dependencies are required to run a targeted audit on your skill files. The skill-test validator operates independently, applying static lint checks and optional spec-mode testing when fixtures exist within your skill library.

The best way to prevent publishing mistakes in a skill library is to validate skill definitions for structural compliance and drift. The skill-test validator enforces frontmatter, body structure, and cross-reference integrity before merging changes.