drawio-skill

drawio-skill is a free, open-source Agent Skill by Agents365-ai that draws diagrams as editable .drawio files rather than flat pictures. Describe what you want, or point it at your code, infrastructure or schemas, and it plans the layout, writes the draw.io XML, exports it, checks its own render and fixes overlaps before showing you. It's a community project, not from draw.io (JGraph). What you can do with it - Describe a diagram and get an editable .drawio: architecture, C4, UML class and sequence, ER, BPMN, SysML, network topology, swimlanes, flowcharts and ML model diagrams - Turn real sources into diagrams: Python, JS/TS, Go and Rust import graphs, Terraform, Kubernetes and docker-compose with official AWS, Azure, GCP and Kubernetes icons, SQL DDL, OpenAPI, AsyncAPI, Protocol Buffers, GraphQL and CI pipelines - Snapshot what's actually deployed from terraform show, docker inspect or kubectl output - Rebuild a whiteboard photo or an old PNG as an editable diagram - Write Mermaid (mind maps, Gantt, timelines, kanban and more) and convert it to native draw.io - Keep diagrams current: sync a diagram from its changed source without losing your manual layout, and diff two versions in colour - Ask questions of an architecture: query paths and owners, test it against rules (for example, nothing from the internet straight to a database), review it, or simulate what fails when one part goes down - Share it as an interactive HTML viewer, a PowerPoint deck, an animated SVG, Mermaid, Markdown or an accessible walkthrough - Use the real shapes: it searches draw.io's official shape library for exact AWS, Cisco, Kubernetes, UML and BPMN icons, and adds AI and LLM brand logos draw.io lacks - Apply built-in style presets (corporate, hand-drawn, colour-blind safe, dark) or teach it your own style from a diagram How it connects - Install it with npx skills add Agents365-ai/drawio-skill -g, or clone the repo and link its skills/drawio-skill folder into your agent's skills folder. - Exports need the draw.io desktop app (version 30 or newer for Mermaid conversion). Automatic layout needs Graphviz; the core workflows need only Python 3 and work offline. - An optional MCP server (scripts/diagramctl_mcp.py) exposes build, sync, views, query, review, what-if and walkthrough tools to MCP hosts. Good to know - In Claude Code it doesn't load on its own: call it by name with /drawio-skill. - There's no account or sign-in. Diagrams and exports are written to your working folder. - AI brand logos load from a public CDN when the diagram renders, unless you ask it to embed them. - The maker documents it for Claude Code, Cursor, GitHub Copilot, OpenClaw, Codex, Hermes and more.

• “Create a microservices e-commerce architecture with an API gateway, auth, order and payment services, Kafka and a Redis cache.”

  Copy

• “Draw a diagram of our AWS setup from the Terraform in ./infra, with official icons.”

  Copy

• “Turn this SQL schema into an ER diagram.”

  Copy

• “Visualize the module structure of this Python project.”

  Copy

• “Turn this whiteboard photo into an editable draw.io diagram.”

  Copy

• “Draw a microservices architecture using my corporate style.”