Drawio Skill
yuanchen-home/cumcm-step-review
A skill your agent uses when the user requests diagrams, flowcharts, architecture diagrams, ER diagrams, UML / sequence / class diagrams, SysML / MBSE diagrams (block definition, internal block…
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Agents365-ai/drawio-skill drawio-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/drawio-skill .claude/skills/drawio-skill && rm -rf skills-srcUse ~/.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/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .claude/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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 install https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skillType 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.
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Agents365-ai/drawio-skill drawio-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/drawio-skill .agents/skills/drawio-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .agents/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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.
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Agents365-ai/drawio-skill drawio-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/drawio-skill .cursor/skills/drawio-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .cursor/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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 https://github.com/Agents365-ai/drawio-skill.git --path skills/drawio-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Agents365-ai/drawio-skill drawio-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/drawio-skill .gemini/skills/drawio-skill && rm -rf skills-srcUse ~/.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/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .gemini/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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.
$ gh skill install Agents365-ai/drawio-skill drawio-skillInstalls 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).
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/drawio-skill .github/skills/drawio-skill && rm -rf skills-srcUse ~/.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/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .github/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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.
$ npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Agents365-ai/drawio-skill drawio-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Agents365-ai/drawio-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/drawio-skill .opencode/skills/drawio-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "drawio-skill" agent skill from https://github.com/Agents365-ai/drawio-skill/tree/main/skills/drawio-skill into .opencode/skills/drawio-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "drawio-skill", 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.
drawio-skillCreates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
The skill produces editable .drawio files instead of flattened pictures. Its main entry point, scripts/diagramctl.py, unifies generation, incremental sync, multi-view projection, semantic queries, tests and reviews, failure analysis and accessible publishing over a shared diagram representation. A routing table picks the workflow: natural-language diagrams are authored as XML, ordinary flowcharts and mind maps can be converted from Mermaid, large graphs go through an autolayout script, and code, Terraform, Kubernetes, compose files, SQL, OpenAPI, AsyncAPI, Protocol Buffers and GraphQL schemas go through a build command.
Other routes cover live infrastructure state, updating a generated diagram without losing manual layout, executive, deployment, data-flow and security views, architecture policy checks, MCP registration for hosts such as Claude Desktop, Cursor and VS Code, CI gates in GitHub Actions, before-and-after images for PR comments, exports to HTML, PowerPoint, Mermaid and Markdown, and metro-style maps for pipelines. It prefers Mermaid or PlantUML when diagrams-as-code is enough.
7 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 88fd923. It shows what the files ask for, not the result of running them.
Pre-approves these tools, so the agent can use them without asking each time:
BashReadWriteWebFetchFrom allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
python3From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Draw.io Diagram Studio loads about 2.4k tokens when it runs, and up to ~40k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 838 words of instructions outside code blocks.
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.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
allowed-tools: Bash, Read, Write, WebFetchAutomated 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); the scripts in this folder are not scanned.
The full file from Agents365-ai/drawio-skill at commit 88fd923, republished under its MIT licence (© Agents365-ai). 838 words, ~2,426 tokens.
.claude/skills/drawio-skill/SKILL.md (or your agent's skills folder). This skill also uses 81 other files; get the full folder from GitHub.Produce editable .drawio artifacts, not flattened pictures. The preferred
entrypoint is scripts/diagramctl.py, which unifies generation, incremental
sync, multi-view projection, semantic queries/tests/reviews, failure analysis,
and accessible publishing over a shared Diagram IR.
| Request | Route |
|---|---|
| Natural-language diagram with precise styling | Read references/diagram-types.md, then references/xml-authoring.md and author XML |
| Standard flowchart/mindmap/gantt/timeline/etc. with no special styling | If draw.io >=30, read references/mermaid-authoring.md and convert Mermaid to native .drawio |
| Large graph (~15+ nodes) that needs automatic layout | Use autolayout.py; read references/autolayout.md before passing any --layout value |
| Code, Terraform, K8s, compose, SQL, OpenAPI, AsyncAPI, or CI source | Use diagramctl.py build; read references/diagram-ir.md |
| Protocol Buffers schema (.proto) | Use protoimports.py or diagramctl.py build; read references/toolbox.md |
| GraphQL SDL schema (.graphql/.gql) or introspection JSON | Use graphqlerd.py or diagramctl.py build; read references/toolbox.md |
| Running cluster/stack/cloud (actual state, not declared config) | Read references/live-infra.md, then use tfstate.py, dockerimports.py, or k8simports.py - |
| Update a generated diagram without losing manual layout | Use diagramctl.py sync; read references/diagram-ir.md |
| Executive/system/deployment/data-flow/security views | Use diagramctl.py views; read references/diagram-ir.md |
| Query, architecture policy, review, what-if, or guided walkthrough | Read references/semantic-workflows.md |
| MCP host (Claude Desktop, Cursor, VS Code, Codex) should call these workflows | Register scripts/diagramctl_mcp.py; read references/mcp.md |
| Prompt phrasing for a diagram type or semantic workflow | Read references/cookbook.md |
| Enforce architecture rules or visual diffs in GitHub Actions CI | Read references/ci-gate.md |
| Rendered before/after/diff images as a PR review comment | Use prdiff.py; read references/pr-bot.md |
Existing .drawio to HTML/PPTX/Mermaid/Markdown/animation/runbook | Read references/toolbox.md; diagramctl.py transform exposes the existing tools |
| Pipeline, journey, or subsystem map drawn as a metro/subway map | Use tubemap.py; read references/tubemap.md |
| Shape, cloud/vendor, AI, or Databricks icon | Read references/shapes.md or references/databricks.md; never guess shape names |
| Learn/apply/manage a visual style | Read references/style-presets.md |
| Extract a reusable style from an existing diagram or theme | Read references/style-extraction.md |
| Existing image to editable diagram (screenshot, whiteboard photo, legacy PNG) | Read references/derasterize.md |
| Export/platform problem | Read references/troubleshooting.md; for access/network questions read references/security.md |
Run from this skill directory, or replace scripts/ with the absolute path to
this skill's scripts directory:
python3 scripts/diagramctl.py doctor
python3 scripts/diagramctl.py build model.json --from ir -o architecture.drawio
python3 scripts/diagramctl.py build ./infra --from terraform --group \
--ir-output architecture.ir.json -o architecture.drawio
python3 scripts/diagramctl.py sync architecture.drawio ./infra --from terraform \
-o architecture.next.drawio
python3 scripts/diagramctl.py views architecture.ir.json \
--views executive,system,deployment,dataflow,security -o views.drawio
python3 scripts/diagramctl.py test architecture.drawio --rules policy.yml
python3 scripts/diagramctl.py review architecture.drawio -o review.md
python3 scripts/diagramctl.py query architecture.drawio --from internet --to orders-db
python3 scripts/diagramctl.py whatif architecture.ir.json --fail kafka \
--drawio kafka-failure.drawio -o impact.json
python3 scripts/diagramctl.py story architecture.ir.json -o walkthrough.htmldoctor does not launch GUI tools unless --probe is passed. Core semantic
commands are offline and stdlib-only.
Infer the diagram type, audience, scope, output format, and location from the
request. Ask only when a missing choice materially changes the result;
default to PNG plus .drawio in the working directory.
Select the authoring route from the table above. For a data-backed diagram,
prefer Diagram IR and preserve provenance. For a large graph, use an importer
or autolayout.py; do not hand-place more than roughly fifteen nodes.
Resolve an explicitly named style preset, or the user's default preset, as
documented in references/style-presets.md. Structural diagram conventions
and visual presets compose; they do not replace each other.
Generate the .drawio, then run structural validation:
python3 scripts/validate.py diagram.drawio --scoreWhen semantic metadata or an architecture policy is in scope, also run
diagramctl.py test. Do not present inferred semantic findings as verified
runtime facts.
Export a draft PNG without embedded XML and inspect it visually. Fix obvious
overlap, clipping, disconnected edges, edge-through-node routing, stacked
edges, and unreadable labels. Stop automatic vision repair after two rounds.
When the drawio binary is unavailable or a visual check is inconclusive,
verify the renderer's own DOM instead (--dump-dom on the viewer URL, see
references/troubleshooting.md): read each edge's <path> segments and
label anchor coordinates directly — vision alone both misses geometry
defects and hallucinates new ones.
Show the draft and apply targeted edits. Preserve existing geometry for
local changes. Use sync for source-backed changes and write a reviewable
output; use --prune only when deletion was requested.
After approval, create final requested formats and report both editable source and export paths.
Resolve the available binary once (drawio, draw.io, the macOS app path, or
the Windows executable) and use that exact binary for the run.
# Draft for visual inspection: never use -e here
drawio -x -f png --width 2000 -o diagram.png diagram.drawio
# Final editable PNG
drawio -x -f png -e -s 2 -o diagram.drawio.png diagram.drawio
python3 scripts/repair_png.py diagram.drawio.png
# Final editable SVG/PDF
drawio -x -f svg -e --embed-svg-images -o diagram.svg diagram.drawio
drawio -x -f pdf -e -o diagram.pdf diagram.drawioDo not combine --width and -s. Embedded PNG exports require
repair_png.py; draft PNGs used by vision must not use -e. On Linux headless,
follow references/troubleshooting.md rather than improvising Electron flags.
If the CLI crashes in a macOS sandbox, try one permitted escalated run, then use
encode_drawio_url.py or deliver XML; do not repeatedly launch it.
0 or 1.<mxGeometry relative="1" as="geometry"/>.data-model-id, semantic properties, manual geometry, and
manual styles intact unless the user requests otherwise.edgeports.py; add waypoints when an
edge still crosses an unrelated shape. There is no CLI-only edge rerouter
that preserves node positions.An attractive diagram can still be wrong. Prefer source-backed relationships, show provenance where useful, distinguish exact extraction from AI inference, and keep architecture review findings framed as prompts. Story HTML must remain self-contained, keyboard usable, and include a text alternative. Never include secrets in node properties or provenance because they are embedded in outputs.
For all focused scripts and composition patterns, read references/toolbox.md;
load only the task-specific reference needed for the current request.
© Agents365-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 81 other files (scripts, references) in skills/drawio-skill of Agents365-ai/drawio-skill.
Open the folder on GitHubat commit 88fd923
Draw.io Diagram Studio 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Draw.io Diagram Studio this skillAgents365-ai/drawio-skill | 10k | — | ~2.4k | Automated safety check: Notes | MIT | |
| Drawio Skillyuanchen-home/cumcm-step-review | 319 | — | ~11k | Automated safety check: Pass | MIT | |
| Diagram Designcathrynlavery/diagram-design | 48k | 1 repos | ~7.6k | Automated safety check: Pass | MIT | |
| Generating Documentationancoleman/ai-design-components | 525 | — | ~3k | Automated safety check: Pass | MIT | |
| Engineer Design Diagramjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~4.5k | Automated safety check: Pass | MIT | |
| Documd Visualsmarkdown-viewer/skills | 3.4k | — | ~3.3k | Automated safety check: Pass | CC-BY-4.0 |
yuanchen-home/cumcm-step-review
A skill your agent uses when the user requests diagrams, flowcharts, architecture diagrams, ER diagrams, UML / sequence / class diagrams, SysML / MBSE diagrams (block definition, internal block…
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.
ancoleman/ai-design-components
Generate comprehensive technical documentation including API docs (OpenAPI/Swagger), code documentation (TypeDoc/Sphinx), documentation sites (Docusaurus/MkDocs), Architecture Decision Records…
jeremylongshore/tons-of-skills-marketplace
Generate production-grade engineering design diagrams (architecture, sequence, delta, drift) as self-contained dark-themed HTML files with accessible inline SVG.
markdown-viewer/skills
Create text-driven visuals in Markdown: charts, diagrams, cards, architecture and page layouts.
Raja0sama/vibex
Diagrams and checkable docs from a codebase. An agent skill from Raja0sama/vibex.
Categories
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools. drawio files instead of flattened pictures.py, unifies generation, incremental sync, multi-view projection, semantic queries, tests and reviews, failure analysis and accessible publishing over a shared diagram representation.
Draw.io Diagram Studio fits situations like: creating an editable draw.io architecture, UML, ERD, BPMN or network diagram; generating a diagram from Terraform, Kubernetes, SQL or OpenAPI sources; updating a generated diagram without losing manual layout; enforcing architecture rules or diagram diffs in CI.
Run `npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a claude-code`. Or copy the skill folder (skills/drawio-skill in Agents365-ai/drawio-skill) into .claude/skills/drawio-skill in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a codex`. Or copy the skill folder (skills/drawio-skill in Agents365-ai/drawio-skill) into .agents/skills/drawio-skill in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/drawio-skill, .gemini/skills/drawio-skill, .github/skills/drawio-skill and .opencode/skills/drawio-skill in your project.
Going by SKILL.md and its folder, Draw.io Diagram Studio needs the command-line tools its instructions call (python3). Our summary lists: draw.io or diagrams.net, to open and edit the files; Python, to run the bundled scripts. Its frontmatter pre-approves these tools: Bash, Read, Write, WebFetch.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Draw.io Diagram Studio is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 37k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Draw.io Diagram Studio: Drawio Skill (yuanchen-home/cumcm-step-review, 319 stars), Diagram Design (cathrynlavery/diagram-design, 48k stars), Generating Documentation (ancoleman/ai-design-components, 525 stars) and Engineer Design Diagram (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Agents365-ai (a GitHub user) maintains it in Agents365-ai/drawio-skill, which has 10,042 GitHub stars. The repository was last updated on October 2, 2026.
Source: Agents365-ai/drawio-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.