skills.rest
ldk-hub
ldk-hubCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bmad-agent-tech-writer

Converts technical concepts into structured documentation with Markdown, DITA, and Mermaid diagrams.

Updated Apr 25, 2026
Search Tags:#documentation#mermaid#diagrams#technical-writing#api-docs#commonmark#knowledge-curation
One-click install
npx skills add https://github.com/ldk-hub/broke-shopping --skill bmad-agent-tech-writer-ldk-hub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-tech-writer
Source: https://github.com/ldk-hub/broke-shopping/tree/main/.claude/skills/bmad-agent-tech-writer
Command: npx skills add https://github.com/ldk-hub/broke-shopping --skill bmad-agent-tech-writer-ldk-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams convert complex technical concepts into clear, structured documentation and manage knowledge so both humans and AI agents can access a consistent, up-to-date reference.

Core Features & Use Cases

  • Structured docs: Transform raw technical content into well-organized Markdown or other formats (CommonMark, DITA, OpenAPI, Mermaid diagrams when useful).
  • Knowledge curation: Maintain and reconcile project knowledge, summarizing decisions, and aligning teams.
  • Adaptable persona: Tailors writing voice to different audiences and integrates with Paige persona for consistent documentation strategy.
  • Use Case: When documenting an API, generate a user-friendly guide with example sections and diagrams.

Quick Start

Describe a concise API reference for a new feature by outlining endpoints, parameters, and example responses.

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 clear API documentation from complex technical concepts?▼

To generate clear API documentation, you can transform raw technical concepts into structured Markdown or OpenAPI formats, outlining endpoints, parameters, and example responses for both human and AI reference.

Can I integrate Mermaid diagrams directly into my technical writing workflow?▼

Yes, you can integrate Mermaid diagrams into technical writing to visualize architecture and workflows, embedding them directly within CommonMark structured documentation for clearer knowledge curation.

What is the best way to curate project knowledge for both humans and AI agents?▼

The best way to curate project knowledge is to reconcile decisions and summarize technical content into structured docs, ensuring teams and AI agents access a consistent, up-to-date reference.

How do I adapt technical writing for different audiences and knowledge levels?▼

You adapt technical writing for different audiences by tailoring the writing voice to match specific reader needs, ensuring complex architectural concepts remain actionable and clear across multiple formats.

Does this approach support production-grade documentation standards like DITA and OpenAPI?▼

Yes, this approach supports production-grade documentation practices by outputting DITA and OpenAPI formats, ensuring your structured docs meet industry standards for comprehensive API references.

Related Skills

Explore More Content & Communication Skills→
herdiansahherdiansah
23

brainstorming

Transform initial concepts into detailed technical designs through guided questioning.

Community
Intermediate
williamzujkowskiwilliamzujkowski
6

Content & Documentation Generator

Generate Markdown, MDX, or HTML docs from OpenAPI specs or content briefs.

Community
Advanced
personamanagmentlayerpersonamanagmentlayer
41

openapi-expert

Design OpenAPI/Swagger specifications and generate client/server code.

Official
Advanced
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced