diagram-design: The Agent Skill That Draws Brand-Matched Diagrams in Claude Code and Codex The open-source agent skill diagram-design, which lets coding agents such as Claude Code and Codex generate brand-matched diagrams as a single self-contained HTML and SVG file, gained roughly 330 GitHub stars in a single day this week, according to the project's README. The skill installs via `npx skills add cathrynlavery/diagram-design` across hosts including Cursor, Claude Code, Codex, GitHub Copilot, Gemini CLI, Cline, Windsurf and Amp, and offers native plugin installs for Claude Code, Codex, GitHub Copilot, Factory Droid, Pi and Kiro. The README advertises 51 diagram types while the repo description says 45, a discrepancy the source could not reconcile, and the author notes the skill was not run for the article. diagram-design is an open agent skill that makes your coding agent draw diagrams as one self-contained HTML and SVG file, in your own brand colours and fonts. It gained roughly 330 GitHub stars in a single day this week. You install it with one command, ask your agent for an architecture diagram or a sequence in plain words, and get a file you can open by double-clicking. The repo's tagline is blunt: no shadows, no Mermaid slop. This post covers what the skill does, how to install it in Claude Code, Codex, Cursor and other hosts, how its import and export commands work, and what to verify before you trust it. All details come from the project README https://github.com/cathrynlavery/diagram-design?ref=explainx . We did not run the skill ourselves for this article, so behaviour described here is the README's account of it. What diagram-design does The README describes an agent skill that draws diagrams as one self-contained HTML plus SVG file, in your brand. You can ask for things like: - "Make me an architecture diagram of my app: frontend, backend, database, Redis cache." - "I need a quadrant showing Q2 projects by impact vs effort." - "Give me a sequence of a bearer call with token refresh on 401." - "Onboard diagram-design to https://yoursite.com https://yoursite.com/?ref=explainx ", which pulls your palette and fonts so later diagrams match your site. The agent picks the type, states its plan, and writes one .html file. The README headline says 51 diagram types, while the repo description says 45; we could not reconcile the two, so check the gallery for the current list. The reference folder lists type files for architecture, data flow, database schema, ER, flowchart, Gantt, heatmap, kanban, Sankey, sequence, state, swimlane, timeline, UML class and many more. If you have read our explainer on Mermaid slop https://explainx.ai/blog/what-is-mermaid-slop-ai-diagram-explained-2026 , the pitch will sound familiar. Generic auto-laid-out AI diagrams look the same everywhere. diagram-design answers that with a design system: a 4px grid, a single style guide as the source of truth for colours and fonts, per-type layout budgets, and primitives for nodes, arrows and labels. Install in one command The cross-agent route works with any host that reads Agent Skills, which the README lists as Cursor, Claude Code, Codex, Qoder, GitHub Copilot, Gemini CLI, Cline, Windsurf and Amp: npx skills add cathrynlavery/diagram-design The skills CLI finds skills/diagram-design/SKILL.md and installs the whole skill, including references, assets and scripts, into each host you select. If your selection resolves to more than one skills folder, it asks for an install method and recommends symlinks so one update reaches every tool. Pass --copy for independent copies. This standalone install does not follow marketplace updates; run npx skills update diagram-design to pull them. Native installs give you the slash commands too: | Host | Install command per README | |---|---| | Claude Code | /plugin marketplace add cathrynlavery/diagram-design , then /plugin install diagram-design@diagram-design | | Codex | codex plugin marketplace add cathrynlavery/diagram-design , then codex plugin add diagram-design@diagram-design | | GitHub Copilot | copilot plugin marketplace add cathrynlavery/diagram-design , then copilot plugin install diagram-design@diagram-design | | Factory Droid | droid plugin marketplace add https://github.com/cathrynlavery/diagram-design , then droid plugin install diagram-design@diagram-design --scope user | | Pi | pi install https://github.com/cathrynlavery/diagram-design , then /reload | | Kiro | Import the skill from the repo's skills/diagram-design subdirectory URL | Two practical notes. In Claude Code, third-party marketplaces have auto-update off by default; the README says to run /plugin , open Marketplaces, select diagram-design and enable auto-update. And the README states that official builds come only from this repository: listings under any other name are unofficial copies. That matters because agent skills run with your agent's permissions. For another recent example of an agent-tool repo with a multi-host installer, see our report on the app-store-compliance guard https://explainx.ai/blog/app-store-compliance-playbook-pre-submission-guard-claude-code-github-trending-2026 . Match your brand once, reuse it everywhere Onboarding is the feature that separates this from a one-off prompt. You give the skill a URL and it extracts the palette and fonts into a style guide. If the project has no style guide yet, the skill asks whether to run onboarding, paste tokens manually or proceed with the default, per the README. For agencies and freelancers, there are named profiles. You onboard a brand once, save it as a profile, then add a .diagram-design marker file containing profile: