skill-validator

To validate YAML frontmatter, run a pre-flight check on your skill directory to verify the schema, confirm required fields like name and description are present, and flag unknown fields before deployment.

Checking Python script syntax involves using py_compile to detect errors and validate integrity, while also verifying shell script shebangs and enforcing file size limits to ensure script compliance.

Verifying directory structure ensures the correct files and folders, such as SKILL.md, scripts, and references, are present and properly organized to meet packaging requirements before creating a .skill file.

You can check markdown quality automatically by using regex to assess heading structure, verify code block integrity, and validate links within SKILL.md, ensuring documentation consistency before deployment.

A pre-flight check prevents deployment errors and ensures consistency by catching common mistakes like missing required fields in SKILL.md or syntax errors in your Python scripts before you package the skill.

The skill validator works without external dependencies, relying solely on built-in tools like Python's py_compile for syntax checks and regex for markdown validation to perform comprehensive pre-flight checks.