diagram-design-editorial — Claude Code skill: 13 diagram types
A skill that turns a short description into an HTML+SVG diagram for posts and docs. Thirteen types, no Mermaid, no build step, styling matched to your site.
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a claude-codeWhat diagram-design-editorial does
The skill covers thirteen diagram types: architecture, flowchart, sequence, state machine, ER model, timeline, swimlane, quadrant, nested, tree, layer stack, Venn and pyramid/funnel. Describe what you want and Claude picks a type, writes the HTML and saves the file. Two starting points ship with it: assets/template.html for a minimal light diagram and assets/template-full.html when you want summary cards alongside it.
Output is self-contained HTML plus SVG, so nothing has to be compiled and no charting library gets pulled in. The design rules are strict. Every coordinate, width and gap is a multiple of 4px, shadows are out, corner radius stays at 10px or less, and borders are 1px hairlines. Three font families split the work: Instrument Serif for titles, Geist Sans for node labels, Geist Mono for ports, URLs and field types. One accent colour per diagram, used on one or two focal nodes.
Out of the box the palette is neutral — warm paper, charcoal ink, rust accent. To match your own site, run onboarding: the skill fetches the homepage, pulls the palette and font stack, maps them onto paper, ink, muted, accent and link, then runs WCAG AA contrast checks. You can also edit references/style-guide.md by hand. On first use in a new project, if that file still holds the defaults, Claude stops and asks whether to run onboarding, paste tokens manually, or keep the defaults.
What it helps with
- sketch a service architecture with a database and cache
- walk through the OAuth 2.0 handshake step by step
- place projects on an impact-versus-effort quadrant
- map an order lifecycle from payment to delivery
- lay out an ER model with fields and relations
Example prompts for the agent
- I need a sequence diagram of the OAuth 2.0 handshake.
- Onboard diagram-design to https://yoursite.com.
How to install diagram-design-editorial
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a claude-code2Manually: put the files in place
~/.claude/skills/diagram-design-editorial/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/diagram-design-editorial/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a codex2Manually: put the files in place
.agents/skills/diagram-design-editorial/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a cursor2Manually: put the files in place
.cursor/skills/diagram-design-editorial/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills diagram-design-editorial2Manually: put the files in place
.github/skills/diagram-design-editorial/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/diagram-design-editorialManually: put the files in place
.devin/skills/diagram-design-editorial/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about diagram-design-editorial
How do I install diagram-design-editorial in Claude Code?
Run npx skills add reason-machines/trending-skills --skill diagram-design-editorial -a claude-code. The skill then lives at ~/.claude/skills/diagram-design-editorial/SKILL.md.
What does diagram-design-editorial do?
It generates thirteen kinds of diagram as self-contained HTML and SVG for blog posts and documentation. Claude chooses the type from your description, and the look can be matched to your site.
What does it take to match my site's styling?
Run onboarding: the skill reads your homepage, extracts the palette and fonts, checks contrast, and writes the tokens to references/style-guide.md. Skip it and diagrams come out in the neutral default palette.