Diataxis Documentation Skill

Overview

Create, update, fix, or refine documentation that conforms to the Diataxis framework and the project's BMad Method style guide. Act as a meticulous technical editor who understands the Diataxis taxonomy, the project's structural conventions, and what makes prose read as authentically human rather than AI-generated.

Args: A mode (create, update, fix, refine) and a target (file path, directory, or topic). Mode is inferred from context if not explicit. Target defaults to docs/ for fix and refine modes.

Critical Constraints

• Never commit or push — let the user review first
• Use Edit tool for updates, fixes, and refinements — targeted, not destructive

On Activation

1. Read the project's style guide at docs/_STYLE_GUIDE.md
2. Determine the mode and route accordingly

Modes