documentation-structure-validator

Documentation structure validation checks your README, ADRs, API docs, and guides against predefined templates to ensure required sections are present and properly formatted. Load templates from templates.md, and the Skill identifies missing sections, syntax errors, and inconsistencies, then outputs a detailed report with passed checks, warnings, and critical issues.

Markdown syntax review identifies common formatting problems including incorrect header levels, improperly closed code blocks, broken links, and inconsistent styling. The Skill flags these issues so you can fix them before merging pull requests.

Yes, the Skill validates READMEs, Architecture Decision Records (ADRs), API documentation, and guides in a single pass. It applies the appropriate template for each document type and checks consistency across all files in your validation set.

Attach your documentation file and ask the Skill to validate its structure and completeness. It returns a report detailing which sections pass standards, which need warnings, and which are critical blockers—giving you actionable feedback before the pull request review.

The Skill generates a validation report highlighting inconsistencies between your document and the defined template. Critical issues block validation, warnings suggest improvements, and the report includes specific recommendations to bring your docs into compliance.

Yes, consistency checks ensure terminology and formatting remain uniform across your documentation set. The Skill flags deviations so you can standardize language and structure across READMEs, guides, ADRs, and API docs.