Generates and edits draw.io XML diagrams.

Install

mkdir -p .claude/skills/drawio-akiojin && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16525" && unzip -o skill.zip -d .claude/skills/drawio-akiojin && rm skill.zip

Installs to .claude/skills/drawio-akiojin

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Create and edit draw.io diagrams in XML format. Use when the user wants to create flowcharts, architecture diagrams, sequence diagrams, or any visual diagrams. Handles XML structure, styling, fonts (Noto Sans JP), arrows, connectors, and PNG export.
249 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • Create draw.io XML files
  • Edit existing draw.io XML diagrams
  • Generate various shapes like rectangles, ellipses, and diamonds
  • Add arrows and connectors with or without labels
  • Apply specific styling, including font settings and colors
  • Export diagrams to PNG format using the `drawio` CLI

How it works

The skill generates and modifies draw.io XML based on user requests, applying specific styles, fonts, and structural rules. It ensures proper XML element ordering for correct rendering and can export the final diagram to PNG.

Inputs & outputs

You give it
Diagram specifications or existing draw.io XML
You get back
draw.io XML file or PNG image

When to use drawio

  • Generate an architecture flowchart
  • Create a sequence diagram
  • Edit a draw.io diagram file

About this skill

Draw.io Diagram Skill

draw.ioファイル(.drawio)をXML形式で直接作成・編集するためのスキル。

XML基本構造

<mxfile host="app.diagrams.net" modified="2024-01-01T00:00:00.000Z" agent="Claude" version="21.0.0">
  <diagram name="Page-1" id="page-1">
    <mxGraphModel dx="1000" dy="600" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0" defaultFontFamily="Noto Sans JP">
      <root>
        <mxCell id="0" />
        <mxCell id="1" parent="0" />
        <!-- 図形要素をここに追加 -->
      </root>
    </mxGraphModel>
  </diagram>
</mxfile>

mxCell要素

矩形(Rectangle)

<mxCell id="rect-1" value="ラベル" style="rounded=0;whiteSpace=wrap;html=1;fontFamily=Noto Sans JP;fontSize=18;" vertex="1" parent="1">
  <mxGeometry x="100" y="100" width="120" height="60" as="geometry" />
</mxCell>

角丸矩形(Rounded Rectangle)

<mxCell id="rounded-1" value="ラベル" style="rounded=1;whiteSpace=wrap;html=1;fontFamily=Noto Sans JP;fontSize=18;arcSize=20;" vertex="1" parent="1">
  <mxGeometry x="100" y="100" width="120" height="60" as="geometry" />
</mxCell>

楕円(Ellipse)

<mxCell id="ellipse-1" value="ラベル" style="ellipse;whiteSpace=wrap;html=1;fontFamily=Noto Sans JP;fontSize=18;" vertex="1" parent="1">
  <mxGeometry x="100" y="100" width="120" height="80" as="geometry" />
</mxCell>

ひし形(Diamond)

<mxCell id="diamond-1" value="条件" style="rhombus;whiteSpace=wrap;html=1;fontFamily=Noto Sans JP;fontSize=18;" vertex="1" parent="1">
  <mxGeometry x="100" y="100" width="100" height="100" as="geometry" />
</mxCell>

テキスト(Text Only)

<mxCell id="text-1" value="テキスト" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontFamily=Noto Sans JP;fontSize=18;" vertex="1" parent="1">
  <mxGeometry x="100" y="100" width="120" height="30" as="geometry" />
</mxCell>

矢印・コネクタ

基本の矢印

<mxCell id="arrow-1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;fontFamily=Noto Sans JP;fontSize=14;" edge="1" parent="1" source="rect-1" target="rect-2">
  <mxGeometry relative="1" as="geometry" />
</mxCell>

ラベル付き矢印

<mxCell id="arrow-2" value="ラベル" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;fontFamily=Noto Sans JP;fontSize=14;" edge="1" parent="1" source="rect-1" target="rect-2">
  <mxGeometry relative="1" as="geometry" />
</mxCell>

点線矢印

<mxCell id="arrow-3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;dashed=1;fontFamily=Noto Sans JP;fontSize=14;" edge="1" parent="1" source="rect-1" target="rect-2">
  <mxGeometry relative="1" as="geometry" />
</mxCell>

スタイル設定ガイド

フォント設定(必須)

  1. mxGraphModeldefaultFontFamily="Noto Sans JP"を設定
  2. すべてのテキスト要素fontFamily=Noto Sans JP;を明示的に追加

推奨設定

項目推奨値説明
fontSize18標準の1.5倍、視認性向上
日本語テキスト幅30-40px/文字レイアウト計算用
矢印とラベル間隔20px以上重なり防止

色設定

fillColor=#ffffff;      # 塗りつぶし色
strokeColor=#000000;    # 枠線色
fontColor=#333333;      # 文字色

よく使う色

用途色コード
白背景#ffffff
薄い青#dae8fc
薄い緑#d5e8d4
薄い黄#fff2cc
薄い赤#f8cecc
薄いグレー#f5f5f5

配置ルール

XMLの記述順 = 描画順

  • 先に書いたものが背面に配置される
  • 矢印は図形より先(XMLの先頭側)に記述して最背面に配置

推奨構造

<root>
  <mxCell id="0" />
  <mxCell id="1" parent="0" />

  <!-- 1. 矢印・コネクタ(最背面) -->
  <mxCell id="arrow-1" ... edge="1" ... />
  <mxCell id="arrow-2" ... edge="1" ... />

  <!-- 2. 図形(中間) -->
  <mxCell id="rect-1" ... vertex="1" ... />
  <mxCell id="rect-2" ... vertex="1" ... />

  <!-- 3. テキストラベル(最前面) -->
  <mxCell id="text-1" ... vertex="1" ... />
</root>

PNG変換

drawio CLIコマンド

drawio -x -f png -s 2 -t -o output.png input.drawio
オプション説明
-xエクスポートモード
-f pngPNG形式
-s 22倍スケール(高解像度)
-t透明背景
-o出力ファイル指定

検証チェックリスト

作成後、以下を確認:

  • mxGraphModelにdefaultFontFamilyが設定されているか
  • 全テキスト要素にfontFamilyが明示的に設定されているか
  • fontSizeは18px程度か(視認性)
  • 矢印がXMLの先頭側に配置されているか(最背面)
  • 矢印とラベルの間隔は20px以上か
  • 日本語テキストの幅は十分か(30-40px/文字)
  • PNG出力で視覚確認したか

テンプレート

基本テンプレートは templates/basic.drawio を参照。

When not to use it

  • When the user wants to create diagrams in a format other than draw.io XML
  • When the user wants to use a font other than Noto Sans JP for text elements
  • When the user wants to place arrows or connectors after shapes in the XML structure

Limitations

  • All text elements must explicitly include `fontFamily=Noto Sans JP;`
  • XML writing order dictates drawing order, with arrows needing to be placed first
  • Japanese text width should be calculated at 30-40px per character for layout

How it compares

This skill directly manipulates draw.io XML for precise diagram control and styling, unlike a visual diagram editor that abstracts the underlying XML structure.

Compared to similar skills

drawio side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
drawio (this skill)08moReviewIntermediate
svg-precision5274moReviewIntermediate
draw-io416moReviewIntermediate
legacy-circuit-mockups77moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry