docs-improve

To audit project documentation quality using the Diataxis framework, scan your docs/ directory to evaluate tutorials, how-to guides, references, and explanations for structural consistency, clear audience targeting, and valid cross-references, generating a documentation health score and actionable recommendations.

The Diataxis framework is a systematic approach to documentation that categorizes content into four modes: tutorials, how-to guides, reference, and explanations. This Skill uses it to inventory, audit, and align your docs/ directory structure, ensuring each document serves its specific user intent and audience.

Checking cross-references and consistency across core docs like README.md and AGENTS.md involves scanning these files to verify structured sections, last updated markers, and valid internal links. The audit ensures no placeholders remain and audience targeting is clear across the project documentation.

Yes, you can use this to enforce documentation standards for existing docs. It audits the docs/ directory to enforce structured sections, last updated markers, and clear audience targeting, while providing a health score and actionable recommendations to guide ongoing maintenance and eliminate placeholders.

The best way to improve documentation structure and eliminate placeholders is to run a Diataxis-driven audit on your docs/ directory. This process enforces structured sections, verifies cross-references across core files, and outputs actionable recommendations to resolve inconsistencies and remove all placeholder content.