Repolode
Submit
Agents365-ai

Agents365-ai/drawio-skill

An agent skill that turns natural language and real system sources like Terraform, Kubernetes, SQL and OpenAPI into editable draw.io architecture diagrams.

Open-source alternative to:Lucidchart

View on GitHubWebsite
Stars
10,234
Forks
870
Open issues
0
Last commit
9 days ago

What is it?

drawio-skill is an Agent Skills-format package that generates maintainable .drawio architecture models from natural language prompts, code, infrastructure configs and schemas. It covers Terraform, Kubernetes and docker-compose with official cloud icons, SQL DDL to ER diagrams, OpenAPI, AsyncAPI, Protobuf and GraphQL to diagrams, and CI pipelines to DAGs. It also imports live infrastructure snapshots from terraform, docker and kubectl output.

Beyond one-off generation, the project focuses on keeping diagrams in sync with systems. Incremental sync updates changed nodes while preserving manually tuned layout, drift diffs compare two diagrams or snapshots, and YAML/JSON architecture rules can run as tests in CI. Diagrams can be exported to interactive HTML, PowerPoint, animated SVG, Mermaid or Markdown. The core workflows are stdlib-only, with draw.io desktop CLI as the main dependency.

Key features

  • 01Generates editable .drawio files from natural language and self-checks the rendered output
  • 02Imports Terraform, Kubernetes, docker-compose, SQL, OpenAPI, AsyncAPI, Protobuf and GraphQL sources
  • 03Incrementally syncs diagrams while preserving manual layout and annotations
  • 04Runs architecture rules as CI tests and drift diffs between diagrams
  • 05Exports to interactive HTML, PowerPoint, animated SVG, Mermaid and Markdown
  • 06Searches over 10,000 official draw.io shapes and 321 AI/LLM brand logos

Use cases

  • Documenting cloud infrastructure from Terraform or Kubernetes manifests with official provider icons
  • Enforcing architecture rules such as blocking direct internet-to-database access in pull requests
  • Tracking how a deployed system drifts from its documented architecture
  • Producing stakeholder decks or interactive architecture walkthroughs from existing code

Quick start

  1. 1

    Install the draw.io desktop CLI (macOS)

    brew install --cask drawio
  2. 2

    Install the skill for any agent

    npx skills add Agents365-ai/drawio-skill -g
  3. 3

    Verify the CLI installation

    drawio --version

Things to know

  • The full toolkit needs the draw.io desktop CLI, and version 30 or later is recommended for Mermaid conversion and ELK layout.
  • Windows and Linux CLI setup is more involved, and WSL2 uses the Windows desktop executable.

Topics

#architecture-diagram#drawio#diagrams-as-code#agent-skills#terraform#kubernetes#c4-model#architecture#asyncapi#bpmn

FAQ

What is drawio-skill?
An agent skill that turns natural language and real system sources like Terraform, Kubernetes, SQL and OpenAPI into editable draw.io architecture diagrams. drawio-skill is an Agent Skills-format package that generates maintainable .drawio architecture models from natural language prompts, code, infrastructure configs and schemas. It covers Terraform, Kubernetes and docker-compose with official cloud icons, SQL DDL to ER diagrams, OpenAPI, AsyncAPI, Protobuf and GraphQL to diagrams, and CI pipelines to DAGs. It also imports live infrastructure snapshots from terraform, docker and kubectl output.
Is drawio-skill free to use? What license does it have?
drawio-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is drawio-skill still maintained?
Actively maintained. The last commit to drawio-skill was on Oct 11, 2026.
What can I use drawio-skill for?
Documenting cloud infrastructure from Terraform or Kubernetes manifests with official provider icons Enforcing architecture rules such as blocking direct internet-to-database access in pull requests Tracking how a deployed system drifts from its documented architecture Producing stakeholder decks or interactive architecture walkthroughs from existing code
How do I install drawio-skill?
Install the draw.io desktop CLI (macOS): brew install --cask drawio Install the skill for any agent: npx skills add Agents365-ai/drawio-skill -g Verify the CLI installation: drawio --version
Where can I get drawio-skill?
The source code and installation instructions are on GitHub: https://github.com/Agents365-ai/drawio-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects