aws-architecture-diagram

Generate AWS architecture diagrams as native draw.io files using official AWS Architecture Icons.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/idy-00/paytrack --skill aws-architecture-diagram-idy-00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-architecture-diagram
Source: https://github.com/idy-00/paytrack/tree/main/backend/.agents/skills/aws-architecture-diagram
Command: npx skills add https://github.com/idy-00/paytrack --skill aws-architecture-diagram-idy-00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating AWS architecture diagrams by hand in draw.io is slow and error-prone: stencil names don't match current AWS service names, edges float or cross icons, and exports come out with black backgrounds. This Skill encodes verified icon names, layout rules, and export commands so diagrams come out correct on the first pass. ## Core Features & Use Cases - Verified icon mapping: Uses the official mxgraph.aws4 stencil library with a table of confirmed-working icon names, known-broken stencils, and renamed-service gotchas (e.g. OpenSearch → elasticsearch_service). - Layout and edge rules: Enforces left-to-right flow, minimum spacing, attached edges with explicit exit/entry points, and container nesting for VPC/subnet group boundaries. - Export and review loop: Exports to PNG, SVG, or PDF via the draw.io CLI with embedded XML, then visually reviews the render to catch broken icons. - Use Case: Ask for a serverless API diagram with API Gateway, Lambda, and DynamoDB, and receive a ready-to-open .drawio file plus a companion markdown guide explaining the flow. ## Quick Start Ask the AI to create an AWS architecture diagram of your system, for example a serverless API with API Gateway, Lambda, and DynamoDB, and export it as a PNG.

Frequently Asked Questions about aws-architecture-diagram

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

FAQPage Schema
How do I create an AWS architecture diagram in draw.io?

Generate mxGraphModel XML using the built-in mxgraph.aws4 stencil library, write it to a .drawio file, and open it in draw.io. Use resourceIcon shapes at 78x78px with verified stencil names and orthogonal edges attached to source and target cell IDs.

How do I export a draw.io diagram to PNG from the command line?

Run the draw.io desktop CLI with the flags -x -f png -e -b 10 -o output input.drawio. The -e flag embeds the diagram XML so the exported PNG remains re-editable in draw.io.

Why does my draw.io AWS icon render as an empty square?

An empty square means the stencil name is wrong or unsupported. AWS renames services but draw.io keeps legacy names, so OpenSearch uses elasticsearch_service and MSK uses managed_streaming_for_kafka. Verify names against the reference files or the draw.io Sidebar-AWS4.js source.

Does draw.io support 3D or isometric AWS diagrams?

Yes, draw.io includes a separate mxgraph.aws3d library with isometric icons and an isometricEdgeStyle for connectors. Coverage is much smaller than aws4, so check the 3D reference file for gaps and substitute or flag missing services.

Why do my draw.io edges float or cross through icons?

Floating edges happen when edges lack source and target attributes bound to valid cell IDs. Set explicit exitX/exitY and entryX/entryY connection points, align nodes on shared centerlines, and verify no edge path crosses an unrelated icon's bounding box.