bmad-agent-tech-writer

Generate technical documentation and diagrams using CommonMark, DITA, OpenAPI, and Mermaid syntax.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/tiween/tiween --skill bmad-agent-tech-writer-tiween
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/tiween/tiween/tree/main/.agents/skills/bmad-agent-tech-writer
Command: npx skills add https://github.com/tiween/tiween --skill bmad-agent-tech-writer-tiween

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires customize.toml , and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The bmad-agent-tech-writer skill resolves the challenge of communicating complex technical information through expertly written and visualized documentation.

Core Features & Use Cases

  • Technical Writing: Transforms intricate concepts into easy-to-understand documentation.
  • Diagrams Generation: Produces visual diagrams (like flowcharts and ER diagrams) to aid understanding.
  • Document Validation: Validates documentation against industry standards.
  • Use Case: A project team facing issues documenting complex processes could utilize this skill to quickly and efficiently produce clear, detailed guides and visuals for internal use.

Quick Start

Begin by asking Paige to "generate project documentation for our latest project."

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 technical documentation for complex project processes?

To generate technical documentation, this skill transforms intricate project concepts into accessible guides using CommonMark and DITA standards. It simplifies complex explanations for various stakeholders, ensuring clear project communication.

Can I automatically generate flowcharts and ER diagrams for my project?

Yes, you can generate diagrams like flowcharts and ER diagrams using Mermaid syntax. This visualizes complex technical processes and system architectures to aid understanding for project stakeholders.

What is the best way to validate documentation against industry standards?

The best way to validate documentation is to check it against established industry standards like CommonMark, DITA, and OpenAPI. This ensures your technical writing meets strict formatting and structural compliance requirements.

Does this skill support writing API documentation using OpenAPI specifications?

Yes, this skill supports writing API documentation by utilizing OpenAPI specifications. It focuses on creating accessible documents that simplify complex technical explanations for various project stakeholders.

What's the best way to communicate complex technical information to non-technical stakeholders?

To communicate complex technical information, this skill crafts accessible documentation and visualizations like flowcharts. It transforms intricate concepts into easy-to-understand project guides using standardized tech writing formats.