excalidraw-diagram

Generate Excalidraw JSON diagrams with visual validation via Playwright rendering.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/bittlinkm/claude-setup --skill excalidraw-diagram-bittlinkm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-diagram
Source: https://github.com/bittlinkm/claude-setup/tree/main/skills/excalidraw-diagram
Command: npx skills add https://github.com/bittlinkm/claude-setup --skill excalidraw-diagram-bittlinkm

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 generated diagrams end up as uniform boxes-and-arrows that display labels without teaching anything. This Skill produces Excalidraw diagrams whose visual structure mirrors the concepts they represent, with built-in render-and-validate loops to catch layout defects. ## Core Features & Use Cases - Concept-driven visual patterns: Maps each concept to a matching visual pattern (fan-out, convergence, timeline, tree, cycle) so the diagram's shape argues its meaning rather than just displaying text. - Evidence artifacts for technical diagrams: Embeds real code snippets, JSON payloads, and actual event names from specs so diagrams educate viewers with concrete detail. - Render-and-validate loop: A Playwright-based pipeline renders the .excalidraw JSON to PNG so the agent can visually inspect output and fix overlaps, clipping, and spacing issues iteratively. - Brand customization: All colors live in a single color-palette.md file that can be swapped to match any brand style. - Use Case: Ask your agent to diagram how a streaming protocol delivers events from backend to frontend, and receive a rendered, validated Excalidraw file showing real event names, section groupings, and code snippets. ## Quick Start Ask your coding agent to create an Excalidraw diagram showing how your system architecture or workflow operates, and it will generate, render, and visually validate the diagram.

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?

Install this skill into your agent's skills directory, then ask it to create a diagram of your workflow or architecture. The agent generates the Excalidraw JSON, renders it to PNG, and iteratively fixes visual issues before delivering.

How do I render an Excalidraw JSON file to PNG?

Run the included render_excalidraw.py script with uv from the references directory, passing the path to your .excalidraw file. It uses Playwright with headless Chromium and the Excalidraw exportToSvg API to produce a PNG screenshot.

What dependencies are needed to set up the Excalidraw renderer?

The renderer requires Python 3.11 or later, the uv package manager, and Playwright with Chromium. Run uv sync followed by uv run playwright install chromium in the references directory to complete setup.

Can I customize the diagram colors to match my brand?

Yes, all colors and brand styles live in a single file, references/color-palette.md. Edit the semantic shape colors, text hierarchy colors, and evidence artifact colors there, and every generated diagram follows your palette.

Why does the Excalidraw render script fail with a Chromium error?

The error occurs when Playwright's Chromium browser is not installed. Fix it by running uv run playwright install chromium from the references directory after completing uv sync.

When should I use simple versus comprehensive Excalidraw diagrams?

Use simple diagrams for abstract mental models and quick overviews where the audience knows the details. Use comprehensive diagrams with evidence artifacts, real event names, and code snippets for technical architectures, tutorials, and educational content.