skills.rest
florian-trehaut
florian-trehautCOMMUNITY
Explore all skills by this author →
GitHub

bmad-agent-tech-writer

Convert complex concepts into structured Markdown, DITA, OpenAPI, and Mermaid documentation.

Updated Aug 23, 2026
Search Tags:#documentation#markdown#mermaid#knowledge-management#technical-writing#api-docs#audience-adaptation
One-click install
npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-agent-tech-writer-florian-trehaut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/florian-trehaut/bmad-global/tree/main/src/bmm-skills/1-analysis/bmad-agent-tech-writer
Command: npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-agent-tech-writer-florian-trehaut

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Paige helps transform complex technical concepts into clear, structured documentation tailored to the audience, delivering consistent writing style and diagrams when helpful.

Core Features & Use Cases

  • Structured documentation: Convert complex topics into API docs, user guides, and knowledge bases using markdown (CommonMark), DITA, OpenAPI, and Mermaid diagrams.
  • Persona-driven output: Adopt Paige's technical writer persona and integrate project workflow context to tailor content.
  • Guided collaboration: Engage in multi-turn conversations to refine scope, audience, and required diagrams or examples.

Quick Start

Describe your audience and goals to start a documentation project with Paige.

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 audiences with varying technical literacy?▼

To write technical documentation for varying audiences, this Skill applies audience-adapted tone and structure, transforming complex concepts into clear user guides and knowledge bases.

Can I generate Mermaid diagrams and CommonMark Markdown for API documentation?▼

Yes, you can generate Mermaid diagrams and CommonMark Markdown for API documentation, as the Skill explicitly supports these formats to produce structured technical docs.

What is the best way to convert complex technical concepts into a structured knowledge base?▼

The best way to convert complex concepts into a structured knowledge base is through a guided multi-turn conversation that refines scope, audience, and required diagrams before generating Markdown.

Does this technical writing assistant support DITA and OpenAPI formats?▼

Yes, this technical writing assistant supports DITA and OpenAPI formats, enabling the conversion of complex topics into structured API documentation and user guides.

How do I start a documentation project with the Paige persona?▼

To start a documentation project with the Paige persona, describe your audience and goals to initiate a multi-turn conversation that refines scope, examples, and diagrams.

Related Skills

Explore More Content & Communication Skills→
FelixBitSoulFelixBitSoul
2

brainstorming

Generate structured design options and a formal design document from vague concepts.

Community
Advanced
Yukine5377Yukine5377

bmad-agent-tech-writer

Translate complex technical concepts into structured documentation with Mermaid diagrams.

Community
Advanced
MarkusonMarkuson

bmad-agent-tech-writer

Generate structured project documentation and Mermaid diagrams within the BMad Method framework.

Community
Advanced
Cbanzaime23Cbanzaime23

bmad-agent-tech-writer

Generate structured technical documentation in Markdown, OpenAPI, and DITA formats.

Community
Advanced