excalidraw-diagram

Generate Excalidraw JSON diagrams in a clean draw.io style from natural language descriptions.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/JongDeug/dotfiles --skill excalidraw-diagram-jongdeug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excalidraw-diagram
Source: https://github.com/JongDeug/dotfiles/tree/main/ai/claude/skills/excalidraw-diagram
Command: npx skills add https://github.com/JongDeug/dotfiles --skill excalidraw-diagram-jongdeug

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating architecture, workflow, or concept diagrams by hand is slow, and generic AI-generated diagrams tend to be uniform boxes-and-arrows that display labels without communicating structure. This Skill produces Excalidraw JSON files whose visual layout mirrors the concept being explained, in a crisp draw.io / diagrams.net style rather than a hand-drawn look. ## Core Features & Use Cases - Concept-to-pattern mapping: Matches each concept to a visual pattern (fan-out, convergence, timeline, tree, cycle) so the diagram's structure argues the idea, not just labels it. - Evidence artifacts for technical diagrams: Embeds real code snippets, JSON payloads, and actual event or API names researched from specifications so diagrams teach concrete details. - Section-by-section generation for large diagrams: Builds comprehensive diagrams incrementally to avoid output token truncation, with cross-section arrow bindings and a geometry-based self-review checklist (PNG rendering is disabled; the .excalidraw JSON is the deliverable). - Brand-customizable palette: All colors, fonts, and stroke defaults live in references/color-palette.md as a single source of truth you can swap for your own brand. - Use Case: Ask for a diagram of how a streaming protocol delivers events from an agent backend to a frontend UI, and receive a .excalidraw file with real event names, a timeline of the event sequence, and grouped sections for each system component. ## Quick Start Ask your coding agent to create an Excalidraw diagram showing how your system's components communicate, and it will generate the .excalidraw JSON file for you.

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 with an AI coding agent?▼

Ask your agent in natural language to diagram a workflow, architecture, or concept. The skill maps each concept to a visual pattern, generates the .excalidraw JSON file section by section, and self-reviews the geometry before delivering the file.

How do I customize the colors and fonts of generated Excalidraw diagrams?▼

Edit references/color-palette.md, which is the single source of truth for all fill/stroke pairs, text colors, and font choices. Every diagram the skill generates reads from that file, so one edit re-brands all future output.

Can I render the Excalidraw JSON to a PNG image?▼

PNG rendering is disabled in this configuration of the skill. The deliverable is the .excalidraw JSON file only, intended to be viewed directly in tools like Obsidian's Excalidraw plugin, and layout quality is checked by geometric self-review instead.

Why does the skill generate large diagrams section by section?▼

Comprehensive diagrams exceed the model's per-response output token limit, so generating everything at once produces truncated, broken JSON. Building one section per pass with descriptive IDs and namespaced seeds yields complete, maintainable files with correct cross-section arrow bindings.

What visual style do the generated diagrams follow?▼

Diagrams follow a draw.io / diagrams.net aesthetic: roughness 0, solid fills, sharp 90-degree corners, sans-serif fonts, thin uniform strokes, and straight or orthogonal elbow connectors snapped to a 20-pixel grid. A hand-drawn sketchy look is used only if explicitly requested.