docs.validate.skilldocs

Documentation validation checks that SKILL.md reflects your skill.yaml manifest, detecting drift in required headers and field parity. Run the validator against your skill directory to report errors, warnings, and parity status between files.

Validation checks required headers in SKILL.md, ensures inputs and outputs match between documentation and manifest, verifies cross-file consistency across use cases and integrations, and flags critical problems as errors or minor issues as warnings.

Yes, the validator applies to Betty Framework skills. It loads your skill.yaml and SKILL.md files, parses and compares their fields, and reports validation results. Run it directly on your skill directory using the provided command.

The validator reports misaligned headers and field inconsistencies between files as errors or warnings depending on severity. This drift detection ensures documentation stays synchronized with manifest definitions.

The validator reports parity status explicitly when comparing SKILL.md and skill.yaml fields. Errors flag critical mismatches; warnings flag minor inconsistencies in required sections or field definitions.