draw-io

The draw-io skill provides a comprehensive toolkit for managing architecture diagrams, system flows, and technical documentation directly within your repository. Designed for developers and architects, this skill enables programmatic manipulation of .drawio XML files, ensuring consistency across complex diagrams, sequence flows, and infrastructure models. By treating diagrams as code, it simplifies the version control process and facilitates automated generation of high-quality visuals for presentations and documentation.

• Precise coordinate and geometry manipulation for XML-based draw.io elements to ensure perfect alignment and visual clarity.

• Automated conversion pipelines using pre-commit hooks to transform source .drawio files into high-resolution, transparent PNGs suitable for Quarto slides and README documents.

• Standardized styling and font management, including specific configurations for Noto Sans JP and adaptive font sizing for PDF and screen readability.

• Advanced layout strategies including grouping, progressive disclosure via system-to-component hierarchy, and standardized arrow placement for improved technical readability.

• Extensive support for AWS architecture icons and professional design principles, such as maintaining sufficient margins and clear label placement using line breaks and offset adjustments.

• Direct interaction with .drawio files as raw XML is the primary workflow, requiring careful attention to mxGeometry and style attributes.

• Always verify output by running conversion scripts to ensure that layout adjustments do not result in visual overlaps or clipping of content.

• For best results, use 1.5x font scaling for web/PDF consistency and prioritize transparent backgrounds to maintain compatibility with varying presentation themes.

• Utilize provided coordinate calculation rules, specifically ensuring internal elements maintain at least 30px of margin within parent frames.

• Avoid manual editing of generated .drawio.png files; rely solely on the automated conversion flow to ensure source-of-truth integrity.