本文へ移動
cccskills
無料GitHub で公開

drawio-diagram-forge

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, ダイアグラム, アーキ図, フローチャート, シーケンス図.

インストール方法を見る

含まれるファイル(8)

  • SKILL.md7.2 KB
  • LICENSE.txt5.2 KB
  • references/cloud-icons.md28.3 KB
  • references/delivery-patterns.md2.1 KB
  • references/mxcell-structure.md3.3 KB
  • references/style-guide.md16.7 KB
  • references/troubleshooting.md22.2 KB
  • scripts/validate_drawio.py8.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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
  • Editing Azure/AWS icons in existing .drawio files

Choose this skill when the result will need later GUI editing in draw.io, cloud icons, or documentation-facing diagram assets.

When NOT to Use

  • Quick inline diagrams that are easier to keep as Mermaid in README or Markdown
  • One-off text-native diagrams where manual GUI adjustment is not expected
  • Charts or infographics that require exact axes, data binding, typography, or scripted regeneration
  • Large multilingual label sets whose font rendering must be identical across platforms
  • Interactive or animated HTML diagrams, or Mermaid beautification (out of scope)

Prerequisites

ToolRequired
VS CodeYes
Draw.io IntegrationYes
GitHub CopilotYes

Quick Start

Create a login flow diagram
Generate an Azure Hub-Spoke architecture diagram
From inputs/requirements.md, create a system diagram

Output Formats

ExtensionDescriptionWhen to Use
*.drawioNative formatRecommended
*.drawio.svgSVG + metadataMarkdown/Web
*.drawio.pngPNG + metadataImage 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.

Recommended Delivery Pattern

ドキュメント向けは name.drawio (editable) + name.drawio.svg (embed) を対で出す。多言語変体・Qiita への掲載・ローカル preview 脱出手順は → references/delivery-patterns.md。

Workflow

Treat generated images as optional layout references, not requirement evidence. Resolve labels, nodes, groups and edge directions in the manifest; flag ambiguity instead of inventing content. Rebuild native mxCells and connectors; wrapping a raster image in draw.io metadata does not make its elements editable.

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

Quality Gates

ScoreAction
85-100Proceed
70-84Fix and retry
50-69Simplify
0-49Ask user

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

LimitValue
Manifest revision2
SVG revision2
Total timeout45min

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.

References

FileDescription
mxcell-structure.mdmxCell XML structure
cloud-icons.mdAzure/AWS icon guide
style-guide.mdNode colors, edge styles
delivery-patterns.mdEditable + embed pair, Qiita, multilingual
troubleshooting.mdFull troubleshooting (24 items)

Scripts

ScriptDescription
scripts/validate_drawio.pyValidate mxCell structure

Troubleshooting

頻度高トップ 4 件を下記に掲載。全一覧(フレーム/エッジ/余白/PDF 出力、レジェンド位置、エスケープ層、CLI の export オプション 等 24 項目)は references/troubleshooting.md。

IssueSolution
Blank in draw.ioCheck content attribute
Edges not visibleVerify node IDs
Icons missingEnable Azure/AWS shapes (+ More Shapes → Azure / AWS)
Text overlaps near outer frameInset 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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

agentic-workflow-guide

無料日本語概要

Design, review, and debug agent workflows, and decide when a request should use a prompt, instruction, skill, agent, or hook before escalating to multi-agent design. Use for .agent.md / .instructions.md / .prompt.md / AGENTS.md work, workflow architecture, orchestration planning, scheduled automation model allocation, or when agent workflows may be overkill. Triggers on 'agent workflow', 'create agent', 'automation models', 'ワークフロー設計', 'orchestrator'.

aktsmm/Agent-Skills262026年10月10日 更新

Design, run, and review fair performance, token, and cost comparisons across GitHub Copilot CLI, Codex CLI, and direct model APIs. Use for AI CLI benchmark, Copilot vs Codex, prompt-cache diagnosis, cache read/write analysis, fresh-process latency measurement, token-cost comparison, or when a benchmark must separate provider caching from local CLI caches.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月10日 更新

Analyze historical VS Code GitHub Copilot Chat sessions by model, reasoning effort, AIU, time, reliability, workflow behavior, and external quality evidence, or safely prune workspace-scoped local chat history by age. Use for session analysis, repeated-task retrospectives, model evaluation, cost/performance analysis, and old session cleanup.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月10日 更新

animated-infographic

無料日本語概要

Create reproducible animated infographic GIFs from structured data or measured results, with audience-language labels, explicit timing semantics, representative-frame QA, and a static fallback. Use when asked for GIF生成, animated infographic, 動的インフォグラフィック, 結果が流れる図, animated benchmark, or a blog/SNS animation whose displayed metrics must remain traceable to source data.

aktsmm/Agent-Skills262026年10月10日 更新

archify

無料日本語概要

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid. Also use for Archify, interactive or animated HTML diagrams, インタラクティブ図, 動く構成図. When an editable .drawio file is required, use the draw.io workflow instead and treat Archify HTML only as a supplement.

aktsmm/Agent-Skills262026年10月10日 更新

ascii-banner

無料日本語概要

Generate ASCII-art text banners for terminals, READMEs, and CLI startup messages. Use when a user asks for an ASCII banner, text art, バナー, アスキーアート, or a decorative header for a script/README.

aktsmm/Agent-Skills262026年10月10日 更新

aktsmm のスキルをすべて見る

このスキルの問題を報告する