doc-readability

To audit documentation readability, apply the doc-readability Skill to a single page, an entire layer, or a glob pattern to generate a structured report on tone and structural consistency. It evaluates formatting against layer-specific rules to ensure publish-ready quality.

Documentation linting checks frontmatter presence, heading structure, and tone guidance against criteria defined by AGENTS.md. It enforces style guide standards by evaluating content across layers to ensure audience-appropriate consistency and structure.

Yes, you can target a specific directory or glob pattern, such as docs/integration/*.md, for a readability audit. The Skill evaluates the specified paths and provides a structured report detailing tone and structural issues.

You can check markdown documentation standards by running an audit that evaluates readability, tone, and structure. The Skill checks formatting and headings against layer-specific AGENTS.md criteria to produce actionable guidance for improvement.

The best way to ensure consistent documentation tone is to audit all pages listed in docs/SUMMARY.md at once. This process evaluates readability and tone across the entire documentation set, generating a structured report of inconsistencies.

Yes, an AGENTS.md file is required to define evaluation criteria like frontmatter presence, heading structure, and tone guidance. The readability audit uses these layer-specific rules to generate its structured report.