Diataxis Documentation Optimizer
Refines and structures markdown documentation using Diataxis principles to improve clarity, usability, and technical accuracy.
The Improve-Doc skill systematically audits existing markdown files to identify structural weaknesses and content mismatches based on the Diataxis framework. It intelligently classifies document sections into Tutorials, How-To guides, Reference material, or Explanations, highlighting specific issues such as mixed content types, missing prerequisites, or non-atomic steps. Through a guided interactive refinement loop, it helps developers refactor content, split complex sections, and ensure technical documentation meets professional standards while preserving original intent and line-for-line accuracy for skipped sections.