drawio

name	drawio
version	2.2.0
description	Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow. Use for general engineering and product diagrams: architecture, network topologies, flowcharts, UML/ER, org charts, Mermaid/CSV conversion, existing .drawio bundles, style presets, themes, and non-publication formula diagrams. For paper, thesis, journal, conference, IEEE/ACM, manuscript, camera-ready, or publication figures, prefer drawio-academic-skills; this base provides shared CLI, references, themes, schemas, styles, and optional Desktop export.
license	MIT
homepage	https://github.com/bahayonghang/drawio-skills
compatibility	Node 20+ for the YAML/CLI workflow. draw.io Desktop is optional and only needed for PNG/PDF/JPG or embedded .drawio.svg exports. No MCP server is required for offline authoring; the optional live-refinement backend needs a browser/MCP provider.
platforms	["macos","linux","windows"]
metadata	{"category":"visual-design","tags":["diagram","drawio","architecture","flowchart","network-topology","uml","mermaid","csv","design-system","math"]}
argument-hint	["diagram-description-or-instruction"]
allowed-tools	Read, Write, Bash, AskUserQuestion

Draw.io Base Skill

Create, edit, validate, replicate, import, and export draw.io diagrams through the shared YAML-first Draw.io Base Skill.

This package is the single maintained base capability surface for sibling overlays. It owns the local CLI, schemas, shared references, themes, reusable examples, style presets, Desktop export helpers, diagrams.net URL fallback, and optional live-refinement backend.

Scope

Use this base skill for general draw.io work:

• software and system architecture diagrams
• network topologies and infrastructure maps
• flowcharts, swimlanes, process maps, and org charts
• UML class, sequence, state, and ER diagrams
• Mermaid and CSV conversion into draw.io
• structured redraw and non-academic replication
• formula-bearing technical diagrams
• .drawio import, sidecar export, and local validation

For paper, thesis, IEEE, journal, manuscript, or publication-ready figure requests, use drawio-academic-skills as the policy overlay. The overlay depends on this sibling base for execution; the base does not automatically apply academic publication gates.

Runtime Stack

Use the lightest path that satisfies the request.

Runtime	Role	Source of truth	Notes
Offline Authoring Path	Default create/edit/replicate/import/export	YAML spec in project work dir	Generates final .drawio and .drawio.svg locally; keeps .spec.yaml and .arch.json in a separate work dir unless explicitly requested beside the output.
Desktop-Enhanced Export	Optional final export	Existing offline bundle	Adds PNG/PDF/JPG or embedded .drawio.svg when draw.io Desktop is available.
Live Refinement Backend	Optional browser refinement provider	Offline bundle remains canonical	Use only when the user explicitly wants browser/inline iteration and required live capabilities exist.
Direct XML Exception	Tiny one-off or raw mxGraph handoff	.drawio XML	Use only when YAML/CLI is unavailable or exact XML control is the real requirement.

The optional MCP/live backend is a refinement provider only. Do not treat it as required for normal authoring, editing, import, replication, or export.