drawio-plus

Generate standardized draw.io diagrams with validated non-overlapping layouts and orthogonal edge routing.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Jin9/skillify-foundation --skill drawio-plus-jin9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: drawio-plus
Source: https://github.com/Jin9/skillify-foundation/tree/main/treasury/drawio-plus
Command: npx skills add https://github.com/Jin9/skillify-foundation --skill drawio-plus-jin9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Hand-drawn or ad-hoc draw.io diagrams often suffer from overlapping boxes, arrows crossing through unrelated components, and inconsistent spacing, making architecture and flow diagrams hard to read and unprofessional. ## Core Features & Use Cases - Standardized Layout Generation: Produces draw.io XML following fixed grid rules (80px horizontal gap, 60px vertical gap, 40px container padding) across architecture, flowchart, ER, UML class, network, sequence, and mockup diagram types. - Deterministic Validation Gate: Runs scripts/validate_layout.py to catch overlap, spacing, padding, and arrow-through-box violations before delivery, with fix recipes for each failure. - Reusable Templates and Style Catalog: Ships gate-passing skeletons for grouped architectures and linear flows plus a fixed catalog of node and edge styles with deterministic id naming. - Use Case: Describe a three-tier web app (React frontend, API service, Postgres, Stripe, Redis) and receive a clean five-lane architecture diagram whose layout passes automated validation. ## Quick Start Ask the agent to draw a clean, standardized architecture diagram of your system with components grouped into frontend, backend, database, external, and infrastructure lanes.

Frequently Asked Questions about drawio-plus

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a draw.io diagram where boxes never overlap?▼

Place every box on a grid using the formula x = X0 + c*(W+80) and y = Y0 + r*(H+60), then run the validate_layout.py script on the output file. The script fails on any overlap, sub-minimum spacing, or insufficient container padding, and the diagram is only delivered after it exits 0.

How to route draw.io arrows around boxes instead of through them?▼

Use orthogonal edges with explicit mxPoint waypoints placed in the empty gaps between lanes or rows so the edge elbows around unrelated boxes. The validation script flags suspected through-box crossings as warnings so you can add waypoints and re-check.

What diagram types does this draw.io layout standard support?▼

It covers architecture, flowchart, entity-relationship, UML class, network, sequence, and mockup diagrams. Each type has a layout recipe in references/diagram-types.md, and all except sequence lifelines follow the same grid and spacing rules.

Does the layout validator work with compressed draw.io files?▼

No, the validator parses uncompressed mxGraphModel XML only. A compressed diagram page is reported as a warning and skipped, so diagrams must be written or exported in uncompressed XML format to be validated.

When should I not use this standardized diagram approach?▼

Skip it for quick throwaway sketches where layout quality does not matter, and for exporting existing diagrams to PNG, SVG, or PDF via the draw.io CLI. Those cases belong to a basic drawio skill rather than this layout-focused workflow.