Back to search
excalidraw-skill
MCP serverGitHub
Excalidraw diagramming skill for Claude Code — 10 visual techniques, layout best practices, self-correcting diagrams via MCP
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/robonuggets--excalidraw-skill)HTML
<a href="/listings/robonuggets--excalidraw-skill"><img src="/api/listings/robonuggets--excalidraw-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
claude skill add --url https://raw.githubusercontent.com/robonuggets/excalidraw-skill/main/.claude/skills/excalidraw/SKILL.md
Or manually: copy `.claude/skills/excalidraw/SKILL.md` into your project's `.claude/skills/excalidraw/` folder.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 82 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Excalidraw Skill for Claude Code
- Turn text descriptions into professional diagrams on a live Excalidraw canvas. Your AI agent draws, screenshots its own work, and iterates until it looks right.
- ## What You Get
- - **10 visual techniques** -- glow effects, color-coded zones, bound arrows, decision nodes, font hierarchy, semantic colors, and more
- - **Self-correcting diagrams** -- the agent sees its own canvas via screenshots and fixes issues automatically
- - **Layout best practices** -- spacing rules, arrow routing, zone labels that actually work
- - **Quality checklist** -- catches truncation, overlap, and bad arrows before you export
- - **Multiple exports** -- PNG, SVG, .excalidraw (re-editable), or shareable URL
- ## Prerequisites
- You need the Excalidraw MCP server installed and running.
- ### 1. Clone and build the MCP server
- ```bash
- git clone https://github.com/yctimlin/mcp_excalidraw && cd mcp_excalidraw
- npm ci && npm run build
- ```
- ### 2. Add to Claude Code
- ```bash
- claude mcp add excalidraw -s user \
- -e EXPRESS_SERVER_URL=http://localhost:3000 \
- -- node /absolute/path/to/mcp_excalidraw/dist/index.js
- ```
- Replace `/absolute/path/to/` with wherever you cloned the repo.
- ### 3. Start the canvas
- ```bash
- cd /path/to/mcp_excalidraw
- PORT=3000 npm run canvas
- ```
- Open `http://localhost:3000` in your browser to see the live canvas.
- ## Install the Skill
- ```bash
- claude skill add --url https://raw.githubusercontent.com/robonuggets/excalidraw-skill/main/.claude/skills/excalidraw/SKILL.md
- ```
- Or manually: copy `.claude/skills/excalidraw/SKILL.md` into your project's `.claude/skills/excalidraw/` folder.
- ## Try It
- Once the MCP server is running and the skill is installed:
- - "Draw an architecture diagram for a web app with a load balancer, two servers, and a database"
- - "Create a flowchart showing user authentication with success and failure paths"
- - "Make a comparison diagram: monolith vs microservices"
- ## Visual Techniques Included
- | # | Technique | What It Does |
- |---|-----------|-------------|
- | 1 | Layered Glow | Stacked rectangles at decreasing opacity for depth |
- | 2 | Color-Coded Zones | Background rectangles grouping related elements |
- | 3 | Bound Arrows | Arrows that snap to shapes and auto-route |
- | 4 | Line Style Meaning | Solid = sync, dashed = async, dotted = optional |
- | 5 | Diamond Decisions | Flowchart branching with Yes/No paths |
- | 6 | Mixed Shapes | Ellipse = actor, rectangle = service, diamond = decision |
- | 7 | Font Hierarchy | 28px title, 20px section, 16px body, 14px notes |
- | 8 | Semantic Colors | 7-color palette with consistent meaning |
- | 9 | Mermaid Conversion | Convert Mermaid syntax to editable Excalidraw |
- | 10 | Screenshot Loop | Agent sees and fixes its own work |
- ## Known Limitations
- - **Images**: Can't be added via MCP -- drag them into the browser manually
- - **Freedraw**: Draw freehand in the browser, not via MCP
- - **SVG import**: Use the browser's native paste feature
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.