documentation-diataxis

To classify technical writing against the Diataxis framework, analyze the documentation to determine if it fits the Tutorial, How-to, Reference, or Explanation categories and identify structural mismatches. This Skill evaluates alignment between declared and inferred categories.

The best way to review documentation quality is to evaluate functional and deep quality by checking accuracy, completeness, flow, and cognitive load. This Skill provides actionable recommendations to resolve structural mismatches before publication.

Yes, you can use Diataxis classification for user guides and content strategy. When reviewing a new set of user guides, this Skill applies Diataxis principles to classify each document and identify structural mismatches or quality issues.

Documentation classification identifies misaligned content by analyzing the structure and substance of the text, then comparing inferred categories against declared categories. It highlights discrepancies between what the document claims to be and its actual functional purpose.

When evaluating cognitive load in technical documentation, check the functional and deep quality for accuracy, completeness, and flow. This Skill assesses these dimensions to ensure the content aligns with user needs and provides actionable improvements.

No specific external tools are required to analyze markdown documentation with Diataxis. You provide the documentation file, such as a markdown guide, and this Skill analyzes its structure and content directly against the framework.