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/
If the user asks for an editable diagram, make *.drawio the primary deliverable. Do not let a plain SVG or preview artifact become the file the user is expected to edit.
When the deliverable is headed for print, gate it on the Monochrome Print Profile and the Pre-delivery Geometry Sweep in style-guide.md before any visual review.
Limits
Limit
Value
Manifest revision
2
SVG revision
2
Total timeout
45min
Cloud Icons
Use Cloud Icons Reference. Azure diagrams must use verified img/lib/azure2/**/*.svg image paths, retain short service labels, and fall back to neutral boxes only when an icon is missing or misleading.
Enable Azure/AWS shapes (+ More Shapes → Azure / AWS)
Text overlaps near outer frame
Inset top callout 16–24px, increase height, wrap to 3–4 lines; review at actual embed width
Done Criteria
.drawio or .drawio.svg file generated
Diagram opens correctly in VS Code Draw.io extension
If an editable .drawio.svg is part of the delivery, it was exported with --embed-diagram and contains mxfile
All nodes and edges visible
User-facing links point to the editable .drawio when editability is expected
Decision flows avoid long return/merge lines that bundle branch outputs back into one sink
Quality gate score ≥ 85
If diagram is referenced from documentation, both editable source and embeddable image are provided
Render review completed at the target embed width: no text overlap, clipping, or border collisions, no edges overlapping on one line, no edge endpoint buried inside a filled box, no label riding on a box or another label, no node outside the page
After any edge or label layout change, re-export the delivery asset for the target medium (SVG for web, PNG or the final PDF for print) and inspect it; structural validation alone does not prove visual routing quality
1---
2name: drawio-diagram-forge
3description: 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. Triggers on draw.io, drawio, ダイアグラム, 図解, アーキ図, フローチャート, シーケンス図.
4argument-hint: "図にしたい文章・画像・Excel、図の種類"
5user-invocable: true
6license: CC BY-NC-SA 4.0
7metadata:
8 source: https://skillmd.com/skills/aktsmm/drawio-diagram-forge
9 author: yamapan (https://github.com/aktsmm)
10---
1112# Draw.io Diagram Forge
1314Generate **draw.io editable diagrams** using AI-powered workflow.
1516## When to Use
1718- Creating architecture diagrams (Azure, AWS)
19- Converting flowcharts from text descriptions
20- Transforming images/screenshots into editable format
21- Generating swimlane, sequence diagrams
22- Editing Azure/AWS icons in existing .drawio files
2324Choose this skill when the result will need later **GUI editing** in draw.io, cloud icons, or documentation-facing diagram assets.
2526## When NOT to Use
2728- Quick inline diagrams that are easier to keep as Mermaid in README or Markdown
29- One-off text-native diagrams where manual GUI adjustment is not expected
30- Charts or infographics that require exact axes, data binding, typography, or scripted regeneration
31- Large multilingual label sets whose font rendering must be identical across platforms
3233## Prerequisites
3435| Tool | Required |
36| ----------------------------------------------------------------------------------------------- | -------- |
37| VS Code | Yes |
38| [Draw.io Integration](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) | Yes |
39| GitHub Copilot | Yes |
4041## Quick Start
4243```
44Create a login flow diagram
45```
4647```
48Generate an Azure Hub-Spoke architecture diagram
49```
5051```
52From inputs/requirements.md, create a system diagram
53```
5455## Output Formats
5657| Extension | Description | When to Use |
58| -------------- | -------------- | --------------- |
59| `*.drawio` | Native format | **Recommended** |
60| `*.drawio.svg` | SVG + metadata | Markdown/Web |
61| `*.drawio.png` | PNG + metadata | Image with edit |
6263**Output**: `outputs/`
6465If the user asks for an editable diagram, make `*.drawio` the primary deliverable. Do not let a plain SVG or preview artifact become the file the user is expected to edit.
6667### Recommended Delivery Pattern
6869ドキュメント向けは `name.drawio` (editable) + `name.drawio.svg` (embed) を対で出す。多言語変体・Qiita への掲載・ローカル preview 脱出手順は → [references/delivery-patterns.md](references/delivery-patterns.md)。
7071## Workflow
7273```
74USER INPUT → ORCHESTRATOR → MANIFEST GATEWAY → SVG FORGE → COMPLETED
75```
7677### Quality Gates
7879| Score | Action |
80| ------ | ------------- |
81| 90-100 | Proceed |
82| 70-84 | Fix and retry |
83| 50-69 | Simplify |
84| 0-29 | Ask user |
8586When the deliverable is headed for print, gate it on the Monochrome Print Profile and the Pre-delivery Geometry Sweep in [style-guide.md](references/style-guide.md) before any visual review.
8788### Limits
8990| Limit | Value |
91| ----------------- | ----- |
92| Manifest revision | 2 |
93| SVG revision | 2 |
94| Total timeout | 45min |
9596## Cloud Icons
9798Use [Cloud Icons Reference](references/cloud-icons.md). Azure diagrams must use verified `img/lib/azure2/**/*.svg` image paths, retain short service labels, and fall back to neutral boxes only when an icon is missing or misleading.
99100## References
101102| File | Description |
103| ----------------------------------------------------- | ------------------------ |
104| [mxcell-structure.md](references/mxcell-structure.md) | mxCell XML structure |
105| [cloud-icons.md](references/cloud-icons.md) | Azure/AWS icon guide |
106| [style-guide.md](references/style-guide.md) | Node colors, edge styles |
107| [delivery-patterns.md](references/delivery-patterns.md) | Editable + embed pair, Qiita, multilingual |
108| [troubleshooting.md](references/troubleshooting.md) | Full troubleshooting (21 items) |
109110## Scripts
111112| Script | Description |
113| ---------------------------- | ------------------------- |
114| `scripts/validate_drawio.py` | Validate mxCell structure |
115116## Troubleshooting
117118頻度高トップ 4 件を下記に掲載。全一覧(フレーム/エッジ/余白/PDF 出力、レジェンド位置、エスケープ層、CLI の export オプション 等 24 項目)は [references/troubleshooting.md](references/troubleshooting.md)。
119120| Issue | Solution |
121| --- | --- |
122| Blank in draw.io | Check `content` attribute |
123| Edges not visible | Verify node IDs |
124| Icons missing | Enable Azure/AWS shapes (+ More Shapes → Azure / AWS) |
125| Text overlaps near outer frame | Inset top callout 16–24px, increase height, wrap to 3–4 lines; review at actual embed width |
126127## Done Criteria
128129- [ ] `.drawio` or `.drawio.svg` file generated
130- [ ] Diagram opens correctly in VS Code Draw.io extension
131- [ ] If an editable `.drawio.svg` is part of the delivery, it was exported with `--embed-diagram` and contains `mxfile`
132- [ ] All nodes and edges visible
133- [ ] User-facing links point to the editable `.drawio` when editability is expected
134- [ ] Decision flows avoid long return/merge lines that bundle branch outputs back into one sink
135- [ ] Quality gate score ≥ 85
136- [ ] If diagram is referenced from documentation, both editable source and embeddable image are provided
137- [ ] Render review completed at the target embed width: no text overlap, clipping, or border collisions, no edges overlapping on one line, no edge endpoint buried inside a filled box, no label riding on a box or another label, no node outside the page
138- [ ] After any edge or label layout change, re-export the delivery asset for the target medium (SVG for web, PNG or the final PDF for print) and inspect it; structural validation alone does not prove visual routing quality
Run npx get-skill add aktsmm/drawio-diagram-forge in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
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. Triggers on draw.io, drawio, ダイアグラム, 図解, アーキ図, フローチャート, シーケンス図. It is listed under DevOps & Infra on SkillMD.
SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under CC BY-NC-SA 4.
aktsmm (@aktsmm) published this skill. Their other Agent Skills are listed on their SkillMD profile.