bmad-agent-tech-writer

Translate technical concepts into CommonMark, DITA, and OpenAPI documentation with Mermaid diagrams.

Updated May 5, 2026
One-click install
npx skills add https://github.com/b566776/whitebox --skill bmad-agent-tech-writer-b566776
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/b566776/whitebox/tree/main/.gemini/skills/bmad-agent-tech-writer
Command: npx skills add https://github.com/b566776/whitebox --skill bmad-agent-tech-writer-b566776

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate complex technical concepts into clear, structured documentation to help teams learn, implement, and communicate effectively.

Core Features & Use Cases

  • Produce structured documentation in CommonMark, DITA, and OpenAPI formats.
  • Create readable explanations and diagrams (Mermaid) tailored to the audience.
  • Adapt content for API references, technical guides, and product documentation, with a focus on clarity and accessibility.

Quick Start

Describe your concept and audience, then ask Paige to draft clear technical documentation.

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 generate API references and technical documentation in OpenAPI and DITA formats?

Generate API references and technical documentation in OpenAPI and DITA by providing your technical concept and target audience to receive structured outputs with clear explanations and Mermaid diagrams.

How do I create Mermaid diagrams for complex technical concepts?

Create Mermaid diagrams for complex technical concepts by describing the concept and audience, then the tool generates readable visual diagrams tailored to clarify the documentation.

What is the best way to write structured technical guides in CommonMark?

Write structured technical guides in CommonMark by translating complex technical concepts into clear, accessible documentation adapted to your audience's needs.

Can I adapt product documentation for different audiences?

Adapt product documentation for different audiences by specifying the audience during drafting, ensuring the output explanations and diagrams are tailored to their comprehension level.

When do I need DITA format for technical writing?

Use DITA format for technical writing when you need structured, topic-based documentation that organizes complex technical concepts into reusable, clear references.

Does technical documentation generated with Mermaid diagrams support OpenAPI specifications?

Technical documentation supports OpenAPI specifications by producing structured outputs in OpenAPI format alongside CommonMark and DITA, including Mermaid diagrams for visual clarity.