Open-source project
cathrynlavery/diagram-design avatar
cathrynlavery/diagram-design

diagram-design: an agent skill that writes each diagram as one HTML + SVG file, with a different install and update path for every host

29 editorial diagram types for Claude Code. Self-contained HTML + SVG. No shadows, no Mermaid-slop.

67,375 stars4,503 forksHTMLMIT

At a glance

What is it?
diagram-design is an MIT-licensed Agent Skill by Cathryn Lavery that turns a plain-language request into a single self-contained HTML + SVG diagram in your brand's palette. Drawing is the easy part; the real decisions are which of its many install routes to use and how each one gets updates.
Who is it for?
diagram-design suits people who already work inside Claude Code, Codex, Cursor, Copilot or another Agent Skills host and want editorial-style architecture, quadrant or sequence diagrams as standalone files that match their brand. It is a weaker fit if you need a diagram source format that teammates edit in a separate tool, since the output is generated HTML.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 3 days ago.
What is it written in?
Mainly HTML, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • cathrynlavery/diagram-design67,375 ★ · +45,862
Star history
Repository2026-08-182026-11-15
cathrynlavery/diagram-design21.5k67.4k

45,862 Stars in the last 89 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

Each request produces one .html file you open by double-clicking

diagram-design is an Agent Skill, not a drawing app. You ask your agent in plain words, for example for an architecture diagram of a frontend, backend, database and Redis cache, a quadrant of Q2 projects by impact versus effort, or a sequence of a bearer call with token refresh on 401. The agent picks the diagram type, states its plan, and writes one self-contained HTML + SVG file. There is nothing to run afterwards: you open the file by double-clicking it. The style is deliberately narrow, with no shadows and an explicit rejection of what the author calls Mermaid slop. One inconsistency to know about: the README headline counts 45 diagram types, while the repository description still says 29, so the description lags the skill itself.

Brand onboarding reads your site once and styles every later diagram

The step that sets diagram-design apart from a generic diagram prompt is onboarding. Telling the agent to onboard diagram-design to your site's URL pulls your palette and fonts, so every diagram after that one matches the site. That means the skill fetches a page from the network during onboarding, and PRIVACY.md at the top of the repository spells out what the skill sends over the network. Read it before pointing the skill at an internal site. Import from draw.io, Mermaid or Excalidraw and export to PNG and SVG have their own sections, and the import and export features are tied to command surfaces that not every install route delivers, which is the main trap covered below.

The npx skills install is standalone and drops the slash commands

The universal route works on any host that reads Agent Skills, including Cursor, Claude Code, Codex, Qoder, GitHub Copilot, Gemini CLI, Cline, Windsurf and Amp:

bash
npx skills add cathrynlavery/diagram-design

The skills CLI finds skills/diagram-design/SKILL.md and copies the whole skill, including references/, assets/ and scripts/, into each host root you pick. With more than one target it recommends a symlink to a single canonical copy; --copy gives independent copies instead, and Windows without Developer Mode falls back to copies. The cost is twofold. This install does not follow marketplace updates, so you pull changes with `npx skills update diagram-design`. And it installs the Agent Skill only, so /export-diagram, /import-mermaid, /profile and /doctor stay with the native packages. Where a marketplace exists for your host, use it instead.

Claude Code leaves auto-update off for this marketplace until you enable it

In Claude Code the plugin marketplace brings updates and the slash commands:

text
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design

Claude Code disables auto-update by default for third-party marketplaces, so without one extra step you stay on the version you installed. Run /plugin, open Marketplaces, select diagram-design and choose Enable auto-update. After that, the marketplace and plugin refresh in the background after startup; run /reload-plugins when prompted, or let the next session pick up the update.

Codex, Copilot and Droid each refresh on their own schedule

Codex installs from the same repository marketplace:

bash
codex plugin marketplace add cathrynlavery/diagram-design
codex plugin add diagram-design@diagram-design

Codex refreshes Git marketplaces at startup; `codex plugin marketplace upgrade diagram-design` fetches immediately, followed by a new session. GitHub Copilot:

