excalidraw-diagram
Generate Excalidraw diagrams. Use when the user asks to create a diagram, visualize a concept, or illustrate technical architectures.
When & Why to Use This Skill
This Claude skill enables the automated generation of professional Excalidraw diagrams directly from text descriptions. It streamlines the process of visualizing complex technical architectures, system workflows, and abstract concepts by converting structured JSON data into clean, high-quality images. Ideal for developers and architects, it supports various shapes, customizable properties, and specific styling for technical precision.
Use Cases
- Software Architecture Visualization: Automatically generate system design diagrams, including microservices structures, database schemas, and cloud infrastructure layouts.
- Technical Documentation: Create precise flowcharts and sequence diagrams to illustrate complex logic or API workflows within project documentation.
- Concept Mapping: Transform abstract ideas or business processes into easy-to-understand visual whiteboard sketches for better team alignment.
- Educational Illustrations: Generate clear, labeled diagrams to explain technical concepts, networking protocols, or data structures during tutoring or training sessions.
| name | excalidraw-diagram |
|---|---|
| description | Generate Excalidraw diagrams. Use when the user asks to create a diagram, visualize a concept, or illustrate technical architectures. |
Excalidraw Diagram Generation
Workflow
- Write excalidraw JSON to
<name>.excalidraw - Render:
python -m excalidraw <name>.excalidraw -o <name>.png
File Structure
{
"type": "excalidraw",
"version": 2,
"source": "claude",
"elements": [...],
"appState": {
"viewBackgroundColor": "#ffffff"
}
}
Available Shapes
rectangle,ellipse,diamond,line,arrow,text
Shape Properties
{
"id": "unique_id",
"type": "rectangle",
"x": 100,
"y": 100,
"width": 150,
"height": 80,
"strokeColor": "#1e1e1e",
"backgroundColor": "#a5d8ff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 0
}
Text Elements
{
"id": "label1",
"type": "text",
"x": 110,
"y": 110,
"width": 130,
"height": 60,
"text": "Multi-line\ntext here",
"fontSize": 16,
"fontFamily": 5,
"textAlign": "center",
"strokeColor": "#1e1e1e"
}
fontFamily: 1=hand-drawn, 2=normal, 5=monospace (use for technical diagrams)
Arrow/Line Elements
{
"id": "arrow1",
"type": "arrow",
"x": 100,
"y": 100,
"width": 0,
"height": 50,
"strokeColor": "#1971c2",
"strokeWidth": 2,
"roughness": 0,
"points": [[0, 0], [0, 50]]
}
Dashed Frames
{
"id": "frame1",
"type": "rectangle",
"strokeColor": "#2f9e44",
"backgroundColor": "transparent",
"strokeStyle": "dashed",
"roughness": 0
}
Color Palette
| Color | Stroke | Fill |
|---|---|---|
| Green | #2f9e44 | #b2f2bb |
| Orange | #f08c00 | #ffd8a8, #ffec99 |
| Red | #e03131 | #ffc9c9 |
| Blue | #1971c2 | #a5d8ff, #d0ebff |
| Purple | #9c36b5 | #e599f7, #eebefa |
| Grey | #868e96 | #dee2e6, #e9ecef |
Spacing Guidelines
- Title fontSize: 28-36
- Section headers: 20-24
- Body text: 12-16
- Minimum padding inside boxes: 10px
- Gap between sections: 20-30px
- Dashed frame padding: 20px inside content
Arrow Labeling Rules
- Arrows point AT things, not along them - perpendicular to target
- Arrow tip touches the target
- Text and arrow must not overlap
Iteration Log
- fontFamily: Use 5 (monospace) for technical diagrams, not 1 (hand-drawn).
- Text in shapes: Create separate text elements inside boxes for reliable rendering.
- roughness: Set to 0 for clean technical diagrams.