AWS Architecture Diagram Skill — DevOps skill for Claude Code

aws-architecture-diagram

A [Claude Code](https://claude.com/claude-code) skill that draws clean, print-ready AWS architecture diagrams from a small Python data file. It renders the official AWS icons and the AWS group palette (cloud, region, availability zones, subnets, security groups) with Chrome, then audits the result so that no connector crosses text or an icon, no label sits on a border, no endpoint floats, and no two connectors cross.


The diagram is data, not a drawing. You edit coordinates in a data file, build, and run the checker. You look at the picture only when the checker reports zero findings. Eyeballing a 3,700 px image misses things; the checker does not.

What is in the skill

Path	What
SKILL.md	the workflow Claude follows: agree content, lay out groups, place icons, route connectors in lanes, build, check, then look
references/conventions.md	the AWS palette, the spacing rules the checker enforces, layout patterns, and the lessons behind each rule
scripts/fetch_icons.py	copies icons out of the diagrams package under short names (eks, rds, alb, argo, gitlab, ...)
scripts/build_diagram.py	data file to PNG: HTML, Chrome headless at 2x, cropped
scripts/check_diagram.py	the geometry audit, measuring labels with the real font
scripts/export_drawio.py	the same diagram as a native .drawio with live AWS4 shapes
scripts/export_eraser.py	Eraser diagram-as-code, ready for app.eraser.io or the Eraser MCP
scripts/export_figma.py	two Figma Plugin API scripts for the Figma MCP's use_figma
scripts/export_mermaid.py	a Mermaid architecture-beta block for READMEs
assets/template_diagram.py	a two-zone starter that builds at zero findings

Install

Copy the folder into your personal skills directory:

git clone https://github.com/akzedevops/aws-architecture-diagram-skill ~/.claude/skills/