What problem does it solve? Documentation often blurs tutorials, how-tos, and reference material into conceptual writing, producing pages that fail readers who want context and understanding rather than steps. This Skill enforces the Diátaxis explanation mode so conceptual docs stay discursive, bounded, and opinionated. ## Core Features & Use Cases - Mode classification: Distinguishes explanation from tutorials, how-to guides, and reference material before writing begins. - Structure and voice guidance: Provides opening, body, and closing patterns plus a discursive language table (why, however, some prefer) that keeps imperative instruction out. - Publish checklist: A 12-point author checklist gates publication, covering bounded scope, context, connections, alternatives, and reflection-oriented writing. - Use Case: When asked to write an "About retrieval-augmented generation" page, the Skill produces a discussion of why RAG exists, its trade-offs, and alternatives, while linking out to tutorials and reference instead of absorbing them. ## Quick Start Ask the AI to write or review an explanation document about a specific topic, such as "write an explanation about why we chunk documents in RAG".
