technical-writer

Diátaxis organizes documentation into four categories: tutorials (learning-oriented), how-to guides (task-oriented), explanations (understanding-oriented), and references (information-oriented). This Skill applies Diátaxis alignment to automatically categorize and structure your API docs, README files, ADRs, and runbooks, ensuring consistency and clarity across all documentation types.

Yes. This Skill uses template-driven automation to generate complete API references from minimal spec files. Provide your OpenAPI specification and select the API Reference Template to produce properly structured documentation with authentication, error handling, and endpoint sections automatically filled in.

The Skill includes templates for README files, Architecture Decision Records (ADRs), API references, and runbooks. Each template follows Diátaxis principles and incorporates anti-pattern guidance to reduce manual drafting time while maintaining consistency, versioning support, and cross-link validation across your documentation.

Anti-patterns are structured guides that highlight common documentation mistakes and their fixes. This Skill embeds anti-pattern coverage into templates and quality checks to help you identify unclear phrasing, missing sections, and maintainability issues before publishing, resulting in clearer, more usable developer docs.

Yes. The Skill includes tooling integration for quality checks that perform cross-link validation and consistency verification across your documentation suite. This catches broken references and ensures terminology and structure remain aligned across README, API docs, runbooks, and knowledge-base articles.

The Skill supports markdown and template-driven output formats for tutorials, how-to guides, explanations, and references. It includes versioning capabilities to manage multiple documentation versions and ensures proper linking and organization as your APIs and architecture evolve.