excalidraw-skill

Automate Excalidraw canvas diagram creation and editing via MCP tools or REST API.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/Embers-of-the-Fire/agent-research-skills-opencode --skill excalidraw-skill-embers-of-the-fire
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-skill
Source: https://github.com/Embers-of-the-Fire/agent-research-skills-opencode/tree/main/.opencode/skills/excalidraw-skill
Command: npx skills add https://github.com/Embers-of-the-Fire/agent-research-skills-opencode --skill excalidraw-skill-embers-of-the-fire

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Programmatic control of Excalidraw canvases enables agents to compose, edit, and synchronize diagrams without manual UI interaction, saving time and reducing error.

Core Features & Use Cases

  • Live canvas automation: create, modify, align, group, and CRUD diagram elements via MCP tools or REST endpoints.
  • Iterative refinement: describe_scene and get_canvas_screenshot to validate progress and guide improvements.
  • Export/import: save/load .excalidraw files and export to PNG/SVG, or convert Mermaid diagrams to Excalidraw.

Quick Start

Start by connecting to a running Excalidraw canvas server and run through an iterative workflow to draw, refine, and export diagrams.

Frequently Asked Questions about excalidraw-skill

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

FAQPage Schema
How do I automate Excalidraw diagram creation without manual UI interaction?

Automate Excalidraw diagram creation by using MCP tools or REST API endpoints to programmatically compose, edit, and synchronize canvas elements without manual UI interaction. Connect to a running Excalidraw canvas server to create, modify, and align diagram elements automatically.

Can I convert Mermaid diagrams to Excalidraw format?

Convert Mermaid diagrams to Excalidraw format using the export and import capabilities provided by the MCP tools. Connect to a running canvas server and trigger the conversion to translate Mermaid syntax into editable Excalidraw elements.

How do I validate iterative changes to a live Excalidraw canvas?

Validate iterative changes to a live Excalidraw canvas by using describe_scene and get_canvas_screenshot to check progress and guide improvements. These tools provide deterministic feedback on diagram elements to support refinement.

Do I need a running server to automate Excalidraw canvas editing via MCP?

You need a running Excalidraw canvas server to automate canvas editing via MCP tools. Set the EXPRESS_SERVER_URL environment variable, which defaults to http://localhost:3000, to establish the connection required for programmatic control.

What is the best way to export Excalidraw diagrams to PNG or SVG?

Export Excalidraw diagrams to PNG or SVG by using the REST API endpoints or MCP tools to save and convert .excalidraw files. This enables automated export workflows without interacting with the graphical interface.

What are the limitations of automating diagrams with MCP and REST APIs?

Limitations of automating Excalidraw diagrams with MCP and REST APIs include the absolute requirement for a running canvas server and network connectivity. Diagram automation depends on the EXPRESS_SERVER_URL being accessible and cannot operate offline.