excalidraw-diagram

Generate Excalidraw JSON diagram files that visualize workflows, architectures, and concepts.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/prateekgupta3991/skills --skill excalidraw-diagram-prateekgupta3991
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-diagram
Source: https://github.com/prateekgupta3991/skills/tree/main/public/excalidraw
Command: npx skills add https://github.com/prateekgupta3991/skills --skill excalidraw-diagram-prateekgupta3991

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes references (resource) components.

What problem does it solve? Creating technical diagrams that actually communicate structure and meaning is hard—most diagrams end up as labeled boxes that display information without teaching anything. This Skill guides the creation of Excalidraw JSON files that make visual arguments, with concrete evidence artifacts, multi-zoom architecture, and a mandatory render-and-validate loop. ## Core Features & Use Cases - Visual Pattern Library: Maps concepts to structural patterns (fan-out, convergence, timeline, tree, cycle) so the diagram's shape mirrors its meaning. - Evidence Artifacts: Embeds real code snippets, JSON examples, event names, and UI mockups into technical diagrams for educational value. - Section-by-Section Generation: Builds large diagrams incrementally to avoid output token limits and maintain quality. - Render & Validate Loop: Renders the JSON to PNG via a Python script and iterates on visual defects until the composition is correct. - Use Case: Ask for a diagram of a streaming protocol architecture, and receive an Excalidraw file showing real event names, connection code snippets, and a summary flow—rendered and visually verified. ## Quick Start Create an Excalidraw diagram visualizing how my application's frontend, API server, and database interact, including real request and response examples.

Frequently Asked Questions about excalidraw-diagram

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

FAQPage Schema
How do I create an Excalidraw diagram from a technical architecture description?

Describe the system or concept you want visualized, and the Skill generates a .excalidraw JSON file using visual patterns matched to each concept. For technical diagrams, it researches real specs and includes evidence artifacts like code snippets and actual event names.

How do I render an Excalidraw JSON file to PNG?

Run the render_excalidraw.py script in the references directory with uv: 'uv run python render_excalidraw.py <file.excalidraw>'. First-time setup requires 'uv sync' and 'uv run playwright install chromium' to install the headless browser.

What makes a good technical diagram versus a simple one?

Simple diagrams use abstract shapes for mental models and quick overviews. Comprehensive technical diagrams include evidence artifacts—real code snippets, JSON examples, actual API names—and operate at multiple zoom levels: summary flow, section boundaries, and detail within sections.

Can I customize the colors and brand style of generated diagrams?

Yes, all colors live in references/color-palette.md as the single source of truth. Edit that file to apply your own brand palette; the Skill reads it before generating any diagram and uses it for fills, strokes, text, and evidence artifact colors.

Why does my large Excalidraw diagram JSON get truncated?

Large diagrams exceed the model's per-response output limit when generated in one pass. The Skill avoids this by building the JSON section by section, using descriptive string IDs and namespaced seeds, then reviewing cross-section bindings before rendering.