excalidraw · agents365-ai — Claude Code skill: diagrams as .excalidraw
This skill draws flowcharts, architecture charts and other diagrams into .excalidraw files, then exports them to PNG or SVG. Handy when a picture beats a paragraph.
npx skills add Agents365-ai/365-skills --skill excalidraw -a claude-code
npx skills add Agents365-ai/365-skills --skill excalidraw-skill -a claude-codeWhat excalidraw does
The skill fires when you ask for a diagram, and it also offers one on its own when an explanation covers three or more interacting components, a multi-step process or a side-by-side comparison of architectures. Output is a .excalidraw JSON file you can open in the Excalidraw editor. PDF is not supported.
Export runs two ways. Kroki needs nothing but curl and returns SVG. PNG requires the local CLI: npm install -g excalidraw-brute-export-cli plus npx playwright install firefox. That path drives Firefox, not Chromium, and on macOS you patch main.js once before the first run — skip it and the CLI keyboard shortcuts do nothing.
The skill ships a style guide: eight semantic fill colors, font sizes from 14 to 28 px, and three arrow styles for primary flow, responses and weak dependencies. It advises restraint with boxes. Free-floating text and lines carry the structure; filled rectangles are reserved for genuine components. Need a real AWS, Azure or UML icon? Community libraries are built from the same vector primitives, so their items survive both export paths.
What it helps with
- turn a written process description into a flowchart
- show a multi-component service architecture
- compare two design approaches in one image
- export a diagram to SVG for documentation
- get a PNG diagram without drawing it by hand
Example prompts for the agent
- Draw the architecture of this service in excalidraw
- Make a flowchart of the order pipeline and export it as SVG
- Diagram how these three components talk to each other
How to install excalidraw
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill excalidraw -a claude-codenpx skills add Agents365-ai/365-skills --skill excalidraw-skill -a claude-code2Manually: put the files in place
~/.claude/skills/excalidraw-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/excalidraw-skill/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill excalidraw-skill -a codex2Manually: put the files in place
.agents/skills/excalidraw-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill excalidraw-skill -a cursor2Manually: put the files in place
.cursor/skills/excalidraw-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Agents365-ai/365-skills excalidraw-skill2Manually: put the files in place
.github/skills/excalidraw-skill/SKILL.md1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill excalidraw-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/excalidraw/skills/excalidraw-skillManually: put the files in place
.devin/skills/excalidraw-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill excalidraw-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about excalidraw
How do I install excalidraw in Claude?
Run npx skills add Agents365-ai/365-skills --skill excalidraw -a claude-code. The skill lands at ~/.claude/skills/excalidraw-skill/SKILL.md.
What does the excalidraw skill do?
It writes .excalidraw files containing diagrams and charts, then exports them to PNG or SVG. PNG comes only from the local CLI; SVG works through either path.
What do I need for it to work?
SVG export needs just curl. PNG export needs excalidraw-brute-export-cli and Firefox via npx playwright install firefox, plus a one-time main.js patch on macOS.
Similar skills
Everything for Writing and docs →excalidraw by other authors comes first.