Connexion
aktsmm

drawio-diagram-forge

by @aktsmm in DevOps & Cloud
4
0
# Install this skill:
npx skills add aktsmm/Agent-Skills --skill "drawio-diagram-forge"

Install specific skill from multi-skill repository

# Description

Generate draw.io editable diagrams (.drawio, .drawio.svg) from text, images, or Excel. Orchestrates 3-agent workflow (Analysis → Manifest → SVG generation) with quality gates. Use when creating architecture diagrams, flowcharts, sequence diagrams, or converting existing images to editable format. Supports Azure/AWS cloud icons.

# SKILL.md

name: drawio-diagram-forge
description: Generate draw.io editable diagrams (.drawio, .drawio.svg) from text, images, or Excel. Orchestrates 3-agent workflow (Analysis → Manifest → SVG generation) with quality gates. Use when creating architecture diagrams, flowcharts, sequence diagrams, or converting existing images to editable format. Supports Azure/AWS cloud icons.
license: CC BY-NC-SA 4.0
metadata:
author: yamapan (https://github.com/aktsmm)

Draw.io Diagram Forge

Generate draw.io editable diagrams using AI-powered workflow.

When to Use

  • Creating architecture diagrams (Azure, AWS)
  • Converting flowcharts from text descriptions
  • Transforming images/screenshots into editable format
  • Generating swimlane, sequence diagrams

Prerequisites

Tool Required
VS Code Yes
Draw.io Integration Yes
GitHub Copilot Yes

Quick Start

Create a login flow diagram

Generate an Azure Hub-Spoke architecture diagram

From inputs/requirements.md, create a system diagram

Output Formats

Extension Description When to Use
*.drawio Native format Recommended
*.drawio.svg SVG + metadata Markdown/Web
*.drawio.png PNG + metadata Image with edit

Output: outputs/

Workflow

USER INPUT → ORCHESTRATOR → MANIFEST GATEWAY → SVG FORGE → COMPLETED

Quality Gates

Score Action
90-100 Proceed
70-84 Fix and retry
50-69 Simplify
0-29 Ask user

Limits

Limit Value
Manifest revision 2
SVG revision 2
Total timeout 45min

Cloud Icons

→ references/cloud-icons.md

Enable in VS Code

  1. Open .drawio file
  2. Click "+ More Shapes" (bottom-left)
  3. Enable: Azure, AWS
  4. Apply

Azure Format (Critical)

<!-- WRONG -->
<mxCell style="shape=mxgraph.azure.front_door;..." />

<!-- CORRECT -->
<mxCell style="aspect=fixed;image=img/lib/azure2/networking/Front_Doors.svg;..." />

References

File Description
mxcell-structure.md mxCell XML structure
cloud-icons.md Azure/AWS icon guide
style-guide.md Node colors, edge styles

Scripts

Script Description
scripts/validate_drawio.py Validate mxCell structure

Troubleshooting

Issue Solution
Blank in draw.io Check content attribute
Edges not visible Verify node IDs
Icons missing Enable Azure/AWS shapes

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.