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…

Что это?Это skill, дающий Claude Code (или любому кодинг-агенту с поддержкой skills) возможность генерировать диаграммы Excalidraw из описаний на естественном языке, причём компоновка действительно отражает концепцию (разветвления, таймлайны, схождение), а не безликие прямоугольники.
Это самостоятельное приложение или то, что я добавляю в своего кодинг-агента?Это набор файлов skill, который вы кладёте в папку skills своего агента, а не отдельное приложение. Агенты, читающие .claude/skills/ (вроде Claude Code и OpenCode), подхватят его автоматически.
Нужно ли что-то настроить, прежде чем агент сможет отрисовывать диаграммы?Да, конвейеру отрисовки нужна одноразовая настройка: можно попросить своего кодинг-агента выполнить за вас команды настройки из SKILL.md или сделать всё вручную.
Диаграмма генерируется вслепую или агент проверяет свою работу?Skill использует конвейер отрисовки на базе Playwright, поэтому агент видит свой результат, ловит проблемы вроде наложенного текста или смещённых стрелок и в цикле исправляет их, прежде чем отдать финальную диаграмму.
Как на деле попросить его нарисовать диаграмму?Вы просто описываете желаемое простым языком — например, 'создай диаграмму Excalidraw, показывающую, как протокол AG-UI передаёт события от ИИ-агента к фронтенду' — а skill берёт на себя отображение концепции, компоновку, генерацию JSON и отрисовку.
Можно ли поменять цвета и брендинг диаграмм?Да, все цвета и фирменные стили живут в одном файле — references/color-palette.md, — и его правка меняет каждую диаграмму, которую создаёт skill.
Что включено, кроме фигур и стрелок?В диаграммы можно включать подтверждающие артефакты вроде настоящих фрагментов кода и реальных JSON-полезных нагрузок, а не только безликие блоки.
Это работает только с Claude Code?Нет, он работает с любым кодинг-агентом с поддержкой skills; агенты, читающие папку .claude/skills/, вроде Claude Code и OpenCode, могут использовать его напрямую.
Creator
coleam00
Size
<0.1 MB
Stars
5K
Updated
CommitMar 01
Age
7mo
Commits · 90 Days