bmad-agent-tech-writer

Generate audience-aware technical documentation with Mermaid diagrams and validation.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-agent-tech-writer-enigmaicon-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/BMAD-METHOD/src/bmm-skills/1-analysis/bmad-agent-tech-writer
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-agent-tech-writer-enigmaicon-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of producing readable, task-focused technical documentation when the information is complex and needs to be organized for a specific audience.

Core Features & Use Cases

  • Tech writer persona for documentation delivery: Produces explanations and documents in an accessible, structured style tailored to the reader’s needs.
  • Context-driven, standards-aware output: Loads persistent facts and project configuration so the writing aligns with your organization’s documentation conventions.
  • Guided documentation workflows: Supports a menu-driven approach to write documents, explain concepts, generate Mermaid diagrams, and validate documentation quality.

Quick Start

Invoke the skill and ask for a documentation deliverable, for example: “Write a technical guide explaining the BMad Method analysis phase for new contributors, including 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 create technical documentation for complex concepts that is easy for developers to understand?

Technical documentation for complex concepts requires audience-aware structuring to break down intricate information into clear, accessible guides. This approach ensures developer onboarding materials remain readable and task-focused without overwhelming the reader with unstructured details.

How do I generate Mermaid diagrams to explain system architecture?

Generating Mermaid diagrams to explain architecture involves translating structural concepts into visual flow representations. This visual modeling clarifies complex system relationships and data flows, making technical explanations significantly easier for readers to comprehend during knowledge curation.

What is the best way to validate documentation quality and consistency?

The best way to validate documentation quality is through a dedicated review process that checks for audience alignment, structural clarity, and technical accuracy. This validation ensures your technical writing meets organizational standards and effectively serves its intended reader base.

How do I write technical guides that align with my organization's existing documentation standards?

Writing technical guides aligned with organizational standards requires loading persistent project facts and configuration data before authoring. This context-driven approach ensures all generated documentation automatically conforms to your specific documentation conventions and established formatting rules.

Can I use a menu-driven workflow for drafting and reviewing technical content?

Yes, you can use a menu-driven workflow to guide the drafting and reviewing of technical content through structured steps. This guided process supports writing documents, explaining concepts, generating diagrams, and validating output without missing critical documentation phases.

When do I need to use a specialized tech writer persona for knowledge curation?

You need a specialized tech writer persona for knowledge curation when complex project information must be organized into structured, accessible documents. This approach is essential during phases like the BMad Method analysis to ensure technical accuracy and reader comprehension.