drawio-skills

Pick The Right Skill

Use skills/drawio for general diagrams, architecture, network topology, Agent and memory systems, UML/ER, flowcharts, org charts, Mermaid/CSV conversion, existing .drawio files, themes, and style presets.

Use skills/drawio-academic-skills for papers, theses, dissertations, journals, IEEE/ACM submissions, manuscripts, camera-ready packages, and other publication figures. The overlay requires sibling ../drawio; it does not copy the base runtime and never requires MCP.

Runtime Model

1. Offline authoring: normalize input to YAML, validate it, and generate native .drawio.
2. Desktop-enhanced delivery: produce the default 300 DPI PNG or requested PDF/JPG/embedded SVG.
3. Offline fallback: when Desktop is unavailable, report the missing export and use standalone SVG.
4. Optional live refinement: base-skill browser editing only when explicitly requested.

Keep .spec.yaml, .arch.json, normalized YAML, and diagnostics in a project work directory. The default final delivery contains editable .drawio and a 300 DPI PNG, or SVG fallback when Desktop is unavailable.

Quick Start

npx skills add bahayonghang/drawio-skills

/drawio create a horizontal service architecture with an API, queue, worker, and database

Before using vendor stencils, search the bundled catalog:

node skills/drawio/scripts/cli.js search pod --prefix kubernetes

Render and validate:

node skills/drawio/scripts/cli.js input.yaml final/diagram.drawio --validate --write-sidecars --sidecar-dir .drawio-tmp/diagram
node skills/drawio/scripts/cli.js input.yaml final/diagram.png --validate --use-desktop

For publication work:

/drawio-academic-skills create an IEEE workflow figure with grayscale-safe semantics and a PDF submission export

Documentation Map

• Workflows: create, edit/import, replicate, and academic routing
• Design System: specifications, types, themes, icons, and connectors
• Architecture Diagrams and Agent Diagrams
• CLI Reference and Export and Artifacts
• Examples: prompts and reusable YAML

Source Of Truth

The public contract starts in skills/drawio/SKILL.md and skills/drawio-academic-skills/SKILL.md. Their routed workflow and reference files provide deeper rules. The site organizes those contracts for users; it does not replace them.

This site is open source. Improve this page.