drawio-skill
ActiveDescription
An Agent Skill turning natural language, codebases, Terraform or SQL into maintainable .drawio architecture diagrams, with layout-preserving sync, architecture tests and a built-in MCP server.
Key Features
- Multi-source import — 13 extractors cover Python/JS/Go/Rust import graphs, Terraform/K8s/docker-compose resources, SQL DDL, OpenAPI and CI pipelines
- Layout-preserving incremental sync — diagramctl sync updates only changed nodes and relations while tuned coordinates, styles and annotations survive
- Diagram-as-Test — YAML/JSON rules check tier violations, cycles, orphans and more, with an official GitHub Action for CI
- Official shape search — resolves among 10000+ official draw.io shapes and 321 AI/LLM brand logos instead of blank-box guesses
- Built-in MCP server — diagramctl_mcp.py exposes nine tools, stdlib-only and offline, for Claude Desktop, Cursor and other hosts
- Self-check with auto-fix — reads its own PNG output and fixes overlaps, clipped labels and stacked edges in up to two rounds, plus a five-round feedback loop
Use Cases
Strengths & Limitations
✅ Strengths
- • Actively maintained, recent updates
- • High community interest (9.2k stars)
- • Permissive open-source license (MIT)
- • Responsive to issues, low backlog
Categories
Quick Start
# Install the draw.io desktop CLI (macOS, version 30+ recommended)
brew install --cask drawio
# Install the skill for any agent
npx skills add Agents365-ai/365-skills -g
# Or clone manually into your skills folder
git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-skill