drawio-skill

The Draw.io Diagrams skill generates .drawio XML diagrams and exports them to PNG, SVG, PDF, and JPG locally using the native draw.io desktop application CLI, with no browser automation required. It solves the problem of producing precise, polished, richly-styled technical diagrams — architecture, network, strict UML, ER diagrams, SysML/MBSE, BPMN, swimlanes, cloud topology, and ML/DL model figures — while keeping the exported images editable (PNG/SVG/PDF exports support embedding the full diagram XML so the file reopens as an editable diagram).

The skill bundles roughly 31 helper scripts and a set of reference documents, grouped by use case: authoring XML, importing code (Python, Go, JavaScript, Rust, Docker, Compose), importing infrastructure-as-code (Terraform, Kubernetes), importing API specs (OpenAPI), rendering live infrastructure, comparing and annotating diagrams, and reverse-exporting. A shape search index of over 10,000 official draw.io shapes (AWS, Azure, GCP, Cisco, Kubernetes, UML, BPMN, P&ID, electrical) lets it resolve exact style strings instead of guessing. It supports learnable style presets, optional Graphviz-based auto-layout, and a vision-model self-check step that is gracefully skipped when unavailable. The live-infrastructure recipes read local tool state from terraform, docker, and kubectl that the user has already authenticated — the skill parses only the JSON those tools print and never reaches out to a cloud account itself.

It targets engineers, architects, and technical writers on macOS, Linux, or Windows who need diagrams-as-artifacts with strict styling and exportable output. It explicitly routes casual whiteboard sketches to excalidraw/tldraw and diagrams-as-code to mermaid/plantuml.