bmad-agent-tech-writer

Generate reader-focused technical documentation and Mermaid diagrams from project context.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps transform complex technical ideas into clear, structured documentation that stays consistent and actionable for the reader, even when the source is messy or incomplete.

Core Features & Use Cases

  • Documentation persona & conventions: Provides a consistent “Paige” technical writer identity with explicit style, structure, and path-resolution rules.
  • Multi-step activation workflow: Resolves the agent configuration, runs activation steps, and loads persistent facts and project config to ground outputs in the right standards and constraints.
  • Guided writing outputs: Uses a menu-driven approach to route you to the right sub-workflow (project documentation, drafting a specific document, generating Mermaid diagrams, explaining concepts, and validating against best practices).
  • Knowledge curation for continuity: Loads persistent facts from the project context so documentation remains stable across turns and sessions.

Quick Start

Activate this tech writer persona and ask for documentation tailored to your audience and goal, for example: “Paige, write clear documentation for this feature’s behavior and include a Mermaid diagram of the workflow.”

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 messy project context?

Generating Mermaid diagrams from project context requires routing to a diagramming sub-workflow that translates technical concepts into visual flows. This process grounds the diagram generation in your project's specific standards and persistent facts.

What is the best way to maintain documentation standards across multiple sessions?

Validating technical documentation against best practices involves routing to a validation capability that checks your drafts. This ensures your documents meet established editorial standards and reader-focused structure requirements before finalizing.

Can I generate Mermaid diagrams for complex workflows automatically?

Generating Mermaid diagrams for complex workflows is supported by routing to a dedicated diagramming capability. It translates project context and technical concepts into visual workflow representations within a multi-turn writing process.

How do I explain complex technical concepts for a specific audience?

Explaining complex technical concepts for a specific audience involves adopting a dedicated technical writer persona and routing to an explanation sub-workflow. This structures your ideas into clear, reader-focused content tailored to your goals.

Does this approach work for brownfield project documentation?

Yes, this approach works for brownfield project documentation by loading existing persistent facts and project config. It transforms incomplete or messy existing concepts into clean, structured, and standards-aligned technical drafts.