Agent skill

Excalidraw Diagram Generator

Writes .excalidraw JSON diagrams and exports them to PNG or SVG through the Kroki API or a local Firefox-based CLI.

Custom licenceAuto-check passedDevelopment

Install Excalidraw Diagram Generator

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/excalidraw-skill .claude/skills/excalidraw && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .claude/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/excalidraw-skill .agents/skills/excalidraw && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .agents/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/excalidraw-skill .cursor/skills/excalidraw && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .cursor/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/dtsola/xiaoyaosearch.git --path .claude/skills/excalidraw-skill

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/excalidraw-skill .gemini/skills/excalidraw && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .gemini/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/excalidraw-skill .github/skills/excalidraw && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .github/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add dtsola/xiaoyaosearch --skill excalidraw -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install dtsola/xiaoyaosearch excalidraw --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dtsola/xiaoyaosearch.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/excalidraw-skill .opencode/skills/excalidraw && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "excalidraw" agent skill from https://github.com/dtsola/xiaoyaosearch/tree/main/.claude/skills/excalidraw-skill into .opencode/skills/excalidraw/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "excalidraw", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: excalidraw
GitHub stars: 1k
Token cost: ~3.5k tokens
SKILL.md length: 1,340 words
Files: 6 (incl. assets)
Skills in repo: 4
Repo updated: Oct 2, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

Writes .excalidraw JSON diagrams and exports them to PNG or SVG through the Kroki API or a local Firefox-based CLI.

Works in 5 steps: Check deps — use Kroki (curl) for SVG;… → Plan — identify diagram type, pick a… → Generate — write .excalidraw JSON file… → …
Creating an architecture or flowchart diagram
SKILL.md covers Overview, When to Use, Prerequisites and Workflow, plus 4 more sections
Calls curl, npm and npx; reaches kroki.io

What it does

This skill triggers explicitly on words like diagram or flowchart, and proactively whenever a system has three or more interacting components, a multi-step process, or architectures worth comparing side by side, skipping diagrams when a list or table would do. Kroki needs only curl and produces SVG only, while the local CLI needs Firefox through Playwright and a one-time macOS keybinding patch, but adds PNG output.

It follows a fixed default style of zero roughness, Helvetica at set sizes for title, header, label, description, and note text, and solid fills, switching to a hand-drawn roughness or the Virgil font only on request. The workflow checks dependencies, plans the diagram type and color palette, writes the JSON section by section for large diagrams, exports it, and reports the output file path.

When your agent uses it

Creating an architecture or flowchart diagram
Visualizing a multi-step process or decision tree
Comparing two architectures or approaches side by side

Example prompts

“Draw a flowchart of our microservices architecture.”
“Visualize this multi-step onboarding process as a diagram.”
“Export this Excalidraw diagram to PNG.”

Requirements

curl for Kroki API export
Firefox via Playwright for local PNG export

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Check deps — use Kroki (curl) for SVG; use local CLI for PNG
Plan — identify diagram type, pick a visual pattern, choose color palette
Generate — write .excalidraw JSON file (section-by-section for large diagrams)
Export — run Kroki or CLI command
Report — tell user the output file path

What it can do on your machine

Read from SKILL.md and the folder at commit 0a9c6fc. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- npm
- npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- kroki.io
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Excalidraw Diagram Generator loads about 3.5k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 1,340 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~87
When it runs · the whole SKILL.md, loaded when a task matches: ~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,340 words (~3,468 tokens).

“Generate .excalidraw JSON files and export to PNG/SVG.”

— opening of SKILL.md by dtsola, Custom licence

name: excalidraw
homepage: https://github.com/Agents365-ai/excalidraw-skill

Outline of SKILL.md

Excalidraw Diagrams
Overview
When to Use
Prerequisites
Option A: Kroki API (recommended — zero install, SVG only)
Option B: Local CLI (required for PNG)
Workflow
Design Principles
Default style
Font size hierarchy
Color palette
Arrow semantics
Excalidraw JSON Structure
File skeleton
Element types
Element sizing
Required properties (all elements)
JSON field rules
Text inside shapes (contained text)
Arrow binding (bidirectional)
Arrow routing
Grouping
Diagram Patterns
Spacing Reference
Flowchart (LR or TB)
Architecture / System Diagram
Sequence Diagram
Mind Map
Swimlane
Section-by-Section Construction

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (assets) in .claude/skills/excalidraw-skill of dtsola/xiaoyaosearch.

SKILL.md
.gitignore
README.md
README_EN.md
assets/microservices-example.excalidraw
assets/microservices-example.png

Open the folder on GitHubat commit 0a9c6fc

Compare with similar skills

