diagram-maker — Claude Code skill: diagrams and setup
This skill turns descriptions of concepts, architecture, and processes into SVG/HTML or Excalidraw diagrams. Use it when a visual file is clearer than prose.
npx skills add openclaw/openclaw --skill diagram-maker -a claude-codeWhat diagram-maker does
The skill extracts nodes, labels, groups, and relationships, then chooses a layout such as a sequence, layered stack, or swimlanes. It uses Excalidraw for an editable whiteboard and SVG/HTML for a standalone browser file. If the output format matters, it asks one short question.
SVG/HTML output is a single HTML file with inline CSS and SVG. It uses no external fonts, scripts, or images. The file goes to the requested path, or to ./diagram.html or ./diagram.excalidraw when no path is given. Syntax is checked when feasible. For exact Excalidraw snippets, the skill reads references/excalidraw-patterns.md; its SVG wrapper comes from references/svg-template.md.
Excalidraw output is JSON with the required fields, and labels are bound to shapes. Check the format constraints before relying on a layout: labeled shapes must be at least 120x60, and body text must be at least 16px.
What it helps with
- map services and databases in a software architecture
- show the stages of a process in a diagram
- draw a sequence of interactions
- create an editable Excalidraw whiteboard
Example prompts for the agent
- Draw the project’s service and database architecture in `./diagram.html`.
- Turn this workflow into an editable Excalidraw diagram.
- Create an SVG showing this object’s lifecycle.
How to install diagram-maker
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill diagram-maker -a claude-code2Manually: put the files in place
~/.claude/skills/diagram-maker/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/diagram-maker/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill diagram-maker -a codex2Manually: put the files in place
.agents/skills/diagram-maker/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill diagram-maker -a cursor2Manually: put the files in place
.cursor/skills/diagram-maker/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openclaw/openclaw diagram-maker2Manually: put the files in place
.github/skills/diagram-maker/SKILL.md1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill diagram-maker -a gemini-cli2Platform CLI
gemini skills install https://github.com/openclaw/openclaw --path skills/diagram-makerManually: put the files in place
.devin/skills/diagram-maker/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill diagram-maker -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set48
The whole set →Similar
Questions about diagram-maker
How do I install diagram-maker in Claude Code?
Run npx skills add openclaw/openclaw --skill diagram-maker -a claude-code. The skill file is at ~/.claude/skills/diagram-maker/SKILL.md.
What does diagram-maker do?
It creates SVG/HTML diagrams or editable Excalidraw boards from descriptions of concepts, processes, and software architecture.
When does diagram-maker use Excalidraw instead of SVG/HTML?
It chooses Excalidraw for an editable or collaborative whiteboard. For a standalone file to view in a browser, it uses SVG/HTML.
Source text
SKILL.md · MIT
---
name: diagram-maker
description: Create SVG/HTML or Excalidraw diagrams for concepts, architecture, flows, and whiteboards.
metadata: { "openclaw": { "emoji": "🧭" } }
---
# Diagram Maker
Create diagrams as artifacts, not prose. Choose one output mode:
- `clean-svg`: educational concepts, physical systems, processes, lifecycle, simple data flow.
- `architecture-svg`: software/cloud/infra topology, services, databases, queues, trust zones.
- `excalidraw`: editable hand-drawn whiteboard, flowchart, sequence, architecture sketch.
Routing
- User wants editable/collaborative: choose Excalidraw.
- User wants polished standalone browser output: choose SVG/HTML.
- Software architecture with infra components: choose architecture SVG.
- Science, product, process, concept map, physical object: choose clean SVG.
- Unsure: ask one short question only if output format matters; otherwise choose clean SVG.
Workflow
1. Extract nodes, groups, labels, and directed relationships.
2. Pick layout first: left-to-right, top-down, hub-spoke, swimlanes, layered stack, sequence.
3. Keep labels short. Prefer 5-9 main elements over dense diagrams.
4. Generate the file at the requested path, or `./diagram.html` / `./diagram.excalidraw`.
5. Verify syntax by opening/parsing when feasible.
SVG/HTML rules
- Single standalone `.html` file with inline CSS and inline SVG.
- No external fonts, JS, images, gradients, glows, decorative blobs, or remote assets.
- Use semantic colors, not rainbow sequences: neutral, input, process, storage, external, risk.
- Draw connectors before nodes so arrows sit behind boxes.
- Every connector path has `fill="none"` and a marker arrow when directed.
- Leave 24px text padding inside boxes; do not let text touch borders.
- Legend only when symbols/colors are not obvious.
SVG template
Use `references/svg-template.md` as the wrapper and replace `<!-- SVG -->`.
Excalidraw rules
- Save `.excalidraw` JSON with `type`, `version`, `source`, `elements`, and `appState`.
- Use bound text for shape labels. Do not use a nonstandard `label` property.
- Keep bound text immediately after its container in the elements array.
- Minimum labeled shape: 120x60. Minimum body text: 16px.
- Use roughness `1`, `fontFamily: 1`, and simple fills.
For exact Excalidraw element snippets, read `references/excalidraw-patterns.md`.
© openclaw · MIT · openclaw/openclaw