diagram-author

Convert bounded design surfaces into source-grounded diagram packets.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/danielbaustin/agent-design-language --skill diagram-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-author
Source: https://github.com/danielbaustin/agent-design-language/tree/main/adl/tools/skills/diagram-author
Command: npx skills add https://github.com/danielbaustin/agent-design-language --skill diagram-author

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mermaid-cli, d2, plantuml, structurizr-cli, rsvg-convert, convert, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Converts bounded design surfaces into source-grounded diagram packets to simplify architecture communication and review.

Core Features & Use Cases

  • Automatically select a diagram family (flowchart, sequence, data-flow, C4, UML, or Markdown outline) and the most suitable backend (Mermaid, D2, PlantUML, Structurizr DSL, or no-render Markdown) to express the intended message.
  • Produce a diagram packet that includes explicit assumptions, validation notes, and evidence when sources are bounded by a problem statement, code, or docs.
  • Render artifacts when requested and store the packet for later publication or review.

Quick Start

Draft the diagram packet from a bounded source by selecting a diagram family and backend.

Frequently Asked Questions about diagram-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown documentation into architecture diagrams?

To generate architecture diagrams from Markdown documentation, bound the source content so the tool can select a suitable diagram family and backend, producing a source-grounded diagram packet with validation notes and rendered artifacts.

What is the best way to generate a C4 diagram from source code?

The best way to generate a C4 diagram from source code is to bound the codebase so the tool can select the Structurizr DSL backend, producing a packet with explicit assumptions, validation notes, and evidence from the bounded source.

How do I render a Mermaid diagram from bounded design surfaces?

You can render a Mermaid diagram from bounded design surfaces by selecting Mermaid as the backend and requesting rendering, which outputs a diagram packet containing rendered artifacts alongside validation notes for review.

Does diagram-as-code work with PlantUML and D2 backends?

Yes, diagram-as-code works with PlantUML and D2 backends; the tool automatically selects either backend to suit the communication goal, producing a diagram packet with explicit assumptions and rendered artifacts when requested.

Can I use sequence diagrams for architecture communication and review?

Yes, you can use sequence diagrams for architecture communication and review by selecting the sequence diagram family, which generates a source-grounded packet that simplifies communication and includes validation notes.

When should I not use Markdown outlines for diagram generation?

You should avoid using Markdown outlines for diagram generation when a visual communication goal requires rendered artifacts, as the no-render Markdown backend produces text-based packets without visual diagram outputs.