A Claude and coding-agent skill that turns a short JSON spec into animated, explorable diagrams exportable as SVG, PNG, GIF or MP4.
cathrynlavery/diagram-design
An agent skill that makes editorial diagrams as one self-contained HTML + SVG file, with 45 diagram types and brand matching.
Open-source alternative to:Figma
Lucidchart
- Stars
- 58,066
- Forks
- 3,725
- Open issues
- 47
- Last commit
- 4 days ago
What is it?
Diagram Design is an agent skill for coding agents such as Claude Code, Codex, GitHub Copilot, Cursor and Pi. You describe the diagram in plain language, and the agent picks one of 45 diagram types and writes a single HTML file containing inline SVG that opens directly in a browser, with no build step or JavaScript.
The skill applies one opinionated editorial style: a restrained accent color, 1px hairlines, no shadows, and coordinates on a 4px grid. Onboarding can read colors and fonts from your website so that every later diagram uses your brand, and it checks WCAG AA contrast before writing tokens.
The project can also redraw existing draw.io, Mermaid and Excalidraw files in this style, and export diagrams to SVG or PNG. Layout is decided by the agent rather than an automatic engine, so output can vary between runs.
Key features
- 01Produces one self-contained HTML file with inline SVG that opens in any browser.
- 02Supports 45 diagram types, including architecture, sequence, flowchart, ER, Gantt and charts.
- 03Extracts palette and fonts from a website to apply a brand across all diagrams.
- 04Redraws existing draw.io, Mermaid and Excalidraw files in the same style.
- 05Exports diagrams to SVG or PNG, with an optional offline font mode.
Use cases
- Creating architecture or sequence diagrams for a technical blog post or documentation page.
- Turning a Mermaid or draw.io diagram into a polished visual for slides.
- Keeping diagrams consistent with a company's website brand across a project.
- Producing quadrant, Venn or timeline graphics for presentations.
Quick start
- 1
Install the skill with the skills CLI
npx skills add cathrynlavery/diagram-design - 2
In Claude Code, add the plugin marketplace (optional)
/plugin marketplace add cathrynlavery/diagram-design - 3
In Claude Code, install the plugin (optional)
/plugin install diagram-design@diagram-design - 4
Ask your agent in plain words for a diagram; it writes one .html file you can open in a browser
Things to know
- Output quality depends on the model used, and the same prompt can produce different layouts.
- The output is not an editable source format, so there is no text to diff and no canvas to edit directly.
- The README says the skill's style guide can be replaced by package updates if you customize it through a managed install.
Topics
FAQ
- What is diagram-design?
- An agent skill that makes editorial diagrams as one self-contained HTML + SVG file, with 45 diagram types and brand matching. Diagram Design is an agent skill for coding agents such as Claude Code, Codex, GitHub Copilot, Cursor and Pi. You describe the diagram in plain language, and the agent picks one of 45 diagram types and writes a single HTML file containing inline SVG that opens directly in a browser, with no build step or JavaScript.
- Is diagram-design free to use? What license does it have?
- diagram-design is open source under the MIT license. Check the license terms before using it in commercial products.
- Is diagram-design still maintained?
- Actively maintained. The last commit to diagram-design was on Oct 16, 2026.
- What can I use diagram-design for?
- Creating architecture or sequence diagrams for a technical blog post or documentation page. Turning a Mermaid or draw.io diagram into a polished visual for slides. Keeping diagrams consistent with a company's website brand across a project. Producing quadrant, Venn or timeline graphics for presentations.
- How do I install diagram-design?
- Install the skill with the skills CLI: npx skills add cathrynlavery/diagram-design In Claude Code, add the plugin marketplace (optional): /plugin marketplace add cathrynlavery/diagram-design In Claude Code, install the plugin (optional): /plugin install diagram-design@diagram-design Ask your agent in plain words for a diagram; it writes one .html file you can open in a browser
- Where can I get diagram-design?
- The source code and installation instructions are on GitHub: https://github.com/cathrynlavery/diagram-design
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An agent skill that turns ideas, plans, or codebases into interactive HTML diagrams for Claude Code, Codex, Cursor and OpenCode.
Agent skills that guide coding agents to produce self-contained HTML wireframes, interactive prototypes, plans, and diagrams.
An agent skill and zero-dependency linter that makes coding agents draw hand-placed SVG diagrams in one consistent house style.
A collection of AI agent skills by Baoyu for content creation, image generation, and publishing to WeChat, X, and Weibo, for Claude Code, Codex, and similar agents.
Layout rules and templates that let AI agents export documents as PDF, PNG and editable PowerPoint.