Skip to content
Back to search

excalidraw-skill

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/robonuggets--excalidraw-skill/badge.svg)](/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)

  1. # Excalidraw Skill for Claude Code
  2. 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.
  3. ## What You Get
  4. - **10 visual techniques** -- glow effects, color-coded zones, bound arrows, decision nodes, font hierarchy, semantic colors, and more
  5. - **Self-correcting diagrams** -- the agent sees its own canvas via screenshots and fixes issues automatically
  6. - **Layout best practices** -- spacing rules, arrow routing, zone labels that actually work
  7. - **Quality checklist** -- catches truncation, overlap, and bad arrows before you export
  8. - **Multiple exports** -- PNG, SVG, .excalidraw (re-editable), or shareable URL
  9. ## Prerequisites
  10. You need the Excalidraw MCP server installed and running.
  11. ### 1. Clone and build the MCP server
  12. ```bash
  13. git clone https://github.com/yctimlin/mcp_excalidraw && cd mcp_excalidraw
  14. npm ci && npm run build
  15. ```
  16. ### 2. Add to Claude Code
  17. ```bash
  18. claude mcp add excalidraw -s user \
  19. -e EXPRESS_SERVER_URL=http://localhost:3000 \
  20. -- node /absolute/path/to/mcp_excalidraw/dist/index.js
  21. ```
  22. Replace `/absolute/path/to/` with wherever you cloned the repo.
  23. ### 3. Start the canvas
  24. ```bash
  25. cd /path/to/mcp_excalidraw
  26. PORT=3000 npm run canvas
  27. ```
  28. Open `http://localhost:3000` in your browser to see the live canvas.
  29. ## Install the Skill
  30. ```bash
  31. claude skill add --url https://raw.githubusercontent.com/robonuggets/excalidraw-skill/main/.claude/skills/excalidraw/SKILL.md
  32. ```
  33. Or manually: copy `.claude/skills/excalidraw/SKILL.md` into your project's `.claude/skills/excalidraw/` folder.
  34. ## Try It
  35. Once the MCP server is running and the skill is installed:
  36. - "Draw an architecture diagram for a web app with a load balancer, two servers, and a database"
  37. - "Create a flowchart showing user authentication with success and failure paths"
  38. - "Make a comparison diagram: monolith vs microservices"
  39. ## Visual Techniques Included
  40. | # | Technique | What It Does |
  41. |---|-----------|-------------|
  42. | 1 | Layered Glow | Stacked rectangles at decreasing opacity for depth |
  43. | 2 | Color-Coded Zones | Background rectangles grouping related elements |
  44. | 3 | Bound Arrows | Arrows that snap to shapes and auto-route |
  45. | 4 | Line Style Meaning | Solid = sync, dashed = async, dotted = optional |
  46. | 5 | Diamond Decisions | Flowchart branching with Yes/No paths |
  47. | 6 | Mixed Shapes | Ellipse = actor, rectangle = service, diamond = decision |
  48. | 7 | Font Hierarchy | 28px title, 20px section, 16px body, 14px notes |
  49. | 8 | Semantic Colors | 7-color palette with consistent meaning |
  50. | 9 | Mermaid Conversion | Convert Mermaid syntax to editable Excalidraw |
  51. | 10 | Screenshot Loop | Agent sees and fixes its own work |
  52. ## Known Limitations
  53. - **Images**: Can't be added via MCP -- drag them into the browser manually
  54. - **Freedraw**: Draw freehand in the browser, not via MCP
  55. - **SVG import**: Use the browser's native paste feature
  56. ## License
  57. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.