writing

Diátaxis-aligned documentation organizes content into four types: Tutorials for learning, Guides for tasks, Explanations for concepts, and Reference for specifications. This Skill applies Diátaxis structure across Tenzir projects, ensuring each doc type serves its intended purpose and audience clearly.

Create or update docs using `/docs:write` with MDX formatting and frontmatter metadata (title and description), review changes with `/docs:review`, then publish via `/docs:pr`. This workflow ensures consistent structure and quality before content goes live.

Yes. This Skill includes a structured format for documenting integrations, applying the same Diátaxis principles and MDX formatting across third-party product documentation to maintain consistency alongside tutorials, guides, and reference material.

Use fenced code blocks with language identifiers (tql, sh, json, yaml). Adjacent code blocks merge automatically, letting you combine related snippets while keeping each language explicitly labeled for clarity and syntax highlighting.

Structure documentation across five content types: tutorials for project-based learning, guides for task-focused how-tos, explanations for conceptual understanding, reference for technical specifications, and integrations for third-party products—all unified under Diátaxis principles.

No. This Skill applies Diátaxis structure automatically, handling classification and organization. You provide content and metadata; the Skill ensures alignment with Diátaxis best practices for tutorials, guides, explanations, and reference documentation.