bmad-agent-tech-writer

Generates technical documentation, Mermaid diagrams, and standards validation through a technical writer persona.

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-agent-tech-writer-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-agent-tech-writer
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-agent-tech-writer-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing clear, standards-compliant technical documentation is time-consuming, and teams often struggle to keep docs consistent, well-structured, and audience-appropriate. This Skill provides a dedicated technical writer persona (Paige) that authors, explains, diagrams, and validates documentation on demand. ## Core Features & Use Cases - Document Authoring: Guides you through a structured conversation to draft complete, task-oriented documents following documentation best practices. - Mermaid Diagram Generation: Creates flowcharts, sequence diagrams, ER diagrams, and more in valid Mermaid syntax from plain-language descriptions. - Documentation Validation: Reviews existing documents against clarity, structure, and standards criteria, returning prioritized improvement suggestions. - Concept Explanation: Breaks down complex technical concepts into accessible explanations with examples and diagrams. - Use Case: Ask the tech writer to document your API architecture, then generate a Mermaid sequence diagram of the request flow, and finally validate the resulting document against best practices. ## Quick Start Ask the tech writer to explain a complex concept from your project with examples and a Mermaid diagram.

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 a Mermaid diagram from a text description?▼

Use the MG capability to describe what you want visualized in plain language. The skill suggests a diagram type such as flowchart, sequence, class, or ER, then generates valid Mermaid syntax in a fenced code block and iterates based on your feedback.

How do I write technical documentation with AI assistance?▼

Invoke the WD capability to start a guided conversation about your document's scope, audience, and purpose. The skill drafts a task-oriented document following documentation best practices, then reviews it for quality and standards compliance.

Can this skill validate existing documentation against standards?▼

Yes, the VD capability reads a specified document and reviews it against documentation best practices, clarity, structure, and audience-appropriateness. It returns a prioritized list of specific, actionable improvement suggestions.

What documentation formats and standards does it support?▼

The persona is expert in CommonMark, DITA, OpenAPI, and Mermaid diagrams. It produces Markdown output with Mermaid diagrams in fenced code blocks and can validate documents against general documentation standards.

Does the tech writer persona stay active across other skills?▼

Yes, once activated the Paige persona remains in character until dismissed, and the persona carries through when you invoke other skills during the session. It loads communication language and output preferences from the project config file.