Verified project record

Agents365-ai/drawio-skill

drawio-skill is a reusable agent skill that generates editable draw.io diagrams from natural-language descriptions, codebases, infrastructure definitions, schemas, and existing diagrams. It performs automatic layout, validation, self-checking, and exports into multiple visual and documentation formats.

Project overview

The skill converts natural language and structured sources into self-checking, auto-laid-out editable diagrams and runs from a single SKILL.md with no MCP server or background daemon. Note that the documented workflow depends on the separately installed draw.io desktop CLI, uses Graphviz for automatic layout, and may require network access at render time for default CDN-referenced logos.

Project type: AI Coding
Deployment: Refer to project documentation
License: MIT

Best for

Developers who want to turn natural-language descriptions, codebases, Terraform, Kubernetes, docker-compose, or schemas into editable draw.io diagrams without manual coordinates and formatting.
AI engineers and teams using Agent Skills-compatible agents who need diagram generation, layout, validation, and multi-format export within their existing agent workflow, provided they can support the required draw.io desktop CLI and Graphviz dependencies.

Key capabilities

Converts natural-language descriptions into editable .drawio XML, lays out the diagram, exports it, self-checks the result, and supports iterative refinement.
Provides 11 documented presets including ERD, UML, sequence, C4, architecture, ML, flowcharts, SysML, BPMN, network topology, and swimlanes.
Extracts structures from Python, JavaScript/TypeScript, Go, Rust, Terraform, Kubernetes, docker-compose, SQL DDL, OpenAPI, CI configurations, and live infrastructure inputs into diagrams.
Automatically places nodes and routes edges, performs transitive reduction and nested grouping, and validates diagrams for issues such as dangling edges, duplicate IDs, and overlaps.
Transforms diagrams into structured Markdown, PowerPoint decks, interactive HTML, animated SVG, Mermaid flowcharts, language variants, themed diagrams, heat maps, and time-lapse players.
Searches official draw.io shape sets and resolves AI, LLM, and data-store brand logos for use in diagrams.

Limitations and risks

Mermaid conversion and the ELK layout pass require draw.io version 30 or later; those features are unavailable on versions 29 or earlier.
Graphviz is needed for the documented automatic layout path, although the README states it is optional and other functionality works without it.
AI and LLM logos use CDN references by default and therefore need network access at render time unless embedded.
The documented generation and export workflow depends on the separately installed native draw.io desktop CLI.
Default CDN-referenced logo assets can make rendering dependent on network availability.

Getting started

Install the draw.io desktop CLI using the platform-specific commands documented in the README, then install the skill itself. Install Graphviz if the documented automatic layout path is required. After setup, describe the desired diagram to a compatible agent to begin generation.

Evidence and sources

Open original GitHub project