excalidraw-diagram-generator

Generate Excalidraw JSON diagram files from natural language descriptions.

Updated May 23, 2026
One-click install
npx skills add https://github.com/Oatse/CWE-Automation --skill excalidraw-diagram-generator-oatse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-diagram-generator
Source: https://github.com/Oatse/CWE-Automation/tree/main/.agents/skills/excalidraw-diagram-generator
Command: npx skills add https://github.com/Oatse/CWE-Automation --skill excalidraw-diagram-generator-oatse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Creating diagrams manually in drawing tools is slow and tedious, especially when you need to quickly visualize a process, system architecture, or concept hierarchy. This Skill converts plain-language descriptions directly into ready-to-open .excalidraw files, eliminating manual drawing work. ## Core Features & Use Cases - Nine Diagram Types: Generate flowcharts, relationship diagrams, mind maps, architecture diagrams, data flow diagrams, swimlane business flows, class diagrams, sequence diagrams, and ER diagrams. - Icon Library Integration: Split .excalidrawlib icon packs (e.g., AWS architecture icons) into individual files and insert them into diagrams with Python scripts that handle coordinate transforms and ID collisions. - Deterministic Editing Scripts: Add icons and labeled arrows to existing diagrams via command-line scripts without consuming AI context tokens on large icon JSON data. - Use Case: Ask for an AWS architecture diagram with an Internet Gateway, VPC, load balancer, EC2 instance, and RDS database, and receive a complete .excalidraw file with professional icons, labels, and connecting arrows that opens directly in Excalidraw. ## Quick Start Ask the AI to create a flowchart of your user registration process and save it as an Excalidraw file.

Frequently Asked Questions about excalidraw-diagram-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a flowchart from a text description?

Describe the process steps, decision points, and start/end points in plain language. The Skill extracts the structure, generates rectangles, diamonds, and arrows in Excalidraw JSON format, and saves a .excalidraw file you can open at excalidraw.com.

What diagram types can Excalidraw generate automatically?

Nine types are supported: flowcharts, relationship diagrams, mind maps, architecture diagrams, data flow diagrams, swimlane business flows, class diagrams, sequence diagrams, and ER diagrams. Each type has specific extraction rules for entities, relationships, and layout.

How do I add AWS architecture icons to an Excalidraw diagram?

Download an .excalidrawlib file from libraries.excalidraw.com, place it in a libraries subdirectory, and run split-excalidraw-library.py to extract individual icons. Then use add-icon-to-diagram.py to insert icons at specific coordinates with optional labels.

Can I open generated .excalidraw files without installing software?

Yes, .excalidraw files open directly in the browser at excalidraw.com via drag-and-drop or the Open menu. You can also use the Excalidraw VS Code extension for local editing.

What are the limitations of auto-generated Excalidraw diagrams?

Diagrams are limited to roughly 20 elements for clarity, complex curves are simplified to straight or basic curved lines, and there is no automatic collision detection. Embedded images are not supported, and very large requests should be split into multiple diagrams.

Why do the scripts create .excalidraw.edit files?

The add-icon and add-arrow scripts edit via a .excalidraw.edit suffix by default to avoid conflicts with an open Excalidraw editor overwriting changes. The file is renamed back after editing, and you can disable this behavior with --no-use-edit-suffix.