Skip to content
SkillScript-led2,198 tokens in use

Draw.io Architecture Studio

Creates and maintains editable draw.io diagrams from a description or from real sources such as Terraform, Kubernetes, SQL and OpenAPI, with checks, sync and export.

10,883 stars on the repository MIT LicenseAgents365-ai/drawio-skill · skills/drawio-skill
npx skills add Agents365-ai/drawio-skill -g
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Draw.io Architecture Studio costs

110tokens idle
2,198tokens in use
42,062tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/aiicons.py, scripts/asyncapiimports.py, scripts/autolayout.py, scripts/buildup.py, scripts/c4.py, scripts/ciimports.py, scripts/composeimports.py, scripts/compress.py, scripts/dbxicons.py, scripts/diagram_ir.py, scripts/diagramctl.py, scripts/diagramctl_mcp.py, scripts/dockerimports.py, scripts/drawio2mermaid.py, scripts/drawio2pptx.py, scripts/drawio_cli.py, scripts/drawiodiff.py, scripts/drawiohtml.py, scripts/edgeports.py, scripts/encode_drawio_url.py, scripts/explain.py, scripts/goimports.py, scripts/graphqlerd.py, scripts/heatmap.py, scripts/jsimports.py, scripts/k8simports.py, scripts/openapiimports.py, scripts/prdiff.py, scripts/protoimports.py, scripts/pyclasses.py, scripts/pyimports.py, scripts/raster2drawio.py, scripts/relabel.py, scripts/repair_png.py, scripts/restyle.py, scripts/runbook.py, scripts/rustimports.py, scripts/seqlayout.py, scripts/shapesearch.py, scripts/sqlerd.py, scripts/svgflow.py, scripts/tfimports.py, scripts/tfstate.py, scripts/timelapse.py, scripts/tubemap.py, scripts/validate.py.

Touches

shelldeclared and detectednetworkdeclared and detectedwrites filesdeclared and detected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter15/15
  • Structure25/25
  • Examples9/15
  • Output15/15
  • Size15/15
  • Resources12/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Runs shell commands−2

    does this on the machine, as the frontmatter declares

    SKILL.md, line 49
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    data/shape-index.json.gz
  • Reaches the network−5

    does this on the machine, as the frontmatter declares

    scripts/aiicons.py, line 32
  • Writes files−4

    does this on the machine, as the frontmatter declares

    scripts/asyncapiimports.py, line 273

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity92
  • Maintenance100
  • Community60
  • Maturity32
  • Momentum40

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.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers