bmad-agent-tech-writer

Create technical documentation with Mermaid diagrams and standards validation.

1|Updated Dec 22, 2022
One-click install
npx skills add https://github.com/Rinzler78/osmosis-launcher --skill bmad-agent-tech-writer-rinzler78
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/Rinzler78/osmosis-launcher/tree/main/.agents/skills/bmad-agent-tech-writer
Command: npx skills add https://github.com/Rinzler78/osmosis-launcher --skill bmad-agent-tech-writer-rinzler78

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users create, improve, validate, and explain technical documentation in a clear, structured way. It is designed for cases where complex concepts need to be translated into accessible writing, diagrams, or standards-aligned documentation.

Core Features & Use Cases

  • Documentation authoring: Draft well-structured technical documents through guided conversation.
  • Concept explanation: Explain complex topics with examples and Mermaid diagrams when useful.
  • Documentation validation: Review documents for clarity, structure, audience fit, and standards compliance.
  • Use case: A product team can use this Skill to turn a rough technical concept into a polished document that is easier for engineers, stakeholders, or customers to understand.

Quick Start

Ask the skill to help you write, explain, validate, or diagram a technical topic in clear, audience-appropriate language.

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 from complex concepts?

To create technical documentation from complex concepts, you can use guided multi-turn clarification to draft structured documents. This process translates rough technical ideas into polished, audience-appropriate writing tailored for engineers or stakeholders.

Can I generate Mermaid diagrams to explain complex technical topics?

Yes, you can generate Mermaid diagrams to explain complex technical topics. The skill creates visual representations alongside written explanations, helping to visually map out intricate system architectures or workflows for technical teams.

How do I validate technical documentation for standards compliance?

You validate technical documentation for standards compliance by reviewing documents against established guidelines. The skill checks for clarity, structure, audience fit, and adherence to documentation standards like CommonMark, DITA, and OpenAPI workflows.

Does this technical writing skill support OpenAPI and DITA standards?

Yes, this technical writing skill supports OpenAPI and DITA standards. It adheres to documentation best practices across CommonMark, DITA, OpenAPI, and Mermaid workflows, ensuring your technical documents meet industry formatting and structural standards.

What is the best way to explain complex technical topics to non-technical stakeholders?

The best way to explain complex technical topics to non-technical stakeholders is through structured writing combined with Mermaid diagrams. This approach uses audience-appropriate language and visual aids to make rough technical concepts accessible and easy to understand.

Do I need prior documentation experience to draft structured technical documents?

No, you do not need prior documentation experience to draft structured technical documents. The skill uses multi-turn clarification to guide you through the authoring process, helping you structure content and adhere to best practices automatically.