diagram-design

Designs architecture, process, and hierarchy diagrams as visual models answering specific questions.

1|Updated Sep 11, 2026
One-click install
npx skills add https://github.com/rebuildup/my-web-2026 --skill diagram-design-rebuildup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-design
Source: https://github.com/rebuildup/my-web-2026/tree/main/skills/diagram-design
Command: npx skills add https://github.com/rebuildup/my-web-2026 --skill diagram-design-rebuildup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Technical diagrams often become decorative boxes and arrows that fail to communicate anything specific. This Skill guides the design of architecture, process, flow, hierarchy, relationship, and explanatory diagrams as visual models that answer a defined question for a defined audience, with consistent node, connector, grouping, and label semantics. ## Core Features & Use Cases - Question-driven diagram design: Fix the question, audience, and purpose first, then select the right abstraction level and diagram type instead of cramming everything into one image. - Semantic consistency rules: Map each visual difference (shape, line style, color, grouping) to exactly one meaning, with explicit direction on connectors and progressive disclosure from overview to detail diagrams. - Accessibility and verification checks: Avoid color-only encoding, audit edge crossings and ambiguous arrows, and provide text alternatives for complex diagrams based on W3C WAI guidance. - Use Case: When documenting a Cloudflare Workers system for onboarding, use this Skill to split a tangled single diagram into a context overview plus focused detail diagrams with a clear legend and labeled trust boundaries. ## Quick Start Use the diagram-design skill to plan an architecture diagram for my system that answers a specific question for new team members.

Frequently Asked Questions about diagram-design

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

FAQPage Schema
How do I design an architecture diagram that people actually understand?

Start by fixing the question the diagram answers, its audience, and its purpose in one sentence. Then choose the abstraction level and diagram type from that question, assign one meaning to each visual difference, and split dense content into overview plus focused detail diagrams.

What diagram type should I use for process flows versus system architecture?

Choose the diagram type from the audience's question, not from what is easiest to draw. Process explanations suit flow-oriented diagrams with a stable dominant direction, while architecture reviews need context, container, or component levels with explicit boundaries and labeled dependencies.

Should I use Mermaid or Figma for technical diagrams?

Mermaid, Graphviz, diagrams.net, Figma, Visio, and SVG are only renderers, not the source of truth for diagram semantics. Define node, connector, grouping, and label meaning first, then pick whichever renderer fits your documentation or presentation workflow.

How do I make diagrams accessible for colorblind readers?

Never use color as the only encoding for type or status; combine it with patterns, line styles, and labels. Verify the diagram in grayscale or color-vision simulation, and provide a text alternative or long description for complex diagrams following W3C WAI guidance.

When should I split one diagram into multiple diagrams?

Split when edge crossings, unlabeled relations, or excessive detail appear, since these signal overloaded abstraction. Use progressive disclosure: a context-level overview diagram linking to focused detail diagrams rather than one image containing every subsystem and data classification.