Skip to main content
skill CX Codex

excalidraw-skill · lingzhi227 — Claude Code skill: draw Excalidraw diagrams from an agent

A skill that connects an agent to a live Excalidraw canvas so it can draw, adjust and export diagrams.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a claude-code
Open on GitHub

What excalidraw-skill does

The skill hands the agent a set of canvas operations: add elements in batches, move and resize them, align, group, duplicate, lock. It can look at the result through a scene description or a screenshot, which makes iterative redrawing practical instead of guessing.

On start it checks what is available: MCP tools first, then the health endpoint at http://localhost:3000. If neither responds, the skill walks through setting up the canvas server by hand. Diagrams can be imported from Mermaid, and files come in .excalidraw, PNG and SVG. Named snapshots let you roll the canvas back.

A canvas server has to be running, addressed through EXPRESS_SERVER_URL, which defaults to http://localhost:3000. Image export and screenshots need an open browser, and a few tools — screenshots, viewport control, the diagram guide, export to an Excalidraw URL — are MCP-only. In pure REST mode those calls have no equivalent.

What it helps with

  • draw a service diagram on a live canvas
  • fix a layout from a screenshot instead of blind edits
  • turn a Mermaid chart into editable Excalidraw elements
  • export a diagram as PNG or SVG
  • save a named snapshot and restore it later

Example prompts for the agent

  • Draw a three-service diagram with a database on the canvas, then send me a screenshot
  • Convert the Mermaid file flow.mmd into Excalidraw elements
  • Save the canvas as a snapshot called before-refactor

How to install excalidraw-skill

1Skills CLI (Vercel)

npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/excalidraw-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/excalidraw-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about excalidraw-skill

How do I install excalidraw-skill in Claude Code?

Run npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a claude-code, then check that ~/.claude/skills/excalidraw-skill/SKILL.md exists.

What does excalidraw-skill do?

It gives the agent element-level control over an Excalidraw diagram — create, update, delete, align, group — plus snapshots, Mermaid import and export to files or images.

What has to be running for the skill to work?

A canvas server, with its address passed in EXPRESS_SERVER_URL (default http://localhost:3000). Screenshots and image export need a browser window open, and get_canvas_screenshot, read_diagram_guide and export_to_excalidraw_url exist only as MCP tools.

Similar skills

All skills for Agent setup: memory, context, orchestration →

excalidraw-skill by other authors comes first.

From the same set31

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor