Excalidraw Diagram

Most diagramming tools just give you boxes and arrows. This one has opinions about what makes a diagram actually useful. It generates Excalidraw JSON files with a built-in philosophy: diagrams should argue, not just display. For technical diagrams, it pushes you to include evidence artifacts like real API payloads, actual event names from specs, and code snippets that prove accuracy. It distinguishes between simple conceptual diagrams and comprehensive technical ones, and has specific guidance on when to use containers versus free-floating text. The whole approach is built around an isomorphism test: if you stripped all the text, would the structure alone communicate the concept? Good for architecture diagrams, protocol explanations, anything where the visual structure needs to mirror the conceptual structure.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 7
skills.sh installs: 8.8K
GitHub stars: 5.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add coleam00/excalidraw-diagram-skill --skill excalidraw-diagram --agent claude-code

Installs into .claude/skills of the current project.

Files

Excalidraw Diagram Creator

Generate .excalidraw JSON files that argue visually, not just display information.

Setup: If the user asks you to set up this skill (renderer, dependencies, etc.), see README.md for instructions.

Customization

All colors and brand-specific styles live in one file: references/color-palette.md. Read it before generating any diagram and use it as the single source of truth for all color choices — shape fills, strokes, text colors, evidence artifact backgrounds, everything.

To make this skill produce diagrams in your own brand style, edit color-palette.md. Everything else in this file is universal design methodology and Excalidraw best practices.

Core Philosophy

Diagrams should ARGUE, not DISPLAY.

A diagram isn't formatted text. It's a visual argument that shows relationships, causality, and flow that words alone can't express. The shape should BE the meaning.

The Isomorphism Test: If you removed all text, would the structure alone communicate the concept? If not, redesign.

SKILL.md on GitHub