Drawio

Public AI agent skills mirrored from jsolly/dotagents (allowlisted)

Install

npx -y skills add jsolly/agent-skills --skill drawio

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

22 days oldThe repository was created 22 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when the user says `/drawio`, asks for a draw.io diagram, or wants an editable native .drawio XML file with optional PNG/SVG/PDF export. NOT for Mermaid-only diagrams, data-heavy charts, or editing an existing diagram without its source XML.

SKILL.md

4.1 KB, as published. Nobody here has run it

Draw.io Diagram Skill

Write native .drawio files (mxfile XML). Optionally export to PNG, SVG, or PDF via the desktop CLI — exported files embed the diagram XML so they remain editable in draw.io. There is no Mermaid conversion, shape-search, or layout/routing API — generate XML directly.

Supported diagrams

Standard — flowcharts, org charts, mind maps, timelines, Venn diagrams
Software — UML (class, sequence, activity, use case), ERD, architecture
Cloud / infra — AWS, Azure, GCP, Kubernetes, network topology (use shape=mxgraph.*)
Engineering — electrical / digital logic, P&ID, floor plans
Business — BPMN, value streams, customer journeys, SWOT
UI/UX — wireframes, mockups, sitemaps
Other — data flows, decision trees, infographics

Workflow

Generate .drawio XML using the mxfile wrapper (inner mxGraphModel) for the requested diagram
Write to <name>.drawio in the working directory
If the user wants an export format, run the CLI with --embed-diagram, then delete the source .drawio
Open the result with open <file>

Check the user's request for a format preference:

/drawio create a flowchart → flowchart.drawio
/drawio png flowchart for login → login-flow.drawio.png
/drawio svg: ER diagram → er-diagram.drawio.svg
/drawio pdf architecture overview → architecture-overview.drawio.pdf

If no format is mentioned, write the .drawio file and open it.

Supported export formats

Format	Embed XML	Notes
`png`	Yes (`-e`)	Viewable everywhere, editable in draw.io
`svg`	Yes (`-e`)	Scalable, editable in draw.io
`pdf`	Yes (`-e`)	Printable, editable in draw.io
`jpg`	No	Lossy, no embedded XML support

CLI path

/Applications/draw.io.app/Contents/MacOS/draw.io -x -f <format> -e -b 10 -o <output> <input.drawio>

If the CLI isn't found, keep the .drawio file and tell the user.

Gotchas

Always generate XML directly. Mermaid and CSV formats require server-side conversion and cannot be saved as native .drawio files.
Never include XML comments () — they waste tokens and can cause parse errors.
Escape special characters in attribute values: &, <, >, "
Use unique id values for every mxCell.
Every edge needs geometry: an edge mxCell without a child <mxGeometry relative="1" as="geometry" /> won't render.
Use double extensions for exports (name.drawio.png) — signals the file contains embedded diagram XML.

Troubleshooting

Problem	Cause	Solution
CLI not found	Desktop app not installed	Keep the `.drawio` file; tell the user to install draw.io desktop
Export produces empty/corrupt file	Invalid XML (unescaped chars, comments)	Validate XML well-formedness before writing
Diagram opens but looks blank	Missing root cells `id="0"` and `id="1"`	Ensure the basic mxGraphModel structure is complete
Edges not rendering	Edge mxCell is self-closing (no child mxGeometry)	Every edge must have `<mxGeometry relative="1" as="geometry" />`

Minimal XML skeleton

Prefer a proper .drawio wrapper (mxfile → diagram → mxGraphModel). Bare mxGraphModel often opens in desktop, but the wrapper is the real file shape.

<mxfile host="app.diagrams.net">
  <diagram id="page-1" name="Page-1">
    <mxGraphModel adaptiveColors="auto" grid="1" gridSize="10" page="1" pageWidth="850" pageHeight="1100">
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
      </root>
    </mxGraphModel>
  </diagram>
</mxfile>

Cell 0 is the root layer; cell 1 is the default parent. All diagram elements use parent="1" unless using multiple layers.

XML reference

@references/xml-reference.md