excalidraw
使用Excalidraw JSON格式创建专业图表和可视化。专注于IT架构图、流程图、网络拓扑、系统设计、微服务、ER图和状态机。包含精选配色方案和视觉风格。用于处理.excalidraw文件或提及图表、流程图、架构可视化或绘图时。委派子代理以避免从冗长的JSON中耗尽上下文。
📖 中文导读:使用Excalidraw JSON格式创建专业图表和可视化。专注于IT架构图、流程图、网络拓扑、系统设计、微服务、ER图和状态机。包含精选配色方案和视觉风格。用于处理.excalidraw文件或提及图表、流程图、架构可视化或绘图时。委派子代理以避免从冗长的JSON中耗尽上下文。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
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 |