bash
copilot plugin marketplace add cathrynlavery/diagram-design
copilot plugin install diagram-design@diagram-design

Copilot gets the skill plus doctor, export, import and profile; confirm with `copilot skill list`. Factory Droid:

bash
droid plugin marketplace add https://github.com/cathrynlavery/diagram-design
droid plugin install diagram-design@diagram-design --scope user

Droid tracks Git plugins by commit rather than by the manifest's display version, so the version string you see may not change after an update even though the code did.

Qoder IDE needs a ZIP you build yourself

Qoder installs from a local clone after validating the plugin:

bash
git clone https://github.com/cathrynlavery/diagram-design.git
qoder plugins validate ./diagram-design
qoder plugins install ./diagram-design
qoder plugins list

Qoder reads the canonical skills/diagram-design/ tree and the shared command definitions, so no Qoder-specific copy exists. The Qoder IDE is more work: you build a bounded ZIP from the tracked plugin surfaces and upload it through Extensions, Plugins, Add Plugins, Upload Plugin:

bash
git -C diagram-design archive --format=zip \
  --output=../diagram-design-qoder.zip HEAD \
  .qoder-plugin commands skills LICENSE

Every update means rebuilding and re-uploading that ZIP, then starting a new task.

Switching from a standalone copy to a marketplace is a manual migration

An existing standalone npx skills add copy will not start following the Codex marketplace on its own. You remove the standalone copy, then use the Codex marketplace commands. A personal Claude Cowork copy likewise has to be uninstalled and reinstalled from your organization's marketplace. Only then do version bumps arrive through each client's native update path. Provenance matters too: official builds come only from this repository, and LittleMight, Cathryn Lavery's company, publishes the plugin directory listings; a listing under any other name is an unofficial copy. The repository has no GitHub releases, so changes are tracked in CHANGELOG.md, and the last push was on 1 November 2026.

Editorial conclusion

diagram-design suits people who already work inside Claude Code, Codex, Cursor, Copilot or another Agent Skills host and want editorial-style architecture, quadrant or sequence diagrams as standalone files that match their brand. It is a weaker fit if you need a diagram source format that teammates edit in a separate tool, since the output is generated HTML. Before installing, pick the native marketplace for your host if it has one, so you keep the export, import, profile and doctor commands, turn on auto-update where it is off by default, and read PRIVACY.md to see what the skill sends over the network.

Frequently asked questions

What is diagram design, in the diagram-design skill?

diagram-design is an MIT-licensed Agent Skill that draws diagrams as one self-contained HTML + SVG file in your brand. You describe the diagram in plain words and the agent picks the type and writes the file.

How can I create my own diagram with diagram-design?

Install it with npx skills add cathrynlavery/diagram-design or your host's marketplace, then ask your agent for a diagram, such as an architecture diagram or a quadrant. The agent writes one .html file you open by double-clicking.

How do I update diagram-design installed with npx skills?

Run npx skills update diagram-design. A standalone install does not follow marketplace updates, and it does not include the /export-diagram, /import-mermaid, /profile and /doctor commands.

Does diagram-design send anything over the network?

Brand onboarding pulls palette and fonts from the site URL you give it. PRIVACY.md in the repository lists what the skill sends over the network.

Official sources

  1. Official README
  2. Project repository
  3. README
  4. Releases
Community

Where developers are discussing it

Posts on Hacker News, dev.to and Lobsters that link to this repository, found by our scan of those communities. 1 in the last 30 days; newest first.

Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/cathrynlavery-diagram-design.svg)](https://hysenlabs.com/projects/cathrynlavery-diagram-design)

Weekly Top 10 badge

markdown
[![Hysen Labs](https://hysenlabs.com/badge/cathrynlavery-diagram-design.svg?metric=rank)](https://hysenlabs.com/projects/cathrynlavery-diagram-design)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/cathrynlavery-diagram-design.svg)](https://hysenlabs.com/projects/cathrynlavery-diagram-design)

Was this useful?