drawio-ai-kit skill
Skills and a CLI that teach an agent to draw valid draw.io diagrams for AWS, Azure, GCP, Databricks and BPMN with structure checks
- 672 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Installs a global CLI and runs shell commands
- Writes diagram files into the project
Install
- Works in
Manual install
npm i -g github:sparklabx/drawio-ai-kit && npx skills add sparklabx/drawio-ai-kitThe CLI on PATH plus all 5 domain skills. Restart the agent after installing.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Installs a global CLI and runs shell commands
- Writes diagram files into the project
This is third-party code. Review the repository files before installing.
What it does
A set of domain skills plus the drawio-ai CLI helps an agent build draw.io diagrams without invented icons or broken layout. It is backed by a catalog of real mxgraph stencils with their taxonomy and colors, a set of layout rules and a static XML validator that checks stencil references and geometry before saving. An optional visual self-check renders through the draw.io desktop app. Five domains are covered: AWS, Azure, GCP, Databricks and BPMN, with .drawio as the default output.
Who it is for. For developers, devops engineers and technical writers who need clean cloud architecture diagrams.
Good fit when
- You need an AWS, Azure, GCP or Databricks architecture diagram in draw.io
- You need a BPMN diagram with correct shapes
- The agent draws empty shapes or wrong icons and you need validation
Not a fit when
- You need a format other than draw.io, PNG or SVG
- The diagram is outside the supported domains and stencils
Example request
Draw an AWS diagram for a three-tier web appLimitations
It needs Node.js 18+, and the CLI installs from GitHub since it is not on the npm registry yet. The visual self-check needs the draw.io desktop app, and Graphviz helps with large graphs. Optional logo-icon fetching comes from public CDNs and is opt-in. There are no install hooks and no telemetry.
How to disable. Remove the CLI: npm uninstall -g drawio-ai-kit. Remove domain skills with npx skills remove drawio-aws and so on.
FAQ
Why do empty shapes not appear?
The catalog holds real stencil ids and the validator checks references and geometry before saving, so non-existent icons are rejected.
Is the draw.io desktop app required?
No. It is only for the render-based visual self-check; core generation and validation work without it.
How is drawio-ai-kit different from ordinary draw.io diagram generation?
Domain skills and the drawio-ai CLI build draw.io diagrams without invented icons or messy layout. The base is a catalog of real mxgraph stencils with taxonomy and colors for AWS, Azure, GCP, Databricks and BPMN, plus structure validation.
How do I install drawio-ai-kit for an agent?
Run npm i -g github:sparklabx/drawio-ai-kit and then npx skills add sparklabx/drawio-ai-kit. The skills work in Claude Code, Codex and Gemini CLI. Diagrams open in draw.io.
Discussion
No questions or reviews yet.
Related
SkillsA skill that turns a prompt into a draw.io AWS architecture file: 270 verified icons, layout rules and consistent styling.
Microsoft Learn skills for nearly every Azure service: limits, configuration, security, architecture and troubleshooting with doc links
A collection of Copilot skills and agents for Azure, API Management, Terraform and diagrams, installed via the skills CLI or APM
A Microsoft plugin with seven skills for Azure DevOps: backlog, work items, iterations, builds and security alerts.
Cisco's local MCP server: an agent designs a network and builds L1, L2 and L3 diagrams in SVG and PowerPoint plus a device table
A set of skills for agent work with AWS: common cloud service tasks packaged as ready instructions for a coding agent
README in short
The README describes a kit for generating draw.io diagrams through an agent. The core has three parts: a declarative catalog of mxgraph stencils with colors, a set of layout rules and a static XML validator. Everything is exposed through the dependency-free drawio-ai CLI. Five domain skills for AWS, Azure, GCP, Databricks and BPMN install via the skills CLI, which detects Claude Code, Codex and Gemini CLI. There are no install hooks and no telemetry. MIT licensed.