Excalidraw Diagram Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Excalidraw Diagram Generator compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Excalidraw Diagram Generator this skilldtsola/xiaoyaosearch	1k	—	~3.5k	Automated safety check: Pass	Custom licence	8 days ago
Diagram Designcathrynlavery/diagram-design	48k	1 repos	~7.6k	Automated safety check: Pass	MIT	today
Excalidraw Diagramcoleam00/excalidraw-diagram-skill	5k	2 repos	~6.1k	Automated safety check: Pass	None	7 mo ago
Excalidraw Diagrambreferrari/obsidian-mind	5k	—	~3.9k	Automated safety check: Pass	MIT	4 days ago
Excalidraw Skillyctimlin/mcp_excalidraw	2.5k	—	~4.6k	Automated safety check: Pass	MIT	today
Lanshu Animated Architecture Diagramcclank/lanshu-animated-architecture-diagram	995	—	~1.1k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
48k GitHub starsUsed in 1 repo~7.6k tokens
DevelopmentAuto-check passed
Excalidraw Diagram
coleam00/excalidraw-diagram-skill
Create Excalidraw diagram JSON files that make visual arguments.
5k GitHub starsUsed in 2 repos~6.1k tokens
DevelopmentAuto-check passed
Excalidraw Diagram
breferrari/obsidian-mind
Generate Excalidraw diagrams from text content. An agent skill from breferrari/obsidian-mind.
5k GitHub stars~3.9k tokensUpdated 4 days ago
DevelopmentAuto-check passed
Excalidraw Skill
yctimlin/mcp_excalidraw
Excalidraw canvas toolkit for creating, editing, and refining diagrams on a live canvas.
2.5k GitHub stars~4.6k tokensUpdated today
DevelopmentAuto-check passed
Lanshu Animated Architecture Diagram
cclank/lanshu-animated-architecture-diagram
Create premium hand-drawn architecture and process diagrams in the Lanshu animated GIF style, with editable .excalidraw files, static PNG previews, and genuinely animated GIFs with moving flow…
995 GitHub stars~1.1k tokensUpdated 1 mo ago
DevelopmentAuto-check passed
Excalidraw Diagram Studio
tech-leads-club/agent-skills
Generates Excalidraw diagram files from plain descriptions, choosing among flowcharts, mind maps, architecture, swimlane, class, sequence and ER diagrams.
7k GitHub stars~3.6k tokensUpdated yesterday
DevelopmentAuto-check passed

Questions about Excalidraw Diagram Generator

What does Excalidraw Diagram Generator do?

Writes .excalidraw JSON diagrams and exports them to PNG or SVG through the Kroki API or a local Firefox-based CLI. This skill triggers explicitly on words like diagram or flowchart, and proactively whenever a system has three or more interacting components, a multi-step process, or architectures worth comparing side by side, skipping diagrams when a list or table would do. Kroki needs only curl and produces SVG only, while the local CLI needs Firefox through Playwright and a one-time macOS keybinding patch, but adds PNG output.

When should I use Excalidraw Diagram Generator?

Excalidraw Diagram Generator fits situations like: creating an architecture or flowchart diagram; visualizing a multi-step process or decision tree; comparing two architectures or approaches side by side.

How do I install Excalidraw Diagram Generator in Claude Code?

Run `npx skills add dtsola/xiaoyaosearch --skill excalidraw -a claude-code`. Or copy the skill folder (.claude/skills/excalidraw-skill in dtsola/xiaoyaosearch) into .claude/skills/excalidraw in your project. Claude Code loads it when a task matches its description.

How do I install Excalidraw Diagram Generator in Codex?

Run `npx skills add dtsola/xiaoyaosearch --skill excalidraw -a codex`. Or copy the skill folder (.claude/skills/excalidraw-skill in dtsola/xiaoyaosearch) into .agents/skills/excalidraw in your project. Codex loads it when a task matches its description.

Can I use Excalidraw Diagram Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dtsola/xiaoyaosearch --skill excalidraw -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/excalidraw, .gemini/skills/excalidraw, .github/skills/excalidraw and .opencode/skills/excalidraw in your project.

What does Excalidraw Diagram Generator need to run?

Going by SKILL.md and its folder, Excalidraw Diagram Generator needs the command-line tools its instructions call (curl, npm and npx). Our summary lists: curl for Kroki API export; Firefox via Playwright for local PNG export.

Does Excalidraw Diagram Generator access the network?

SKILL.md names 1 domain. In commands or code: kroki.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Excalidraw Diagram Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Excalidraw Diagram Generator use?

Excalidraw Diagram Generator has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Excalidraw Diagram Generator use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Excalidraw Diagram Generator?

Skills that share tags, products or a category with Excalidraw Diagram Generator: Diagram Design (cathrynlavery/diagram-design, 48k stars), Excalidraw Diagram (coleam00/excalidraw-diagram-skill, 5k stars), Excalidraw Diagram (breferrari/obsidian-mind, 5k stars) and Excalidraw Skill (yctimlin/mcp_excalidraw, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Excalidraw Diagram Generator?

dtsola (a GitHub user) maintains it in dtsola/xiaoyaosearch, which has 1,036 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 2, 2026.

Source: dtsola/xiaoyaosearch on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Excalidraw Diagram Generator

Install Excalidraw Diagram Generator

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Diagram Design