excalidraw-diagram-skill README

The project's README from github.com/coleam00/excalidraw-diagram-skill. As one markdown file: README.md.

Excalidraw Diagram Skill

A coding agent skill that generates beautiful and practical Excalidraw diagrams from natural language descriptions. Not just boxes-and-arrows - diagrams that argue visually.

Compatible with any coding agent that supports skills. For agents that read from .claude/skills/ (like Claude Code and OpenCode), just drop it in and go.

What Makes This Different

Installation

Clone or download this repo, then copy it into your project's .claude/skills/ directory:

git clone https://github.com/coleam00/excalidraw-diagram-skill.git
cp -r excalidraw-diagram-skill .claude/skills/excalidraw-diagram

Setup

The skill includes a render pipeline that lets the agent visually validate its diagrams. There are two ways to set it up:

Option A: Ask your coding agent (easiest)

Just tell your agent: "Set up the Excalidraw diagram skill renderer by following the instructions in SKILL.md." It will run the commands for you.

Option B: Manual

cd .claude/skills/excalidraw-diagram/references
uv sync
uv run playwright install chromium

Usage

Ask your coding agent to create a diagram:

"Create an Excalidraw diagram showing how the AG-UI protocol streams events from an AI agent to a frontend UI"

The skill handles the rest — concept mapping, layout, JSON generation, rendering, and visual validation.

Customize Colors

Edit references/color-palette.md to match your brand. Everything else in the skill is universal design methodology.

File Structure

excalidraw-diagram/
  SKILL.md                          # Design methodology + workflow
  references/
    color-palette.md                # Brand colors (edit this to customize)
    element-templates.md            # JSON templates for each element type
    json-schema.md                  # Excalidraw JSON format reference
    render_excalidraw.py            # Render .excalidraw to PNG
    render_template.html            # Browser template for rendering
    pyproject.toml                  # Python dependencies (playwright)

excalidraw-diagram-skill (coleam00/excalidraw-diagram-skill)

Searching Database…

What is this?It is a skill that gives Claude Code (or any coding agent that supports skills) the ability to generate Excalidraw diagrams from natural language descriptions, with layouts that actually reflect the concept (fan-outs, timelines, convergence) instead of generic boxes.
Is this a standalone app or something I add to my coding agent?It is a skill file bundle you drop into your agent's skills folder, not a separate application. Agents that read from .claude/skills/ (like Claude Code and OpenCode) pick it up automatically.
Do I need to configure anything before the agent can render diagrams?Yes, the render pipeline needs a one-time setup; you can either ask your coding agent to run the setup commands from SKILL.md for you, or do it manually.
Does the diagram just get generated blindly, or does the agent check its own work?The skill uses a Playwright-based render pipeline so the agent can see its own output, catch issues like overlapping text or misaligned arrows, and fix them in a loop before delivering the final diagram.
How do I actually ask it to make a diagram?You just describe what you want in plain language, e.g. 'Create an Excalidraw diagram showing how the AG-UI protocol streams events from an AI agent to a frontend UI,' and the skill handles concept mapping, layout, JSON generation, and rendering.
Can I change the colors and branding of the diagrams?Yes, all colors and brand styles live in a single file, references/color-palette.md, and editing it changes every diagram the skill produces.
What is included besides shapes and arrows?Diagrams can include evidence artifacts such as real code snippets and actual JSON payloads, not just generic boxes.
Does this only work with Claude Code?No, it works with any coding agent that supports skills; agents that read from a .claude/skills/ folder, like Claude Code and OpenCode, can use it directly.
Creator
coleam00
Size
<0.1 MB
Stars
5K
Updated
CommitMar 01
Age
7mo
Commits · 90 Days