excalidraw
Create professional diagrams and visualizations using Excalidraw JSON format. Specialized for IT architecture diagrams, flowcharts, network topology, system design, microservices, ER diagrams, and state machines. Includes curated color palettes and visual styles. Use when working with .excalidraw files, or when user mentions diagrams, flowcharts, architecture visualization, or drawing. Delegates to subagents to prevent context exhaustion from verbose JSON.
When & Why to Use This Skill
This Claude skill enables the automated generation and modification of professional diagrams and visualizations using the Excalidraw format. It streamlines the creation of complex IT architecture diagrams, flowcharts, and system designs by leveraging specialized component libraries for AWS, Azure, GCP, and Kubernetes. By utilizing subagent delegation to handle verbose JSON data, it ensures high-quality visual documentation and architectural mapping without exhausting context limits.
Use Cases
- Cloud Infrastructure Mapping: Automatically generate detailed AWS, Azure, or GCP architecture diagrams using standardized service icons.
- Software System Design: Visualize microservices architectures, component relationships, and system integrations for technical specifications.
- Database Modeling: Create Entity-Relationship (ER) diagrams and UML charts to document data structures and schema logic.
- Workflow Visualization: Design professional flowcharts and state machines to illustrate complex business processes or application logic.
- Rapid UI Prototyping: Build low-fidelity wireframes and web kits to communicate user interface concepts during the early design phase.
| name | excalidraw |
|---|---|
| description | Create professional diagrams and visualizations using Excalidraw JSON format. Specialized for IT architecture diagrams, flowcharts, network topology, system design, microservices, ER diagrams, and state machines. Includes curated color palettes and visual styles. Use when working with .excalidraw files, or when user mentions diagrams, flowcharts, architecture visualization, or drawing. Delegates to subagents to prevent context exhaustion from verbose JSON. |
Excalidraw Diagram Skill
Create professional diagrams in Excalidraw JSON format.
Critical: Subagent Delegation
Main agents must NEVER read .excalidraw files directly.
Excalidraw JSON is extremely verbose (4,000 - 22,000+ tokens per file). Always delegate to subagent and request text summaries, never raw JSON.
Main Agent Subagent
│ │
├── Provide task description ──────►│
│ ├── Read/parse files
│ ├── Execute operations
│◄── Receive text summary ──────────┤
Component Libraries
Use pre-built components from libraries/ folder first.
Library Selection
| Diagram Type | Libraries |
|---|---|
| AWS | aws-architecture-icons |
| Azure | azure-cloud-services |
| GCP | gcp-icons, google-icons |
| System Design | software-architecture, system-design |
| Microservices | software-architecture, kubernetes-icons |
| Database/ER | database, uml-er-library |
| Flowchart | flow-chart-symbols |
| Network | network-topology-icons |
| DevOps/CI/CD | devops-icons, technology-logos |
| Wireframe | basic-ux-wireframing, web-kit |
Priority Order
- Pre-downloaded → Check
libraries/folder - Online → Fetch from libraries.excalidraw.com
- Custom → Build from basic shapes (last resort)
See LIBRARIES.md for usage details.
Workflow
Create Diagram
- Identify diagram type from user request
- Select appropriate library and palette
- Generate JSON with all required properties (see JSON-SCHEMA.md)
- Verify against Quality Checklist
Modify Diagram
- Read and parse existing file (via subagent)
- Apply requested changes
- Maintain style consistency
- Return summary of changes
Defaults
| Setting | Default | Notes |
|---|---|---|
| Style | hand-drawn |
Excalidraw signature look |
| Font | fontFamily: 1 (Virgil) |
Authentic hand-drawn feel |
| Roughness | 1 |
Hand-drawn effect |
| Grid | 20px |
Alignment base |
Quality Checklist
Before delivering:
- Visual hierarchy clear
- Color follows 60-30-10 rule
- Text contrast ≥4.5:1 (WCAG AA)
- Elements aligned to 20px grid
- Spacing ≥40px between elements
- All connections clearly directed
- Key elements labeled
- Style consistent throughout
Reference Documentation
| Document | Content |
|---|---|
| JSON-SCHEMA.md | Required - Complete JSON specification |
| ELEMENTS.md | Element types and properties |
| PALETTES.md | Color palette definitions |
| STYLES.md | Visual style configurations |
| ICONS.md | Hand-drawn icon patterns (fallback) |
| LIBRARIES.md | Component library reference |
| IT-DIAGRAMS.md | IT architecture templates |
| TEMPLATES.md | General diagram templates |