validate-coaches

To validate markdown frontmatter schema compliance, run a check that verifies required YAML keys like name, title, and category. This skill enforces these frontmatter fields alongside markdown section headers to ensure AI coaching assets meet strict standards.

Checking markdown files for required sections and naming conventions involves verifying headers like Purpose and Instructions. This skill automates that structural integrity check and enforces consistent file naming to prevent deployment failures in CI/CD pipelines.

The best way to enforce category directory alignment is to validate file paths against defined category metadata. This skill checks that coach markdown files are correctly placed in directories matching their category frontmatter field.

Yes, you can use markdown validation in a CI/CD pipeline to catch missing frontmatter fields. Running this validation before deployment checks for required YAML keys and missing markdown sections, preventing broken AI coaches from reaching production.

Limitations of automating markdown schema compliance include strict adherence to predefined YAML frontmatter keys and specific section headers. This validation only catches structural and metadata errors, not the semantic quality or logic of the coaching instructions.