excalidraw

Generate architecture diagrams on a live Excalidraw canvas via MCP tools.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/rithm84/Manor --skill excalidraw-rithm84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw
Source: https://github.com/rithm84/Manor/tree/main/.agents/skills/general/excalidraw-toolkit/excalidraw
Command: npx skills add https://github.com/rithm84/Manor --skill excalidraw-rithm84

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manually drawing architecture and data flow diagrams is slow and error-prone, and keeping them in sync with a codebase is tedious. This Skill lets an AI agent place shapes, arrows, and annotations on a live Excalidraw canvas through MCP tools, producing accurate diagrams directly from components, sample mockups, or textual descriptions. ## Core Features & Use Cases - Batch Diagram Creation: Create shapes, arrows, zone backgrounds, and labels in a single batch_create_elements call with ID-based arrow binding and auto-routing. - Self-Critique Loop: Automatically snapshot, validate geometry and visuals via screenshots, fix overlaps or clipped labels, and roll back if fixes regress. - Multiple Export Formats: Export finished diagrams to PNG, SVG, editable .excalidraw JSON files, or shareable Excalidraw URLs. - Use Case: Ask the agent to trace a parameter through five architectural layers; it produces a data flow diagram with split/converge paths, a decision diamond, layer labels, and data-form annotations, then exports it as a PNG for your design doc. ## Quick Start Ask the agent to draw an architecture diagram of your system on the Excalidraw canvas, listing the components and how they connect.

Frequently Asked Questions about excalidraw

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

FAQPage Schema
How do I generate an architecture diagram with Excalidraw MCP tools?

Read the design guide with read_diagram_guide, clear the canvas and verify it is empty with a screenshot, then create all shapes and arrows in one batch_create_elements call. Finish with a self-critique pass and export to PNG or SVG if needed.

How do I convert an .excalidraw file to PNG or SVG?

Use the export_to_image tool with format set to png or svg and a target file path. You can also use export_scene to save an editable .excalidraw JSON file or export_to_excalidraw_url for a shareable link.

When should I use this skill instead of automatic codebase diagramming?

Use it when you provide specific components, a sample diagram, or a textual description of what to draw. For zero-config codebase analysis where the tool discovers structure on its own, use the auto-diagram skill instead.

Why do arrows not connect to shapes in my Excalidraw diagram?

Arrows bind by element ID, so startElementId and endElementId must reference valid shape id values created in the same batch. The MCP server auto-routes bound arrows to shape edges, so approximate x and y coordinates are acceptable.

Why are my arrow labels clipped or overlapping in the diagram?

Labeled arrows need roughly 120px of clear space, so keep at least 150px gaps between connected boxes. Run the self-critique loop, which detects clipped labels and cramped spacing via screenshots and query_elements, then widens gaps automatically.