excalidraw
Hand-drawn diagrams in Excalidraw JSON (architecture, flowcharts)
Install / Use
npx skills add taracodlabs/aiden --skill excalidrawInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of excalidraw
excalidraw scores 85/100 on our quality scale, 821st of 1,156 Content & Media skills we index.
Its SKILL.md is 4.3 KB long, well organised into 10 sections with 5 code examples: a solid amount of guidance for an agent.
It has 843 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so excalidraw is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk โ read a skill before letting an agent act on it.
excalidraw compared with similar skills
All 4 of these similar skills score higher than excalidraw; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| excalidraw (this skill)by taracodlabs | 85 | 843 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.6k | 9d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.9k | 8d ago | CLAUDE.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 4d ago | SKILL.md |
Frequently asked questions
- How do I install excalidraw?
- Run
npx skills add taracodlabs/aiden --skill excalidraw. The install tabs above show the steps for each supported agent. - Which AI agents does excalidraw work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is excalidraw safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is excalidraw still maintained?
- The repository was last updated about 2 months ago, so excalidraw is actively maintained.
Skill content
View source on GitHubname: excalidraw description: Hand-drawn diagrams in Excalidraw JSON (architecture, flowcharts) category: productivity version: 1.0.0 origin: aiden license: Apache-2.0 tags: excalidraw, diagram, architecture, flowchart, sketch, visualization, json, drawing, design
Excalidraw Diagram Creation
Generate Excalidraw scene files (.excalidraw) by writing JSON that the Excalidraw app can open directly. Ideal for architecture diagrams, flowcharts, mind maps, and system design sketches in the characteristic hand-drawn style.
When to Use
- User wants a system architecture or component diagram
- User wants a flowchart or decision tree
- User wants a sequence or interaction diagram
- User wants a mind map or concept map
- User wants any visual sketch they can open and edit in Excalidraw
How to Use
1. Understand the Excalidraw JSON schema
An Excalidraw file is a JSON object with this top-level structure:
{
"type": "excalidraw",
"version": 2,
"source": "https://excalidraw.com",
"elements": [],
"appState": { "viewBackgroundColor": "#ffffff" },
"files": {}
}
Each element in "elements" is a shape with a common set of fields:
{
"id": "unique-id",
"type": "rectangle",
"x": 100, "y": 100,
"width": 200, "height": 80,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#a5d8ff",
"fillStyle": "hachure",
"strokeWidth": 2,
"roughness": 1,
"opacity": 100
}
Common element types: rectangle, ellipse, diamond, arrow, line, text, freedraw.
2. Add text labels
Use a text element positioned over or near shapes:
{
"id": "txt-1",
"type": "text",
"x": 130, "y": 130,
"width": 140, "height": 25,
"text": "Web Server",
"fontSize": 16,
"fontFamily": 1,
"textAlign": "center",
"verticalAlign": "middle"
}
3. Connect shapes with arrows
{
"id": "arrow-1",
"type": "arrow",
"x": 300, "y": 140,
"width": 100, "height": 0,
"points": [[0, 0], [100, 0]],
"startArrowhead": null,
"endArrowhead": "arrow",
"strokeColor": "#1e1e1e",
"strokeWidth": 2,
"roughness": 1
}
4. Generate and save the file
import json, uuid
def make_rect(x, y, w, h, label, bg="#a5d8ff"):
eid = str(uuid.uuid4())[:8]
return [
{ "id": eid, "type": "rectangle", "x": x, "y": y, "width": w, "height": h,
"angle": 0, "strokeColor": "#1e1e1e", "backgroundColor": bg,
"fillStyle": "hachure", "strokeWidth": 2, "roughness": 1, "opacity": 100 },
{ "id": eid+"t", "type": "text", "x": x+10, "y": y+(h//2)-10,
"width": w-20, "height": 20, "text": label, "fontSize": 16,
"fontFamily": 1, "textAlign": "center", "verticalAlign": "middle",
"strokeColor": "#1e1e1e", "opacity": 100 }
]
elements = []
elements += make_rect(100, 100, 160, 60, "Browser", "#ffd43b")
elements += make_rect(350, 100, 160, 60, "API Server", "#a5d8ff")
elements += make_rect(600, 100, 160, 60, "Database", "#b2f2bb")
scene = { "type": "excalidraw", "version": 2, "source": "https://excalidraw.com",
"elements": elements, "appState": { "viewBackgroundColor": "#ffffff" }, "files": {} }
with open("architecture.excalidraw", "w") as f:
json.dump(scene, f, indent=2)
print("Saved architecture.excalidraw โ open in https://excalidraw.com")
5. Open the file
The user can open the .excalidraw file by:
- Dragging it into https://excalidraw.com in a browser
- Opening it via File โ Open in the Excalidraw desktop app
Examples
"Draw a simple 3-tier web architecture diagram"
โ Use step 4 to generate three rectangles (Browser โ API Server โ Database) with connecting arrows. Save as architecture.excalidraw.
"Create a flowchart for a login process" โ Use rectangles for steps, diamonds for decisions, arrows for flow. Generate JSON and save.
"Make a mind map about machine learning concepts" โ Place a central ellipse, surround with connected sub-topic ellipses using short arrows.
Cautions
- All coordinates are in pixels โ plan layout with approximate x/y offsets before generating
- Excalidraw IDs must be unique per element โ always use
uuid.uuid4()or similar - The
roughnessproperty (0โ2) controls the hand-drawn effect: 0=clean, 1=normal, 2=very rough - Very large diagrams (> 200 elements) may be slow to render in the browser
- Excalidraw JSON format may evolve โ use
"version": 2which is the stable current format
Related Skills
taste-skill
117.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Claude-Code-Game-Studios
39.9kTurn Claude Code into a full game dev studio โ 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together ๅผๆบใ้็งไผๅ ใ่ชๆ็ฎก็็ฅ่ฏๅทฅไฝ็ฉบ้ด๏ผ่ฎฉไบบไธๆบ่ฝไฝๅจๆญคๅไฝ
x402
121.0kSet up Browser Use Cloud payments with x402 โ pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
