AWS Architecture Diagram Skill
A skill that turns a prompt into a draw.io AWS architecture file: 270 verified icons, layout rules and consistent styling.
- 174 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill creates diagram files from a description and runs nothing in your AWS environment.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/aws-architecture-diagram-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill creates diagram files from a description and runs nothing in your AWS environment.
This is third-party code. Review the repository files before installing.
What it does
AWS Architecture Diagram Skill fixes a typical AI diagram problem: instead of icons you get empty boxes because the agent guesses stencil names. The skill carries a verified catalog of more than 270 AWS stencil names plus layout and styling rules, so the `.drawio` file opens in draw.io with no manual fixes. A prompt like "a serverless API on Lambda, DynamoDB and API Gateway" is enough. The icon catalog is split by area: compute, databases, networking, storage, security, integration, analytics and machine learning, IoT and migration, plus 3D variants. The result can be exported to PNG and examples live in the repository: event-driven order processing, a three-tier app and a streaming pipeline. For agents without a file system there is a prompt-and-references variant for ChatGPT and Claude Projects.
Who it is for. Cloud architects and DevOps engineers who need an AWS diagram in editable draw.io format straight from a verbal description.
Good fit when
- A document needs the architecture of a serverless API on Lambda, DynamoDB and API Gateway.
- An agent drew a diagram but the icons became empty boxes and need fixing.
- A streaming pipeline diagram with Kinesis, Lambda and S3 is needed as a PNG for a slide.
- The team wants a consistent diagram style: icons, spacing and grouping identical across files.
Not a fit when
- The diagram is not about AWS: the icon catalog covers AWS only.
- A full cost or security analysis of the architecture is required: the skill draws but does not assess.
- There is no access to draw.io and a `.drawio` file cannot be opened.
Example request
Create an AWS diagram for event-driven order processing with SQS, Lambda, DynamoDB and EventBridge as draw.io and export to PNG.Limitations
The skill draws AWS diagrams and does not assess cost, reliability or security. The result is stored as `.drawio`, so viewing needs draw.io or a compatible editor and PNG export needs a suitable environment. The icon catalog is maintained by hand, so new AWS services may appear with a delay. Kiro CLI and Claude Code use different skill files, and for ChatGPT and Claude Projects you paste the prompt and upload references manually. The author suggests a ChatGPT temperature around 0.3.
How to disable. Delete the `aws-architecture-diagram` folder from the agent skills directory, for example `~/.claude/skills`. Created `.drawio` files stay in your working folder.
FAQ
How do I install AWS Architecture Diagram Skill?
Run `npx skills add vidanov/aws-architecture-diagram-skill`. For a specific agent add `--agent claude-code`, `--agent cursor` or `--agent kiro-cli`. The `--global` key makes the skill available in all projects.
Why do icons vanish in AI-made diagrams?
The agent guesses stencil names and a wrong name gives an empty box. The skill keeps a catalog of more than 270 verified names and takes them from there.
Can I use the skill in ChatGPT?
Yes, with no CLI. Paste the prompt from `chatgpt/PROMPT.md` into custom instructions and upload the references from `chatgpt/references/` to the knowledge base. The author suggests a temperature around 0.3.
How do I install the skill manually in Claude Code?
Create `~/.claude/skills/aws-architecture-diagram`, copy `claude/SKILL.md` and the `references` folder into it. Kiro CLI uses `kiro/SKILL.md` and the `~/.kiro/skills/` directory.
Which diagrams do the examples show?
Event-driven order processing, a serverless API, a three-tier app, a streaming pipeline and two 3D diagrams including an e-commerce site. Files live in `examples/`.
Discussion
No questions or reviews yet.
Related
SkillsSkills and a CLI that teach an agent to draw valid draw.io diagrams for AWS, Azure, GCP, Databricks and BPMN with structure checks
A set of skills for agent work with AWS: common cloud service tasks packaged as ready instructions for a coding agent
Forty-five skills, custom agents and CloudFormation templates for AWS DevOps Agent: incident analysis and operations reviews
28 AWS skills for Amazon EKS and ECS: architecture, Terraform, live cluster review, upgrade checks and security.
Microsoft Learn skills for nearly every Azure service: limits, configuration, security, architecture and troubleshooting with doc links
AWS's official set of MCP servers, skills and plugins so an agent can build, deploy and operate on AWS
README in short
The skill is written for Claude Code and Kiro CLI and extended with a variant for ChatGPT and Claude Projects. Icon references are split by AWS service area.