document-with-diataxis

Installation
SKILL.md

Document with Diátaxis

Diátaxis says there are exactly four kinds of documentation, each serving a different reader need. The framework's whole power comes from keeping them separate — a page that tries to teach and give steps and list facts and explain the why serves none of those readers well.

Use this skill for two jobs:

  • Write path — produce one new page in the correct type, done right.
  • Classify path — audit, classify, and restructure an existing doc set.

The compass — the one mental model

Two questions place any content in exactly one quadrant:

Installs
2
First Seen
Jul 12, 2026
document-with-diataxis — ethan-rio/skills