excalidraw-agents365 — Claude Code skill: diagrams from text
excalidraw-agents365 turns a plain description of a system or a flow into an .excalidraw file, then exports it to SVG or PNG.
MIT 202 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a claude-codeWhat excalidraw-agents365 does
Describe your services or a process and the skill writes an .excalidraw JSON file: architecture maps, flow charts, figures for technical docs. Output is structured rather than sketchy. The catalogue entry points at the full skill in Agents365-ai/365-skills, which lands beside it under the name excalidraw.
Two export paths. With curl and the Kroki API you get SVG and have nothing to install, though the drawing itself is sent to kroki.io. The other runs excalidraw-brute-export-cli on Playwright Firefox for PNG and SVG on your own machine; on macOS the skill also patches that global module. The download is about 53 MB.
In Claude the skill carries disable-model-invocation: true, so it never fires by itself — call /excalidraw or ask for it by name. softaworks-agent-toolkit also ships a skill called excalidraw, and the later install overwrites the earlier one.
What it helps with
- draw a service map from a chat description
- get SVG out of an
.excalidrawfile without local tooling - put a process flow chart into the README
- render PNG locally so the diagram stays on the machine
Example prompts for the agent
- Run
/excalidrawand draw our backend: an API gateway, two workers, Postgres and Redis. - Make a checkout flow chart as
.excalidrawand export SVG through Kroki. - Build the architecture diagram and export PNG with the local CLI, nothing leaves the machine.
How to install excalidraw-agents365
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a claude-code2Manually: put the files in place
~/.claude/skills/excalidraw-agents365/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/excalidraw-agents365/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a codex2Manually: put the files in place
.agents/skills/excalidraw-agents365/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a cursor2Manually: put the files in place
.cursor/skills/excalidraw-agents365/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/excalidraw-agents3652Manually: put the files in place
.github/skills/excalidraw-agents365/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/excalidraw-agents365Manually: put the files in place
.devin/skills/excalidraw-agents365/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill excalidraw-agents365 -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-agents365
How do I install excalidraw-agents365 in Claude Code?
Run npx skills add podo/design-agent-skills --skill excalidraw-agents365 -a claude-code. The file lands at ~/.claude/skills/excalidraw-agents365/SKILL.md.
What does excalidraw-agents365 do?
It writes .excalidraw JSON from a description of an architecture or a flow, then exports the result to SVG via the Kroki API or to PNG and SVG with a local CLI.
Does the diagram leave my machine?
Through Kroki the drawing is sent to kroki.io. For anything that has to stay local, use only the Firefox-based CLI export.
Source text
SKILL.md · MIT
--- name: excalidraw-agents365 description: | Excalidraw diagram generation for coding agents. Turns natural-language descriptions of system architecture, flows, and technical documentation into .excalidraw files, exported to SVG through the Kroki API or to PNG/SVG with a local CLI. triggers: - "excalidraw for agents" - "architecture diagram excalidraw" - "system diagram" das: category: diagrams upstream: "https://github.com/Agents365-ai/365-skills" upstream_path: "plugins/excalidraw/skills/excalidraw-skill/SKILL.md" version: latest install: true --- # excalidraw-agents365 > Catalogue stub — full skill: [Agents365-ai/365-skills](https://github.com/Agents365-ai/365-skills) (`plugins/excalidraw`) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `excalidraw`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/excalidraw/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/excalidraw/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `excalidraw`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/excalidraw-agents365 ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add Agents365-ai/365-skills --skill excalidraw -g -y ``` **Project:** ```bash npx skills add Agents365-ai/365-skills --skill excalidraw -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Claude Code plugin route:** ``` /plugin marketplace add Agents365-ai/365-skills /plugin install excalidraw@365-skills ``` **Heads-up** - **Requires:** curl for SVG export through the third-party Kroki API (kroki.io), which receives your diagram content; PNG export needs excalidraw-brute-export-cli (npm) and Playwright Firefox; on macOS the skill also patches that global module - **License:** MIT (plugins/excalidraw/LICENSE; the repository has no top-level LICENSE file) - **Download size:** ~53 MB. - **Name collision:** `excalidraw` is also written by `softaworks-agent-toolkit` (its install or its catalogue pointer); installing both overwrites the earlier one. <!-- das:install:end --> ## Invoke after install - Skill name: `excalidraw` - Trigger phrases: "architecture diagram excalidraw", "system diagram" - The installed skill is marked `disable-model-invocation: true`, so in Claude Code it does not auto-trigger: call it by name (`/excalidraw`) or ask for it explicitly. ## What it does Generates Excalidraw diagrams tuned for coding agent workflows — system architecture, flow charts, and technical documentation — as `.excalidraw` JSON files, from a natural-language description. Export has two backends: the zero-install Kroki API via `curl` (SVG only, the diagram content is sent to kroki.io) or a local Firefox-based CLI for PNG and SVG. Optimized for clean, structured output rather than freeform sketching. Moved from the standalone `excalidraw-skill` repo into the `365-skills` collection. ## When NOT to use - Quick ideation sketches with a hosted edit link → use `hand-drawn-diagrams` - A render-and-verify Excalidraw workflow with a Playwright validation loop → use `excalidraw-diagram` - Diagrams that must not leave your machine → use the local CLI export only (not the Kroki option), or another diagram skill
© podo · MIT · podo/design-agent-skills