diagram-design

Generate branded architecture, flowchart, and data diagrams as self-contained HTML/SVG files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Creating consistent, well-designed technical diagrams by hand is slow and often produces generic-looking output. This Skill generates editorial-quality diagrams as self-contained HTML files with inline SVG, enforcing a coherent design system, layout rules, and complexity budgets across 41 visual types. ## Core Features & Use Cases - 41 Visual Types: Architecture, flowchart, sequence, state machine, ER, timeline, swimlane, quadrant, radar, Sankey, Wardley map, Gantt, kanban, user journey, UML class, database schema, and more, each with a dedicated layout reference. - Skinnable Design System: Semantic color roles, typography ramp, and brand profiles that can be customized from a website URL, local design system, or pasted tokens, with saved client profiles. - Import & Export: Import .drawio, .excalidraw, and Mermaid files via deterministic extraction scripts, and export diagrams to PNG or SVG with verification tooling. - Use Case: Ask for an architecture diagram of your content platform and receive a branded HTML/SVG file with orthogonal connectors, masked arrow labels, a legend strip, and an accessibility-ready SVG structure. ## Quick Start Ask the assistant to create an architecture diagram of your system as a branded HTML/SVG file using the diagram-design skill.

Frequently Asked Questions about diagram-design

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

FAQPage Schema
How do I create an architecture diagram as HTML/SVG?

Describe your system components and connections, and the skill generates a self-contained HTML file with inline SVG following its design system. It applies orthogonal rounded connectors, masked arrow labels, a legend strip, and a complexity budget of up to 9 nodes and 12 arrows.

What diagram types does diagram-design support?

It supports 41 visual types including architecture, flowchart, sequence, state machine, ER, timeline, swimlane, quadrant, radar, treemap, heatmap, Gantt, Sankey, fishbone, Wardley map, kanban, user journey, deployment, UML class, and database schema diagrams.

Can I import drawio or excalidraw files into branded diagrams?

Yes, the skill supports .drawio and .excalidraw import. A Python extraction script decodes drawio XML, deflate payloads, and PNG/SVG-embedded mxfile data into a normalized intermediate representation that guides type selection and layout.

How do I apply my own brand colors to generated diagrams?

The design system is skinnable through semantic color roles defined in a style guide reference. On first use in a project, the skill offers to customize from a website URL, a local design system folder, pasted tokens, or a saved named profile.

When should I not use a diagram and use a table instead?

The skill explicitly recommends against drawing when a table, bulleted list, or short paragraph communicates the same information. Quick unicode diagrams, simple before/after comparisons, and single-shape visuals are listed as cases to avoid.

What are the complexity limits for generated diagrams?

Each diagram type has a budget: general diagrams allow up to 9 nodes and 12 arrows, sequence diagrams up to 5 lifelines, ER up to 8 entities, and scatter plots up to 30 points. Exceeding a budget means splitting into an overview plus a detail diagram.