How does it handle batch processing?

By providing a parent directory path as the skill_path, the tool will automatically identify and validate all skill subdirectories within that folder.

Does it check if my code and documentation are out of sync?

Yes, it performs 'manifest parity' checks to ensure every input and output defined in your skill.yaml is properly documented in your SKILL.md.

What specific sections does this skill validate in SKILL.md?

It checks for eight required headers: Overview, Purpose, Usage, Inputs, Outputs, Examples, Integration, and Errors.

Can I integrate this into my git workflow?

Absolutely. It is designed to work with Betty's hook system for pre-commit validation and can be used in CI/CD pipelines to fail builds if documentation is invalid.

Can I skip certain validation rules?

Yes, you can use flags like --no-headers or --no-manifest-parity to bypass specific checks if your project follows a different standard.

Skill Documentation Validator

Name: Skill Documentation Validator
Author: epieczko

byepieczko

Content Management

Validates SKILL.md documentation files against their manifests to ensure consistency, quality, and structural integrity within the Betty Framework.

About

The docs.validate.skill_docs skill is a specialized utility designed to maintain high documentation standards by auditing SKILL.md files against their corresponding skill.yaml manifests. It prevents 'documentation drift' by automatically verifying that all required sections—including Usage, Inputs, Outputs, and Examples—are present and that all parameters defined in the code are accurately reflected in the documentation. This tool is essential for developers who need to ensure their custom Claude Code skills remain discoverable, professional, and easy to use through automated quality checks and CI/CD integration.

Key Features

Synchronizes documented inputs and outputs with skill.yaml manifests
0 GitHub stars
Generates detailed JSON reports or concise summary tables
Detects undocumented parameters, missing metadata, and invalid status tags
Supports batch validation for entire skill repositories
Validates SKILL.md structure against required standard headers

Use Cases

Standardizing documentation across large multi-skill development projects
Automating documentation quality gates within CI/CD pipelines
Ensuring manifest parity during rapid skill updates and iterations

About

Key Features

Synchronizes documented inputs and outputs with skill.yaml manifests
0 GitHub stars
Generates detailed JSON reports or concise summary tables
Detects undocumented parameters, missing metadata, and invalid status tags
Supports batch validation for entire skill repositories
Validates SKILL.md structure against required standard headers

Use Cases

Standardizing documentation across large multi-skill development projects
Automating documentation quality gates within CI/CD pipelines
Ensuring manifest parity during rapid skill updates and iterations