drawio-xml-editor

drawio-xml-editor

Codex skill for generating and incrementally editing diagrams.net / draw.io .drawio XML files.

It is designed for architecture diagrams, paper figures, network structure diagrams, and other layout-sensitive visuals where semantic similarity is not enough and the output must remain editable in diagrams.net.

What It Supports

• Generate a .drawio diagram from a text description
• Incrementally edit an existing .drawio file
• Recreate paper-style figures with a layout-spec-first workflow
• Validate diagram XML before delivery
• Rewrite between compressed and uncompressed .drawio formats

Install

Copy this repository's contents into:

~/.codex/skills/drawio-xml-editor/

For example on Windows:

C:\Users\<your-name>\.codex\skills\drawio-xml-editor\

Then restart Codex.

Typical Workflow

The skill is built around:

reference image / text requirement
-> layout spec JSON
-> draw.io XML
-> validation

Typical commands:

python scripts/drawio_xml_tool.py lint-layout spec.json
python scripts/drawio_xml_tool.py render-layout spec.json --output out.drawio
python scripts/drawio_xml_tool.py validate out.drawio
python scripts/drawio_xml_tool.py rewrite out.drawio --output out-compressed.drawio --format compressed

Repository Layout

• SKILL.md: main skill instructions
• agents/openai.yaml: UI metadata
• references/layout-spec.md: normalized layout-spec contract
• references/paper-architecture-example.json: example spec
• references/xml-structure.md: diagrams.net XML notes
• scripts/drawio_xml_tool.py: inspect / validate / rewrite / render helper

Notes

• The skill prioritizes layout fidelity over semantic restatement.
• Existing .drawio files are meant to be edited incrementally, not regenerated from scratch unless necessary.
• The helper script is useful even outside Codex if you want to inspect or validate .drawio files from the command line.

License

MIT