excalidraw-diagram — Claude Code skill: what it does and install
Generates .excalidraw JSON diagram files for technical architectures and workflows. Helps turn system specs or logic into diagrams with real data examples.
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a claude-codeWhat excalidraw-diagram does
This skill creates ready-to-use .excalidraw JSON files directly in your repository. Instead of placing vague labeled boxes on a canvas, it builds visual arguments that show real system relationships. Technical diagrams incorporate evidence artifacts such as JSON payloads, code snippets, interface mockups, and exact event names.
The skill structures diagrams across multiple zoom levels, moving from high-level pipelines down to concrete data models. All colors and styling rules depend on references/color-palette.md. You must modify that file directly if you need your diagrams to follow custom brand guidelines.
What it helps with
- render system architecture as an .excalidraw diagram
- map protocol event sequences using real payload examples
- diagram data transformation pipelines with input and output schemas
- document API integration flows with actual code snippets
Example prompts for the agent
- Generate an Excalidraw diagram of our auth flow showing exact token payloads
- Create an .excalidraw file explaining the event streaming pipeline
- Build an architecture diagram for the backend services with API response examples
How to install excalidraw-diagram
1Skills CLI (Vercel)
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a claude-code2Manually: put the files in place
~/.claude/skills/excalidraw-diagram/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/excalidraw-diagram/
1Skills CLI (Vercel)
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a codex2Manually: put the files in place
.agents/skills/excalidraw-diagram/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a cursor2Manually: put the files in place
.cursor/skills/excalidraw-diagram/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install coleam00/excalidraw-diagram-skill excalidraw-diagram2Manually: put the files in place
.github/skills/excalidraw-diagram/SKILL.md1Skills CLI (Vercel)
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a gemini-cli2Platform CLI
gemini skills install https://github.com/coleam00/excalidraw-diagram-skillManually: put the files in place
.devin/skills/excalidraw-diagram/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Similar
Questions about excalidraw-diagram
How to install excalidraw-diagram in Claude Code?
Run npx skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram -a claude-code in your terminal.
What does excalidraw-diagram do?
It generates .excalidraw JSON files depicting technical architectures, workflows, and concepts. It uses real code snippets, concrete data samples, and structural groupings instead of generic placeholder boxes.
Where are diagram colors and styles configured?
All styling resides in references/color-palette.md. The skill inspects this reference file before drawing, making it the single configuration point for custom themes.