Skip to content
Get packs

drawio-skill

An agent skill that turns text and code/infra sources into editable draw.io architecture diagrams.

GitHub Download v3.4.2
Stars
10.5k
Forks
726
Licence
MIT
Language
Python
Last update
5 days ago
Type
AI model / agent

What it is

drawio-skill is an add-on for AI coding agents such as Claude Code and Cursor. You describe a system in plain language, or point it at sources like Terraform, Kubernetes, SQL, or OpenAPI files, and it produces an editable draw.io diagram. It can also re-sync diagrams when the source changes while keeping manual layout tweaks, and export to HTML, PowerPoint, or Mermaid.

  • Generate a Transformer architecture diagram from a plain-language description, as shown in the Quick Start
  • Turn Terraform or docker-compose configs into a diagram with cloud provider icons
  • Convert OpenAPI or GraphQL schemas into API or entity diagrams
  • Run architecture rules as checks in CI on pull requests

Great for

  • Developers who want architecture diagrams generated from existing infrastructure or schema files
  • Teams that keep diagrams in version control and want CI checks on architecture rules
  • People already working inside Claude Code, Cursor, or another Agent Skills-compatible agent
  • Anyone who wants to turn a whiteboard photo or legacy PNG into an editable diagram

Not ideal for

  • Users who do not have the draw.io desktop CLI and do not want to install it, since the README treats it as a core requirement
  • People who want a standalone GUI diagram editor rather than an agent skill
  • Users who need guaranteed-perfect layouts without manual touch-up, since the README describes automated layout with self-checks but not perfection
Step-by-step guide: how to use drawio-skillInstall, first run, examples, tips and FAQs
drawio-skill alternativesdiagram-design vs drawio-skilldrawio-skill vs Mermaiddrawio-skill vs Ponytail

How to get it

  1. 1

    Install with a package manager

    You'll need: draw.io desktop CLI (version 30 or later recommended) · An agent that supports Agent Skills, such as Claude Code or Cursor · Python

    Install the skill with the skills CLI (any agent)

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

    Install draw.io desktop CLI on macOS

    brew install --cask drawio
  2. 2

    Run it

    • Install the draw.io desktop CLI and confirm with drawio --version
    • Install the skill into your agent
    • Describe the diagram you want in natural language or point the skill at a source file
    • Review the generated .drawio file and export it to your chosen format
  3. 3

    Get the most out of it

    • Use the Mermaid to .drawio conversion (draw.io 30 or later) to get laid-out editable diagrams from structured text
    • Use the diagramctl sync command to update diagrams without losing manual layout
    • Add YAML or JSON architecture rules and run them in CI with the official GitHub Action
    • Use the interactive HTML or PowerPoint export to share diagrams with non-technical readers

Downloads

Source code (.zip)main branch · straight from GitHubRelease v3.4.2Release notes and sourceOfficial website & docsagents365-ai.github.io/drawio-skill/

Strengths

  • Diagrams stay editable .drawio files rather than locked images
  • Incremental sync is designed to preserve manual layout changes
  • Supports many import sources and export formats, with core workflows described as stdlib-only and offline

Trade-offs

  • Needs the draw.io desktop CLI installed, and some features require version 30 or later
  • The README is long and feature-dense, so the set of capabilities is broad and not all parts are clearly verified here

How it compares

ProjectStarsTypeLevelUpdatedBest for
drawio-skill (this)10.5kAI model / agentintermediate5 days agoDevelopers who want architecture diagrams generated from existing infrastructure or schema files
mermaid91kDev toolbeginner4 days agoDevelopers who want diagrams stored as text alongside their code and docs
diagram-design64.2kAI model / agentbeginner5 days agoDevelopers who already use a supported coding agent and want architecture or flow diagrams without learning a diagram language
ponytail182kAI model / agentbeginner8 days agoDevelopers who use Claude Code or similar AI agents and find the generated code too long
humanizer63.8kAI model / agentbeginner9 days agoWriters who draft with an AI and want the final text to sound more natural
rea421kAI model / agentintermediate4 days agoDevelopers studying how a feature in an existing app works without its source code

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.