PluginInstalls cleanly
Draw clean diagrams as web pages
Diagram Design
A skill that turns a plain request into a tidy diagram, like a flowchart, timeline or org chart, saved as one HTML file you open in your web browser.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Graphic designers, Daily work and research
What it does
A diagram is a picture that shows how parts connect: steps in a process, people in a team, or events on a timeline. Diagram Design is a skill (an instruction file) that teaches your assistant to draw these neatly, with a clean, editorial look (the README's own word), and in your brand if you want. Version 2.6.110 came out on 16 October 2026.
You describe what you want in normal words. The assistant chooses a fitting type, such as a flowchart, timeline, org chart, quadrant, funnel or Gantt chart. It tells you its plan and saves one .html file. You double-click that file to open it in your browser. After it draws a diagram, the skill runs a small local Python script (scripts/self_check.py) to check the file, so Python 3 must be on your computer.
In Claude Code, the plugin adds extra commands. They export a diagram as a PNG or SVG image, import a Mermaid, draw.io or Excalidraw drawing and redraw it, save a brand profile, or check your setup. In Codex there are no slash commands: ask in plain words instead, for example "Export this diagram as a PNG". The npx install also gives you the skill only.
Read this first. Six of the Claude Code commands (export-diagram, import-drawio, import-excalidraw, import-mermaid, profile and doctor) list plain Bash in their allowed-tools. While one of these commands runs, any shell command runs without a permission prompt. The doctor command says it is read-only, but that is only an instruction to the assistant; it can still run any shell command. Read what the assistant does while these commands run.
What it writes and sends:
- Files. The .html diagram, and .svg or .png files when you export.
- Brand matching. When you ask it to match your brand, it visits the website you name with your assistant's browsing tools. It then writes your colours and fonts into the installed skill's
references/style-guide.md. A plugin update can replace that file (README). - Saved profiles. These go to
~/.diagram-design/profiles/in your home folder (PRIVACY.md). - Fonts. Diagrams load fonts from Google Fonts when you open them, and during PNG export. Google sees your IP address and browser details. Without internet, the diagram uses system fonts (PRIVACY.md).
- No telemetry. PRIVACY.md says it has no server, no accounts, no analytics and no telemetry.
PNG export needs Playwright, a tool that controls a browser, with a browser installed. The skill does not install it for you. Imports also run small Python scripts.
The npx skills add line uses a third-party installer (vercel-labs/skills). It asks which coding tools to install into; Gemini CLI is one of them. That installer sends anonymous usage data. To turn it off, set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 before you run it (skills CLI README).
Who it is for
People who want a clear process chart, timeline or team chart for a document, a slide or a web page, without a drawing program.
Example prompts
- "Make me an architecture diagram of my app: frontend, backend, database, Redis cache."
- "Draw a quadrant of our Q2 projects by impact and effort."
- "Turn this list of launch steps into a timeline."
- "Onboard diagram-design to https://yoursite.com so the diagrams match my brand."
- "Export the diagram in launch-plan.html as a PNG."
How to install
/plugin marketplace add cathrynlavery/diagram-design/plugin install diagram-design@diagram-designcodex plugin marketplace add cathrynlavery/diagram-designcodex plugin add diagram-design@diagram-designnpx skills add cathrynlavery/diagram-designHow to use it
Ask in plain words, for example: Make me an architecture diagram of my app: frontend, backend, database. The assistant picks a diagram type, says its plan and writes one .html file.
Check it works
- In Claude Code, run
/pluginand look for diagram-design in the installed list. - Ask for any small diagram. You should get one .html file that opens in your browser.
- Optional: run
/diagram-design:doctorfor a readiness check. It can run shell commands without a prompt, as described above.
Common problems
- PNG export stops — "Playwright is not available. PNG export requires an approved Playwright installation and a compatible browser to be provisioned by the host environment" — install it yourself with
pip install playwrightand thenplaywright install chromium, or export SVG only with--svg-only(references/export.md, README). - Updates do not arrive in Claude Code — no error text — auto-update is off by default for third-party marketplaces. Run
/plugin, open Marketplaces, select diagram-design and choose Enable auto-update (README). - The /export-diagram and /import-mermaid commands are missing — no error text — the npx skills install and the Codex plugin carry only the skill. Use the Claude Code marketplace install, or in Codex ask in plain words, for example "Export this diagram as a PNG" (README).
- The self-check does not run — no exact error text — the check is a Python script. Install Python 3 (SKILL.md).
What to watch out for
- Diagrams load fonts from Google Fonts when you open them (and during PNG export), so Google sees your IP address and browser details (PRIVACY.md)
- Brand matching visits the website you name with your assistant's browsing tools, and writes your brand into the skill's style-guide.md (PRIVACY.md, README)
- In Claude Code, the export, import, profile and doctor commands pre-approve any shell command while they run (allowed-tools: Bash in commands/*.md)
- It runs local Python scripts to check each diagram; PNG export also needs Playwright with a browser, which the skill will not install for you (SKILL.md, references/export.md)
- npx skills is a third-party installer (vercel-labs/skills) that sends anonymous usage data; it installs the skill only, without the slash commands (README, skills CLI README)
Licence and author
- Licence
- MIT
- Author
- Cathryn Lavery (LittleMight)
- Source code
- github.com/cathrynlavery/diagram-design
How we tested it
We installed it on an empty test computer on 18 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not run: "codex plugin marketplace add cathrynlavery/diagram-design" (not a form the sandbox runs). Not run: "codex plugin add diagram-design@diagram-design" (not a form the sandbox runs). The two Codex lines are in the Codex CLI source (release rust-v0.163.0) but not on the Codex docs page. Not yet used on real work.
Technical details of the test
- Date
- 18 Oct 2026
- Method
- Intake sandbox run on 2026-10-18 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y skills --help"; installed diagram-design@diagram-design with the Claude Code command line.
Checked again on 18 Oct 2026
Alternatives
- Frontend Design — designs whole web pages, not diagrams.
- UI/UX Pro Max — design rules for app screens, not charts and flows.
- Oil UI — explores and compares several page design directions.
FAQ
Do I need an account or API key? No. It has no server, accounts or telemetry (PRIVACY.md). The npx installer is a separate tool and does send usage data.
Does it work without internet? Yes. Diagrams fall back to system fonts if Google Fonts cannot load (PRIVACY.md).
Can I edit the diagram later? Yes. Ask the assistant to change it. The result is a normal HTML file.
Does it cost money? The README names no price. Your assistant's usage counts as normal.
Is it in Anthropic's directory? No. You install it from the author's own marketplace with the lines above.
Sources
- github.com/cathrynlavery/diagram-design
- github.com/cathrynlavery/diagram-design/blob/main/PRIVACY.md
- github.com/cathrynlavery/diagram-design/blob/main/CHANGELOG.md
- developers.openai.com/codex/plugins
- github.com/cathrynlavery/diagram-design/blob/main/skills/diagram-design/references/export.md
- github.com/cathrynlavery/diagram-design/tree/main/commands
- github.com/vercel-labs/skills