Write documentation for Tenzir projects. Use when adding or updating docs for tutorials, guides, explanations, reference, or integrations.
This skill inherits all available tools. When active, it can use any tool Claude has access to.
diataxis.mdformat.mdreferences/diataxis.mdreferences/format.mdWrite documentation for Tenzir projects following the Diátaxis framework.
Tenzir documentation uses the Diátaxis framework, which organizes content into four quadrants based on user needs:
| Section | Purpose | Reader question |
|---|---|---|
| Tutorials | Learning-oriented lessons | "I want to learn" |
| Guides | Goal-oriented how-tos | "I want to accomplish X" |
| Explanations | Understanding-oriented | "I want to understand" |
| Reference | Information-oriented | "I need facts" |
See diataxis.md for the decision tree and section guidelines.
Separately from Diátaxis, Integrations documents third-party products: "How do I use X with Tenzir?"
Organized by vendor/category: integrations/<category>/<product>.mdx
Documentation content lives at src/content/docs/ relative to the documentation root.
src/content/docs/
├── tutorials/ # Learning-oriented projects
├── guides/ # Task-oriented how-tos
├── explanations/ # Conceptual understanding
├── reference/ # Technical specifications (some auto-generated)
└── integrations/ # Third-party products by vendor
.mdx for new filestitle and descriptiontql as the language identifier for TQL code blocksSee format.md for frontmatter and code block details.
Load the prose:technical-writing skill for detailed style guidance.
/docs:write to create or update documentation/docs:review to check completeness and style/docs:pr to create a pull request