How do I install the Drawio skill?

Run npx skillmds@latest add github/drawio in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Drawio skill do?

Generate draw.io diagrams as .drawio files and export them to PNG, SVG, or PDF with embedded XML. It is listed under Docs & Writing, Design & Media, Diagrams & Charts, Illustration & Graphics on SkillMD.

Is Drawio safe to use?

SkillMD's automated safety review verdict for this skill is CAUTION. Independent scanners report: SkillSpector: WARNING, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Drawio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Drawio free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Drawio?

GitHub (Microsoft) (@github) published this skill as a verified publisher. Their other Agent Skills are listed on their SkillMD profile.

Drawio by github — Agent Skill

Name: Drawio
Rating: 4.2 (5 reviews)
Author: GitHub (Microsoft)

File contents

Draw.io Diagram Skill

Generate draw.io diagrams as native .drawio files and export them to PNG images that can be embedded in Word documents.

How to Create a Diagram

Generate draw.io XML in mxGraphModel format for the requested diagram
Write the XML to a .drawio file using the create/edit file tool
Export to PNG using the bundled export script

Bundled Export Script

This skill includes drawio-to-png.mjs, a Node.js export script with two rendering backends:

draw.io CLI (pixel-perfect, fastest) — used automatically if draw.io desktop is installed
Official draw.io viewer in headless browser (pixel-perfect, needs Chromium/Edge) — fallback when CLI is unavailable

Usage

# Install dependencies (one-time, from the scripts folder)
cd skills/drawio/scripts && npm install

# Export a single diagram
node skills/drawio/scripts/drawio-to-png.mjs <input.drawio> [output.png]

# Export all .drawio files in a directory
node skills/drawio/scripts/drawio-to-png.mjs --dir <directory>

# Force a specific renderer
node skills/drawio/scripts/drawio-to-png.mjs --renderer=cli|viewer|auto <input.drawio>

Skill Folder Contents

File	Purpose
`SKILL.md`	This instruction file
`scripts/drawio-to-png.mjs`	Node.js export script (CLI + browser fallback)
`scripts/package.json`	Dependencies (`puppeteer-core`)

Supported Export Formats

Format	Embed XML	Notes
`png`	Yes	Viewable everywhere, editable in draw.io
`svg`	Yes	Scalable, editable in draw.io
`pdf`	Yes	Printable, editable in draw.io

Draw.io XML Style Conventions

Use these styles for consistent, professional diagrams:

<!-- Primary service (highlighted) -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;strokeWidth=2;arcSize=12;shadow=1;" />

<!-- External system -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" />

<!-- Success/processing stage -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" />

<!-- Warning/quality gate -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" />

<!-- Error/failure path -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;" />

<!-- Data store (cylinder) -->
<mxCell style="shape=cylinder3;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" />

<!-- Arrow -->
<mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=1;strokeColor=#6c8ebf;strokeWidth=2;" />

Locating the draw.io CLI

Try drawio first (works if on PATH), then fall back:

Windows: "C:\Program Files\draw.io\draw.io.exe"
macOS: /Applications/draw.io.app/Contents/MacOS/draw.io
Linux: drawio (via snap/apt/flatpak)

CLI Export Command

drawio -x -f png -e -b 10 -o <output.png> <input.drawio>

Flags: -x (export), -f (format), -e (embed diagram XML), -b (border), -o (output path).

---name: drawiodescription: Generate draw.io diagrams as .drawio files and export them to PNG, SVG, or PDF with embedded XML.---# Draw.io Diagram SkillGenerate draw.io diagrams as native `.drawio` files and export them to PNG images that can be embedded in Word documents.## How to Create a Diagram1. **Generate draw.io XML** in `mxGraphModel` format for the requested diagram2. **Write the XML** to a `.drawio` file using the create/edit file tool3. **Export to PNG** using the bundled export script## Bundled Export ScriptThis skill includes `drawio-to-png.mjs`, a Node.js export script with two rendering backends:1. **draw.io CLI** (pixel-perfect, fastest) — used automatically if draw.io desktop is installed2. **Official draw.io viewer in headless browser** (pixel-perfect, needs Chromium/Edge) — fallback when CLI is unavailable### Usage```bash# Install dependencies (one-time, from the scripts folder)cd skills/drawio/scripts && npm install# Export a single diagramnode skills/drawio/scripts/drawio-to-png.mjs <input.drawio> [output.png]# Export all .drawio files in a directorynode skills/drawio/scripts/drawio-to-png.mjs --dir <directory># Force a specific renderernode skills/drawio/scripts/drawio-to-png.mjs --renderer=cli|viewer|auto <input.drawio>```### Skill Folder Contents| File | Purpose ||------|---------|| `SKILL.md` | This instruction file || `scripts/drawio-to-png.mjs` | Node.js export script (CLI + browser fallback) || `scripts/package.json` | Dependencies (`puppeteer-core`) |## Supported Export Formats| Format | Embed XML | Notes ||--------|-----------|-------|| `png` | Yes | Viewable everywhere, editable in draw.io || `svg` | Yes | Scalable, editable in draw.io || `pdf` | Yes | Printable, editable in draw.io |## Draw.io XML Style ConventionsUse these styles for consistent, professional diagrams:```xml<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;strokeWidth=2;arcSize=12;shadow=1;" /><mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" /><mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" /><mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" /><mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;" /><mxCell style="shape=cylinder3;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" /><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=1;strokeColor=#6c8ebf;strokeWidth=2;" />```## Locating the draw.io CLITry `drawio` first (works if on PATH), then fall back:- **Windows**: `"C:\Program Files\draw.io\draw.io.exe"`- **macOS**: `/Applications/draw.io.app/Contents/MacOS/draw.io`- **Linux**: `drawio` (via snap/apt/flatpak)### CLI Export Command```bashdrawio -x -f png -e -b 10 -o <output.png> <input.drawio>```Flags: `-x` (export), `-f` (format), `-e` (embed diagram XML), `-b` (border), `-o` (output path).

Frequently asked questions

Drawio