excalidraw-skill

Create and edit Excalidraw diagrams on a live canvas via MCP tools.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/lifeodyssey/opencode-team-config --skill excalidraw-skill-lifeodyssey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-skill
Source: https://github.com/lifeodyssey/opencode-team-config/tree/main/skills/excalidraw-skill
Command: npx skills add https://github.com/lifeodyssey/opencode-team-config --skill excalidraw-skill-lifeodyssey

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Programmatic diagram creation and editing on a live Excalidraw canvas via MCP tools enables agents to visualize, plan, and refine diagrams without manual drawing, improving speed and consistency.

Core Features & Use Cases

  • Live canvas synchronization with describe_scene and get_canvas_screenshot for iterative refinement.
  • Export/import of .excalidraw files and PNG/SVG images, plus canvas snapshots and Mermaid-to-Excalidraw conversion.
  • Element-level CRUD, alignment, distribution, grouping, duplication, and locking to maintain precise diagram layouts.
  • Supports MCP tools for automated diagram tasks and REST API fallback for broader interoperability.

Quick Start

Start the Excalidraw canvas server and connect your agent to draw a diagram, then iteratively refine it using describe_scene and capture screenshots.

Frequently Asked Questions about excalidraw-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate diagram creation on a live Excalidraw canvas?

You can automate diagram creation on a live Excalidraw canvas by using MCP tools or REST APIs to perform element-level CRUD operations, automatically syncing and generating diagrams without manual drawing.

Can I convert Mermaid diagrams to Excalidraw?

Yes, you can convert Mermaid diagrams to Excalidraw format. The skill includes a conversion feature that transforms Mermaid syntax into editable Excalidraw canvas elements.

How does an agent iteratively refine a diagram on a live canvas?

An agent iteratively refines a live canvas diagram by using the describe_scene and get_canvas_screenshot functions to understand the current layout and programmatically apply alignment, grouping, and updates.

Do I need a running server to use MCP tools for Excalidraw automation?

Yes, programmatic Excalidraw automation requires a running canvas server. You need to set the EXPRESS_SERVER_URL environment variable, which defaults to http://localhost:3000, to connect your agent.

What export formats are supported for Excalidraw diagrams?

Excalidraw diagrams support export and import of native .excalidraw files, as well as PNG and SVG image formats, allowing you to save and share canvas snapshots programmatically.

Can I manage element alignment and grouping in Excalidraw programmatically?

Yes, you can manage element alignment, distribution, grouping, duplication, and locking programmatically through MCP tools or REST APIs to maintain precise diagram layouts on the canvas.