Individual skill
aws-architecture-diagram
Generate validated AWS architecture diagrams as draw.io XML using official AWS4 icon libraries. Use this skill whenever the user wants to create, generate, or design AWS architecture diagrams, cloud infrastructure diagrams, or system design visuals. Also triggers for requests to visualize existing infrastructure from CloudFormation, CDK, or Terraform code. Supports two modes: analyze an existing codebase to auto-generate diagrams, or brainstorm interactively from scratch. Exports .drawio files with optional PNG/SVG/PDF export via draw.io desktop CLI.
plugins/deploy-on-aws/skills/aws-architecture-diagram/SKILL.md
Source commit fbefb3764e67558fe10ac834dd85db49734aa9b6
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 4, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 938
- Repository last updated
- Nov 5, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- agents Repository topic
- coding-agent-skills Repository topic
- coding-agents Repository topic
- agent-plugins Repository topic
- aws Repository topic
- devops Derived category
- engineering Derived category
- design Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 15,283 bytesSKILL.mdcore · 15,283 bytesSKILL.mdcore · 15,283 bytesSKILL.mdcore · 15,283 bytesreferences/aws4-shapes-resources.mddoc · 14,856 bytesreferences/aws4-shapes-services.mddoc · 9,097 bytesreferences/cli-export.mddoc · 1,960 bytesreferences/diagram-templates-advanced.mddoc · 1,491 bytesreferences/diagram-templates-basic.mddoc · 2,568 bytesreferences/example-agentcore.drawioasset · 28,796 bytesreferences/example-complex-platform.drawioasset · 46,204 bytesreferences/example-event-driven.drawioasset · 43,980 bytesreferences/example-microservices.drawioasset · 47,561 bytesreferences/example-multi-region-active-active.drawioasset · 30,537 bytesreferences/example-saas-backend.drawioasset · 54,637 bytesreferences/example-sketch.drawioasset · 33,456 bytesreferences/general-icons.mddoc · 5,184 bytesreferences/group-styles.mddoc · 6,728 bytesreferences/layout-guidelines.mddoc · 6,412 bytesreferences/post-processing.mddoc · 982 bytesreferences/style-guide.mddoc · 6,339 bytesreferences/xml-rules.mddoc · 5,243 bytesreferences/xml-templates-examples.mddoc · 2,890 bytesreferences/xml-templates-structure.mddoc · 6,544 bytes
Read excerpt
You are an AWS architecture diagram generator that produces draw.io XML files with official AWS4 icons. The diagrams you produce MUST match the style of official AWS Reference Architecture diagrams — professional title and subtitle, teal numbered step badges with a right sidebar legend, 48x48 service icons inside colored category containers, clean Helvetica typography, and clear data flow.
## Workflow
### Step 1: Determine Mode
**Mode A — Codebase Analysis:** If the user says "analyze", "scan", "from code", or references their existing project:
1. Scan for infrastructure files: CloudFormation (`AWSTemplateFormatVersion`, `AWS::*`), CDK (`cdk.json`, construct definitions), Terraform (`resource "aws_*"`)
2. Extract services, relationships, VPC structure, and data flow direction
3. If NO AWS infrastructure files found, scan for non-AWS technologies: Dockerfiles, database configs, API integrations, ML frameworks (pytorch, tensorflow, coreml), message brokers (kafka, rabbitmq). Map discovered technologies using `references/general-icons.md`
4. For MIXED architectures (AWS + non-AWS): use AWS icons for AWS services, general icons for non-AWS. Same layout rules apply.
5. Confirm discovered architecture with user before generating
6. Ask which diagram type best represents the architecture