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

0•

콘텐츠 관리

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

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.

주요 기능

01Synchronizes documented inputs and outputs with skill.yaml manifests

020 GitHub stars

03Generates detailed JSON reports or concise summary tables

04Detects undocumented parameters, missing metadata, and invalid status tags

05Supports batch validation for entire skill repositories

06Validates SKILL.md structure against required standard headers

사용 사례

01Standardizing documentation across large multi-skill development projects

02Automating documentation quality gates within CI/CD pipelines

03Ensuring manifest parity during rapid skill updates and iterations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty docs.validate.skilldocs

For use in Claude.ai and ChatGPT

주요 기능

01Synchronizes documented inputs and outputs with skill.yaml manifests

020 GitHub stars

03Generates detailed JSON reports or concise summary tables

04Detects undocumented parameters, missing metadata, and invalid status tags

05Supports batch validation for entire skill repositories

06Validates SKILL.md structure against required standard headers

사용 사례

01Standardizing documentation across large multi-skill development projects

02Automating documentation quality gates within CI/CD pipelines

03Ensuring manifest parity during rapid skill updates and iterations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty docs.validate.skilldocs

For use in Claude.ai and ChatGPT