excalidraw
Skill0 starsChanged 59 days agoMITView on GitHub
Cria diagramas como arquivos .excalidraw.md que abrem no Obsidian (plugin Excalidraw) ou em excalidraw.com (local, sem rede): mind maps, flowcharts auto-layout, swimlanes/camadas e boards livres (shapes, texto, frames, cards, setas). Use quando pedir um excalidraw, diagrama/fluxo/mapa mental no Obsidian, desenhar flowchart, mapear processo visualmente no vault, ou visual editável no Obsidian. NÃO para slides, imagens geradas por IA ou boards do Miro.
73 other projects use a version of this.
Adopted by
Most recently taken up by
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- Yassimba/loomtheir own version, first seen Nov 15, 2026
- lesliexqing/skills-for-funtheir own version, first seen Nov 15, 2026
- metaspartan/cybaratheir own version, first seen Nov 15, 2026
- yarikleto/claude-teacher-plugintheir own version, first seen Nov 14, 2026
- omidnw/my-skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use heartmula, webhook-subscriptions and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
math-incSkillheartmula
Set up and run HeartMuLa, the open-source music generation model family (Suno-like). Generates full songs from lyrics + tags with multilingual support.
Also in 9 projects that use this
Tommy-ywSkillwebhook-subscriptions
Create and manage webhook subscriptions for event-driven agent activation, or for direct push notifications (zero LLM cost). Use when the user wants external services to trigger agent runs OR push notifications to chats.
Also in 5 projects that use this
john-data-chenSkilltouchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
Also in 7 projects that use this
math-incSkillminecraft-modpack-server
Set up a modded Minecraft server from a CurseForge/Modrinth server pack zip. Covers NeoForge/Forge install, Java version, JVM tuning, firewall, LAN config, backups, and launch scripts.
Also in 5 projects that use this
AlekseiULSkillTubeScribe
YouTube video summarizer with speaker detection, formatted documents, and audio output. Works out of the box with macOS built-in TTS. Optional recommended tools (pandoc, ffmpeg, mlx-audio) enhance quality. Requires internet for YouTube access. No paid APIs or subscriptions. Use when user sends a YouTube URL or asks to summarize/transcribe a YouTube video.
Also in 3 projects that use this
mae616Skillp5js
p5.js(クリエイティブコーディング)のProcessing由来「コードでスケッチ」思想を軸に、setup/drawループ・座標系・インタラクション・パフォーマンス最適化を整理する。p5.js、Processing、クリエイティブコーディング、ジェネラティブアート、インタラクティブ表現、ビジュアルプログラミング、Canvas描画、パーティクル、フラクタル、ノイズ表現に関する相談で必ず使うこと。ユーザーが「コードでアート」「動くビジュアル」「インタラクティブな描画」と言った場合にも適用する。
Also in 10 projects that use this
- +5 more from math-inc
Other versions73 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 73
- ShenSeanChen/waku-agent★ 2.2ksame name
- math-inc/OpenGauss★ 1.3ksame name
- dtsola/xiaoyaosearch★ 1ksame name
- boldsoftware/shelley★ 713same name
- neo4j-labs/agent-memory★ 598same name
- Tommy-yw/RunbookHermes★ 546same name
- ooiyeefei/ccc★ 501same name
- RedWoodOG/Hermes-Desktop★ 177same name
- HybridAIOne/hybridclaw★ 162same name
- yamcodes/arkenv★ 151same name
63 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- deep-researchSkill
- emitir-nfseSkill
- folder-organizerSkill
- ig-competitor-researchSkill
- image-prompt-generatorSkill
- memorySkill
- roastSkill
- screenwatchSkill
- site-builderSkill
- slide-creatorSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 4 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 68 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 34
Every builder writes ONE .excalidraw.md file and prints the element count + path.
- Distinctive: line 40
No token, no secrets, no board id.
- Very specific: line 52
If --out is omitted, the file is named after the input JSON.
- Distinctive: line 63
When unsure which, ask one short question.
- Very specific: line 130
Add --layers to render each distinct node.lane as a horizontal swimlane (a frame), nodes spread inside it.
- Distinctive: line 177
Frames as containers: create the frame FIRST and place items at coords inside its rectangle (visual containment).
- Very specific: line 183
Write "não", "manhã", "adoração", "raízes", not "nao/manha/adoracao/raizes".
- Distinctive: line 196
Always ask the user to open the file: after building. Structure/count is guaranteed.
“Common” is measured: kept by at least 6 in 10 of the 68 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Excalidraw (mindmaps + flowcharts + free-form, in Obsidian)
Build any diagram as an Excalidraw file that opens directly in the Obsidian
Excalidraw plugin (or in excalidraw.com when saved as .excalidraw). Everything is computed locally and written to disk: NO API, NO
network. The hard parts of the Excalidraw file format (bound text, bound arrows
clipped to shape borders, the .excalidraw.md wrapper, fractional indices, no
parallelogram/pill shapes, UTF-8 for PT-BR) are solved inside scripts/excalidraw.py.
Drive that script; do not hand-write Excalidraw JSON.
When to use
- "cria um mapa mental de X no excalidraw", "joga isso num excalidraw"
- "desenha um fluxo / flowchart / diagrama no Obsidian", "mapeia esse processo"
- "monta um diagrama de camadas / raias"
- "quero um visual que eu edito no Obsidian"
Three builders
build— a mind map (root → branches → leaves), one tree, tidy auto-layout. Best when the content is hierarchical.flow— an auto-laid-out flowchart from{nodes, edges}. YOU do NOT compute x/y: it ranks nodes topologically (decision loop-backs handled) and styles each by type. Right tool for a "fluxo/flowchart bonito", NOT a mind map.--layersrenders swimlanes bynode.lane(layered architecture / N-camadas diagram).create— arbitrary objects from a spec: shapes, sticky notes, text, frames, cards, plus arrows between them. YOU set each object's (x, y). Best for kanban, matrices, or mixed boards with full manual control.
Every builder writes ONE .excalidraw.md file and prints the element count + path.
Prerequisites
- Python with UTF-8 forced on Windows: prefix
PYTHONUTF8=1and usepython -X utf8(accented PT-BR text breaks otherwise). - No token, no secrets, no board id. This writes local files only.
Output file (--out)
- Default folder:
$EXCALIDRAW_DIRif set (point it to your Obsidian vault's Excalidraw folder), otherwise./excalidrawin the current directory. A bare--out "Nome do desenho"lands there asNome do desenho.excalidraw.md. - Format:
.excalidraw.md(Obsidian-native, uncompressed, withtags: [excalidraw]frontmatter — shows in the graph, searchable). Pass an--outending in.excalidrawto write raw JSON instead. --append: merge into an existing target file. New content is dropped BELOW the existing drawing (never overlaps, never replaces). Default (no flag) creates/overwrites.- If
--outis omitted, the file is named after the input JSON.
Two input modes (decide per request)
- Free theme — the user gives a topic ("mapa do meu posicionamento"). Build the
structure from context: query the Memory Vault first (
/memory:query) for anything client/positioning/strategy related, then author root → branches → leaves (forbuild) or nodes → edges (forflow). Keep phrases short, in the user's voice. - Outline given — the user provides the structure. Render it faithfully; do not invent branches.
When unsure which, ask one short question. Respect the no-em-dash rule (use colons, commas, parentheses; ranges like "0 a 3").
Core workflow
- Author the input JSON as a UTF-8 file (use the Write tool or
json.dump(..., ensure_ascii=False)). - Run the matching builder (examples below).
- Ask the user to open the file in Obsidian (Excalidraw view). Rendering is client-side: the script guarantees valid structure and element count, but only Obsidian shows the final visual. This doubles as the visual review checkpoint.
build — mind map
Recursive tree (any depth):
{"text": "Root topic",
"children": [
{"text": "Branch A", "children": [{"text": "leaf 1"}, {"text": "leaf 2"}]},
{"text": "Branch B", "children": [{"text": "leaf 3"}]}
]}Flat 3-level form also accepted: {"Root": {"Branch A": ["leaf 1","leaf 2"], "Branch B": ["leaf 3"]}}.
PYTHONUTF8=1 python -X utf8 \
"<skill-dir>/scripts/excalidraw.py" \
build --tree tree.json --out "Meu mapa"Root is filled/highlighted; each top branch gets its own color; leaves inherit the
branch color. Tuning: --col-w 320 (horizontal gap per depth level), --row-h 90
(vertical gap per leaf).
flow — flowchart (auto-layout, no manual coordinates)
{
"nodes": [
{"id": "start", "type": "start", "label": "Pedido chega"},
{"id": "p1", "type": "process", "label": "Receber dados"},
{"id": "d1", "type": "decision", "label": "Dados completos?"},
{"id": "p2", "type": "process", "label": "Lançar no ERP"},
{"id": "end", "type": "end", "label": "Concluído"}
],
"edges": [
{"from": "start", "to": "p1"},
{"from": "p1", "to": "d1"},
{"from": "d1", "to": "p2", "label": "sim"},
{"from": "d1", "to": "p1", "label": "não"},
{"from": "p2", "to": "end"}
]
}PYTHONUTF8=1 python -X utf8 \
"<skill-dir>/scripts/excalidraw.py" \
flow --spec flow.json --out "Fluxo do processo"- node
type→ shape + color:start/end(green ellipse),process(blue rounded rect),decision(amber diamond),io(gray rect),subprocess(purple rect). - edges become arrows;
labelbecomes the caption ("sim"/"não" on decision branches). - direction:
--dir TD(top-down, default) or--dir LR(left-right). - spacing:
--rank-gap 200(between ranks),--node-gap 320(between siblings).
Layered / swimlane diagram (--layers)
Add --layers to render each distinct node.lane as a horizontal swimlane (a frame),
nodes spread inside it. Pass lane_order in the spec to fix the top-to-bottom order.
{
"lane_order": ["1 Contexto", "2 Dados", "3 Inteligência", "4 Automações"],
"nodes": [
{"id": "ctx", "type": "process", "label": "Modelo de contexto", "lane": "1 Contexto"},
{"id": "mcp", "type": "io", "label": "MCP do ERP", "lane": "2 Dados"},
{"id": "brief","type": "process", "label": "Daily Brief", "lane": "3 Inteligência"},
{"id": "auto", "type": "subprocess", "label": "Squad de cobrança", "lane": "4 Automações"}
],
"edges": [{"from": "ctx", "to": "mcp"}, {"from": "mcp", "to": "brief"}, {"from": "brief", "to": "auto"}]
}... excalidraw.py flow --spec layers.json --out "Camadas" --layers --lane-gap 240create — free-form (shape, sticky_note, text, frame, card + arrows)
For anything that is not a single hierarchy or clean flow. YOU compute each object's
x/y (Excalidraw y grows downward).
{
"items": [
{"ref": "fr", "type": "frame", "title": "Funil", "x": 0, "y": 0, "width": 1200, "height": 700},
{"ref": "a", "type": "sticky_note", "text": "Lead entra", "x": 40, "y": 60, "color": "light_green"},
{"ref": "b", "type": "shape", "shape": "round_rectangle", "text": "Diagnóstico", "x": 400, "y": 60, "width": 260, "height": 110, "fillColor": "#d0ebff", "borderColor": "#1971c2"},
{"type": "text", "text": "Etapa 1", "x": 40, "y": 20, "fontSize": 20},
{"ref": "c", "type": "card", "title": "Proposta", "description": "enviar em 24h", "x": 400, "y": 260}
],
"connectors": [
{"from": "a", "to": "b", "caption": "qualifica", "color": "#1971c2"},
{"from": "b", "to": "c"}
]
}... excalidraw.py create --spec spec.json --out "Board"Field guide:
- type:
shape|sticky_note|text|frame|card. - shape (for
type: shape):rectangle/round_rectangle→ rectangle,circle/ellipse/oval→ ellipse,rhombus/diamond/triangle→ diamond. - color (sticky): named (
light_yellow,light_green,light_pink,light_blue,blue,violet,gray, ...). fillColor/borderColor/textColor (shape/card): HEX. - connectors:
from/toare itemrefs, optionalcaption,color. - Frames as containers: create the frame FIRST and place items at coords inside its rectangle (visual containment).
Non-negotiable rules (why the script exists)
- Author ALL text with full PT-BR accents and ç. NEVER transliterate to ASCII.
Write "não", "manhã", "adoração", "raízes", not "nao/manha/adoracao/raizes". This
pipeline is UTF-8 safe end to end (
ensure_ascii=False+ utf-8 write): stripping accents "to be safe on Windows" is a BUG here, not a safeguard. Windows-1252/ASCII caution applies to.ps1files read by PowerShell, NOT to this UTF-8 pipeline. If the build prints theAVISO UTF-8warning, you transliterated: rewrite the source JSON with correct accents and regenerate before handing the file to the user. - Never hand-write Excalidraw JSON. Bound text needs BOTH the shape's
boundElementsand the text'scontainerId; bound arrows must be clipped to shape borders and listed in both endpoints'boundElements. The script does all of this; raw JSON gets it wrong. - Never overwrite the user's existing drawing unless they ask. To add to an existing
file, use
--append(drops new content below). Otherwise write a NEW file name. - Excalidraw has no parallelogram, pill, or card shapes. The script maps io→rectangle, start/end→ellipse, decision→diamond, card→rectangle+bold title. Do not expect them.
- Always ask the user to open the file after building. Structure/count is guaranteed; the visual is not visible until Obsidian renders it client-side.
Reference
Full Excalidraw file-format notes (element schema, bindings, the .excalidraw.md
wrapper, gotchas) in references/excalidraw-format.md. Read it before touching the
Excalidraw file format outside this script.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

