bmad-agent-tech-writer

Create structured technical documentation in CommonMark, DITA, OpenAPI, and Mermaid formats.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/clovernguyen1010-ship-it/Clover_Nguyen --skill bmad-agent-tech-writer-clovernguyen1010-ship-it
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/clovernguyen1010-ship-it/Clover_Nguyen/tree/main/_bmad/bmm/1-analysis/bmad-agent-tech-writer
Command: npx skills add https://github.com/clovernguyen1010-ship-it/Clover_Nguyen --skill bmad-agent-tech-writer-clovernguyen1010-ship-it

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Technical Documentation Specialist transforms complex concepts into accessible, structured documentation, reducing confusion and speeding onboarding.

Core Features & Use Cases

  • Create clear, audience-appropriate documentation in CommonMark, DITA, and OpenAPI formats.
  • Produce diagrams and visuals (Mermaid) that complement explanations.
  • Act as a patient educator, adapting explanations to the audience's needs and context.

Quick Start

Provide a concise, structured technical document for a given concept by initiating a guided, multi-turn drafting process.

Frequently Asked Questions about bmad-agent-tech-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create technical documentation from complex concepts?

To create technical documentation from complex concepts, you use a guided multi-turn drafting process that transforms intricate ideas into clear, structured text, reducing confusion and accelerating onboarding.

Can I generate OpenAPI specifications and Mermaid diagrams together?

Yes, you can generate OpenAPI specifications alongside Mermaid diagrams. It produces visuals that complement your text explanations, ensuring quality and consistency across formats.

What is the best way to structure DITA documentation for audience needs?

The best way to structure DITA documentation is through a patient educator approach that adapts explanations to your audience's specific context, ensuring the content is clear and accessible.

Does this approach support CommonMark formatting for technical writing?

Yes, this approach supports CommonMark formatting for technical writing. It creates clear, audience-appropriate documentation across multiple formats including CommonMark, DITA, and OpenAPI.

When do I need Mermaid diagrams in technical documentation?

You need Mermaid diagrams in technical documentation when you must visually complement explanations of complex concepts. Diagrams ensure quality and consistency by making structured information easier to understand.