bmad-agent-tech-writer

Structured documentation breaks complex concepts into accessible formats like CommonMark and DITA. It uses the Paige persona to clarify intricate ideas, ensuring outputs are configured for diverse audiences and multi-turn refinement.

You generate Mermaid diagrams for technical documentation by requesting them during the content creation process. This Skill integrates Mermaid diagrams directly into CommonMark or DITA outputs to visually represent complex architectures or workflows.

Yes, you can generate OpenAPI style documentation. The Skill applies the Paige persona across OpenAPI formats, producing structured API references and translating complex concepts into accessible content for diverse audiences.

The best way to refine technical documentation for different audiences is through multi-turn sessions. This Skill supports iterative conversations to tailor outputs, aligning language and document standards to specific audience needs.

Use DITA over CommonMark when you need topic-based structured documentation. This Skill supports both standards, applying DITA for modular content reuse and CommonMark for simpler, web-friendly formats across multi-turn sessions.

Yes, this Skill supports multi-turn sessions to refine output formats. You can iteratively adjust generated CommonMark, DITA, or OpenAPI content until it aligns with configured language and document standards.