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.
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a claude-codeWhat 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.mmdinto 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-code2Manually: put the files in place
~/.claude/skills/excalidraw-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/excalidraw-skill/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a codex2Manually: put the files in place
.agents/skills/excalidraw-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a cursor2Manually: put the files in place
.cursor/skills/excalidraw-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lingzhi227/agent-research-skills excalidraw-skill2Manually: put the files in place
.github/skills/excalidraw-skill/SKILL.md1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/excalidraw-skillManually: put the files in place
.devin/skills/excalidraw-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill excalidraw-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.