kata-skill-validate

You validate SKILL.md frontmatter and project structure by running a deterministic validator script against your skill directory, which checks required files, naming conventions, and cross-reference integrity, returning exit code 1 for errors and 0 for warnings.

Skill validation for GitHub project directories is a deterministic readiness check that verifies a skill folder conforms to expected Lex structure, ensuring SKILL.md frontmatter includes valid name and description fields before downstream packaging or discovery workflows.

You check your Python skill project by executing the validator against your skill folder path, such as running the script with your directory and a text format flag, which reports frontmatter violations with severity levels without altering any files.

The skill validator does not modify files during project structure checks; it executes a single-pass validator that orchestrates reporting of rule violations exactly as produced, without filtering or mutating the project directory.

The YAML frontmatter validator reports violations with specific severity levels and classifies overall results as ok, ok-with-warnings, or failed, ensuring errors trigger an exit code 1 while warnings-only scenarios return exit code 0 for CI gating.

You can use this validation script for repository automation and CI-style gating because it applies deterministic checks to a specific skill root directory path, ensuring cross-reference integrity and required frontmatter fields pass before merging or packaging.