Draw.io Architecture Studio produces .drawio files that stay editable. You can describe a diagram in words, or point it at code, infrastructure files, schemas and CI configs, and it builds a shared model from them with a command line tool called diagramctl.
The same tool updates an existing diagram without losing hand-tuned layout, projects several views from one model, tests diagrams against architecture rules, reviews them, simulates failures and exports to PNG, SVG, PDF, HTML or PowerPoint. The draw.io desktop app is needed for native export.
What You Get
- Editable .drawio files plus PNG, SVG or PDF exports with the source embedded
- A validation score and a visual self-check of the first draft, with up to two repair rounds
- Incremental sync that updates a generated diagram while keeping manual layout
- Multiple views such as executive, system, deployment, data flow and security from one model
- Query, policy test, review, what-if and walkthrough outputs for an architecture
Common Use Cases
- Draw a microservices architecture from a short description
- Turn a Terraform folder into an architecture diagram with official cloud icons
- Generate an ER diagram from SQL or an API diagram from an OpenAPI file
- Keep a diagram current as the infrastructure code changes, without redoing the layout
- Check a diagram against rules in CI, such as no direct internet access to a database
What Makes It Unique
Many diagram skills draw a picture once. This one separates meaning, source provenance and geometry in a model, so a regenerated diagram keeps manual positions and removals stay reviewable. It also treats diagrams as testable artifacts, with rules, failure simulation and a text-accessible walkthrough, and it requires the agent to look at its own exported image before showing it.
Under The Hood
The agent reads SKILL.md and the reference file for the task, then runs bundled Python scripts through the shell, starting with diagramctl. Core commands run offline using only the Python standard library. Native export launches the locally installed draw.io command line app, auto-layout launches Graphviz, and some workflows run git. Live infrastructure views read JSON that you supply from terraform, docker or kubectl. Icon embedding can download pinned icon URLs, and the SKILL.md lists WebFetch among its allowed tools. The skill writes diagram, image and report files in your working directory and can optionally run an MCP server. Its notes warn against putting secrets in node properties because they are embedded in outputs.