aws-architecture-diagram
Always use when user asks to create, generate, or build an AWS architecture diagram, cloud infrastructure diagram, or system diagram with AWS services. Also activates for draw.io diagrams mentioning AWS services like Lambda, DynamoDB, S3, API Gateway, etc.
vidanov · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add vidanov/aws-architecture-diagram-skill --skill aws-architecture-diagram技能说明
name: aws-architecture-diagram description: Generate AWS architecture diagrams in draw.io format. Activates when the user asks to create, generate, or build an architecture diagram, system diagram, or draw.io diagram for AWS services.
Instructions
Generate a draw.io (.drawio) XML file representing an AWS architecture diagram.
Layout
- Left-to-right flow for data/request path
- UI/Frontend on the LEFT (users access from left side)
- Data sources / external systems on the RIGHT
- Use horizontal lanes for parallel paths (top lane, bottom lane)
- Minimum 220px horizontal spacing between icons (to leave room for edge labels)
- Minimum 250px vertical spacing between lanes (so vertical edges don't crowd)
- Secondary/auxiliary services (monitoring, DLQ, error paths) go BELOW the main flow with 280px+ vertical gap
Canvas
- Large canvas:
pageWidth="2400" pageHeight="1400"minimum - Set
dx="2800" dy="1600"for proper viewport - Always include a title block as the first element after the background:
<mxCell value="<b>Diagram Title</b><br>Author | Date | Version" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontSize=14;spacing=8;" vertex="1" parent="1">
<mxGeometry x="40" y="30" width="420" height="60" as="geometry" />
</mxCell>
Icon Style
- Icons are from draw.io's built-in
mxgraph.aws4stencil library — the official AWS Architecture Icons (https://aws.amazon.com/architecture/icons/, updated quarterly) - Icon size: 78x78px for main services, 65x65px for secondary
- Use
sketch=0on all icons - Use
strokeColor=#ffffffon all AWS service icons - Font size: 12px for labels
Edge Style — CRITICAL FOR CLEAN DIAGRAMS
Base edge style (all edges):
edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;
Rules for edge labels:
- Keep labels SHORT (1-2 words max). Use icon labels for detail, not edge labels.
- On horizontal edges: position label ABOVE the line using
verticalAlign=bottom;in the edge style - On vertical edges: position label to the LEFT using
align=right;in the edge style - Always add
labelBackgroundColor=#F5F5F5;so labels don't overlap lines - For edges WITHOUT labels: omit the
valueattribute entirely (don't usevalue="")
Edge label positioning (prevents overlap with icons):
<mxCell value="Label" style="edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;labelBackgroundColor=#F5F5F5;fontSize=11;" edge="1" source="a" target="b" parent="1">
<mxGeometry relative="1" as="geometry" />
</mxCell>
For edges that go to services ABOVE or BELOW the main flow:
- Use explicit exit/entry points to control routing:
- Exit bottom:
exitX=0.5;exitY=1;exitDx=0;exitDy=0; - Enter top:
entryX=0.5;entryY=0;entryDx=0;entryDy=0; - Exit top:
exitX=0.5;exitY=0;exitDx=0;exitDy=0; - Enter bottom:
entryX=0.5;entryY=1;entryDx=0;entryDy=0;
- Exit bottom:
- This prevents draw.io from routing lines through other icons
Edge types:
- Solid black (
strokeWidth=2): primary data flow - Dashed black (
strokeWidth=2;dashed=1;): optional/async path - Dashed red (
strokeWidth=2;dashed=1;strokeColor=#DD344C;): error path
When NOT to label edges:
- If the flow is obvious from context (e.g., Lambda → DynamoDB doesn't need "Write")
- If the icon labels already explain the relationship
- Prefer fewer, more meaningful labels over labeling every edge
Two Icon Patterns — CRITICAL
Pattern 1: Service-level (resourceIcon frame)
- Style:
shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.<name> - MUST use
strokeColor=#ffffff— without it, the white glyph disappears - Size: 78x78
Pattern 2: Resource-level (standalone shape)
- Style:
shape=mxgraph.aws4.<name>directly (no resIcon) - MUST use
strokeColor=none— using #ffffff breaks these - Size: 78x78 or 48x48
Confusing these patterns guarantees broken icons.
Icon Reference Files (load by category as needed)
references/aws-icons-compute.md— Lambda, EC2, ECS, EKS, Fargatereferences/aws-icons-database.md— DynamoDB, RDS, Aurora, ElastiCachereferences/aws-icons-integration.md— API Gateway, SQS, SNS, EventBridge, Step Functionsreferences/aws-icons-networking.md— CloudFront, Route 53, VPC, ELBreferences/aws-icons-storage.md— S3, EFS, EBS, Glacier, Backupreferences/aws-icons-security.md— IAM, Cognito, KMS, WAF, Shieldreferences/aws-icons-analytics-ml.md— Kinesis, Athena, Bedrock, SageMakerreferences/aws-icons-common.md— Groups, general resources, edge styles, base template
Always look up icons from reference files. Never guess icon names.
Group Boundaries
- AWS Cloud:
shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_aws_cloud_alt;strokeColor=#232F3E;fillColor=none - Account:
shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_account;strokeColor=#CD2264;fillColor=none - On-premise:
shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_on_premise;strokeColor=#5A6C86;fillColor=none - Logical groups: Simple dashed boxes:
whiteSpace=wrap;html=1;fillColor=none;dashed=1;dashPattern=8 8 - NO colored backgrounds on group boxes — always
fillColor=none
PNG Export Background Fix
Place a full-canvas rectangle as the FIRST element (lowest z-order):
<mxCell value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#F5F5F5;strokeColor=none;" vertex="1" parent="1">
<mxGeometry x="0" y="0" width="2400" height="1400" as="geometry" />
</mxCell>
This prevents black background on PNG export. Use strokeColor=none (not E0E0E0).
Multi-page Diagrams
For complex architectures, use multiple pages (tabs) in one .drawio file:
<mxfile>
<diagram id="overview" name="Overview">...</diagram>
<diagram id="networking" name="Net
阅读完整来源 ↗