Draw Io
Create and maintain architecture diagrams and flowcharts as `.drawio` XML with consistent styling and PNG export for docs and slides.
Overview
draw-io is an agent skill for the Build phase that creates, edits, and exports professional draw.io architecture and flowchart diagrams from structured XML.
Install
npx skills add https://github.com/softaworks/agent-toolkit --skill draw-ioWhat is this skill?
- Edits `.drawio` files as structured XML with layout spacing, alignment, and overlap debugging
- Converts diagrams to high-resolution PNG, including transparent backgrounds via hooks or scripts
- Manages `defaultFontFamily` and per-element fonts for Quarto slides and consistent typography
- Integrates official AWS architecture icons via search and placement
- Applies accessibility and professional design standards to diagram quality
Adoption & trust: 527 installs on skills.sh; 2k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need accurate architecture or flow diagrams in docs and slides, but hand-editing `.drawio` layout, fonts, and PNG exports is slow and inconsistent.
Who is it for?
Solo builders documenting backend, AWS, or agent architectures who already work in draw.io and want agent-assisted XML edits and export automation.
Skip if: Teams that want interactive UI mockups in Figma or code-only diagrams without maintaining `.drawio` XML files.
When should I use this skill?
Create or edit `.drawio` XML, convert diagrams to PNG, adjust layouts programmatically, enforce font families, or work with AWS architecture icons.
What do I get? / Deliverables
You get consistently styled `.drawio` diagrams plus high-resolution PNGs suitable for documentation, presentations, and accessible technical visuals.
- Updated `.drawio` XML with consistent styling and layout
- High-resolution PNG exports for documentation or presentations
Recommended Skills
Journey fit
Documentation visuals and architecture diagrams are produced while building and describing the product, so the canonical shelf is Build → docs. The skill centers on technical documentation visuals (diagrams, flowcharts, AWS layouts) rather than UI implementation or runtime integrations.
How it compares
Use instead of asking the agent to sketch ASCII art or vague box diagrams when you need editable, exportable draw.io source files.
Common Questions / FAQ
Who is draw-io for?
Indie developers and small teams shipping SaaS or APIs who document systems with draw.io and want Claude or Cursor to edit XML, fix layout, and produce PNGs for READMEs and talks.
When should I use draw-io?
Use it during Build → docs when creating or updating `.drawio` files, converting to PNG, aligning AWS icons, or fixing font consistency for Quarto slides; also when debugging overlapping elements before a launch README refresh.
Is draw-io safe to install?
It manipulates local diagram files and may run conversion scripts or hooks; review the Security Audits panel on this page and inspect any shell or pre-commit automation before enabling it in CI.
SKILL.md
READMESKILL.md - Draw Io
# draw-io Diagram Skill A Claude Code skill for creating, editing, and managing draw.io diagrams with professional quality standards. ## Purpose This skill enables AI-assisted creation and maintenance of draw.io architecture diagrams, flowcharts, and technical documentation visuals. It ensures consistent styling, proper layout, and automated PNG conversion for presentations and documentation. ## When to Use This Skill Use this skill when you need to: - Create or edit `.drawio` XML diagram files - Convert diagrams to PNG format with transparent backgrounds - Adjust element positions and layouts programmatically - Ensure consistent font families (especially for Quarto slides) - Work with AWS architecture diagrams using official icons - Maintain professional diagram quality with accessibility standards - Debug layout issues or element overlaps ## How It Works The skill provides: 1. **Direct XML Editing**: Manipulates `.drawio` files as structured XML 2. **Automated Conversion**: Converts diagrams to high-resolution PNG via pre-commit hooks or scripts 3. **Layout Calculations**: Computes proper spacing, alignment, and margins 4. **Icon Integration**: Searches and integrates official AWS icons 5. **Quality Assurance**: Applies design principles and accessibility guidelines ## Key Features ### 1. Font Management Ensures consistent typography across diagrams: - Sets `defaultFontFamily` in mxGraphModel - Applies `fontFamily` to individual text elements - Recommended: "Noto Sans JP" for Japanese text support ### 2. PNG Conversion Multiple conversion methods: ```bash # Via pre-commit hook (all files) mise exec -- pre-commit run --all-files # Specific file via pre-commit mise exec -- pre-commit run convert-drawio-to-png --files assets/my-diagram.drawio # Direct script execution bash ~/.claude/skills/draw-io/scripts/convert-drawio-to-png.sh assets/diagram.drawio ``` Conversion produces: - 2x scale (high resolution) - Transparent background - PNG format suitable for presentations ### 3. Layout Adjustment Programmatic element positioning: - Calculate element centers: `y + (height / 2)` - Align multiple elements by matching center coordinates - Maintain minimum 30px margins from container boundaries - Position arrows to avoid label overlaps (20px+ clearance) ### 4. AWS Icon Integration Search and integrate official AWS service icons: ```bash python ~/.claude/skills/draw-io/scripts/find_aws_icon.py ec2 python ~/.claude/skills/draw-io/scripts/find_aws_icon.py lambda ``` Uses latest `mxgraph.aws4.*` icon set. ### 5. Design Principles Enforces professional standards: - **Clarity**: Simple, visually clean diagrams - **Consistency**: Unified colors, fonts, icon sizes, line thickness - **Accuracy**: Precise technical representation - **Accessibility**: Sufficient color contrast, pattern usage - **Progressive Disclosure**: Staged diagrams for complex systems ### 6. Quality Checklist Automated validation ensures: - No background color (transparent) - Appropriate font sizes (1.5x standard for readability) - Arrows on back layer (no overlaps) - 30px+ margins from container boundaries - Official AWS service names and latest icons - Visual verification of PNG output ## Usage Examples ### Example 1: Create AWS Architecture Diagram ```xml <!-- Set font family --> <mxGraphModel defaultFontFamily="Noto Sans JP" ...> <!-- Background frame with proper margins --> <mxCell id="vpc" style="rounded=1;strokeWidth=3;..."> <mxGeometry x="500" y="20" width="560" height="430" /> </mxCell> <!-- Title with 30px margin from frame top --> <mxCell id="title" value="VPC" style="text;fontSize=18;fontFamily=Noto Sans JP;"> <mxGeometry x="510" y="50" width="540" height="35" /> </mxCell> <!-- Arrow with explicit coordinates --> <mxCell id="arrow1" style="edgeStyle=..." edge="1"> <mxGeometry relative="1" as="geometry"> <mxPoint x="100" y="200" as="sourcePoint"/> <mxPoint x="500" y="200" as="targetPoint"