bmad-agent-tech-writer

The Skill transforms complex concepts into structured technical documentation by applying audience-appropriate conventions, generating Markdown or DITA outputs with Mermaid diagrams and OpenAPI API references when relevant.

The best way is using a persona-driven approach that asks clarifying questions to define scope, then drafts reader-friendly Markdown or DITA documentation tailored to your audience and task.

Yes, you can draft API documentation aligned with OpenAPI standards. The Skill generates API references and examples alongside structured text, ensuring outputs follow conventions for new APIs or product features.

Yes, it supports generating Mermaid diagrams. The Skill incorporates Mermaid diagrams directly into structured technical documentation to make complex concepts visually accessible for readers.

Start by asking clarifying questions to define the scope and audience for your product feature, then the Skill drafts the initial structured documentation with appropriate diagrams and examples.

You need DITA format when technical writing requires structured topic-based authoring, whereas standard Markdown suits simpler reader-friendly docs; this Skill outputs both based on your audience requirements.