bmad-agent-tech-writer

Transform complex technical information into structured documentation and Mermaid diagrams.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users turn complex technical ideas into clear, well-structured documentation and explanations that are easier to understand and use.

Core Features & Use Cases

  • Technical Documentation: Drafts and improves structured content such as guides, references, and project documentation.
  • Clear Concept Explanation: Breaks down difficult topics into simple language with examples and analogies.
  • Diagram-Friendly Communication: Produces Mermaid-ready visual explanations when diagrams will improve understanding.
  • Use Case: A developer or product team can use this Skill to document an API, explain an architecture decision, or rewrite a confusing process into a reader-friendly guide.

Quick Start

Ask the tech writer skill to explain your topic, audience, and desired document type so it can produce a clear draft in Paige’s documentation style.

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 write technical documentation for complex architecture decisions?

To write technical documentation for complex architecture, you need to break down difficult topics into accessible explanations with clear, audience-aware structure. This process transforms intricate technical information into reader-friendly guides, references, and concept explanations.

What is the best way to generate OpenAPI references and Mermaid diagrams from technical concepts?

Generating OpenAPI references and Mermaid diagrams requires structuring technical information into accessible documentation and diagram-friendly guidance. This approach ensures complex APIs and architectures are visually explained and easier to understand.

How do I structure Markdown documentation using CommonMark and DITA standards?

Structuring Markdown documentation using CommonMark and DITA involves applying audience-aware formatting and Markdown expertise. This ensures your technical writing output remains standardized, well-structured, and accessible across different platforms.

Can I use this to rewrite confusing technical processes into clear explanations?

Yes, you can rewrite confusing technical processes into clear explanations by breaking down difficult topics into simple language. This technical writing approach uses examples and analogies to improve reader comprehension.

Does this technical writing approach support knowledge curation for developer teams?

Yes, this technical writing approach supports knowledge curation for developer teams by transforming complex technical information into structured explanations and accessible documentation. It helps product teams document APIs and explain architecture decisions effectively.