Skip to content
Back to search

vidanov-skills

MarketplaceWorks with Claude CodeGitHub

AWS architecture diagram generation skill with verified icons and reference templates

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vidanov--aws-architecture-diagram-skill/badge.svg)](/listings/vidanov--aws-architecture-diagram-skill)

HTML

<a href="/listings/vidanov--aws-architecture-diagram-skill"><img src="/api/listings/vidanov--aws-architecture-diagram-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add vidanov/aws-architecture-diagram-skill

Install to a specific agent:

npx skills add vidanov/aws-architecture-diagram-skill --agent claude-code
npx skills add vidanov/aws-architecture-diagram-skill --agent cursor
npx skills add vidanov/aws-architecture-diagram-skill --agent kiro-cli

Install globally (available in all projects):

npx skills add vidanov/aws-architecture-diagram-skill --global

<details> <summary><b>ChatGPT, Claude Projects, or any AI with custom instructions</b></summary>

No CLI required:

1. Copy the prompt from [`chatgpt/PROMPT.md`](chatgpt/PROMPT.md) into your system prompt or custom instructions 2. Upload the reference files from [`chatgpt/references/`](chatgpt/references/) to the knowledge base 3. Start asking for diagrams

> Tip: Set temperature to 0.3 for consistent XML output.

</details>

<details> <summary><b>Manual install (Claude Code / Kiro CLI)</b></summary>

# Claude Code
mkdir -p ~/.claude/skills/aws-architecture-diagram
cp claude/SKILL.md ~/.claude/skills/aws-architecture-diagram/SKILL.md
cp -r references ~/.claude/skills/aws-architecture-diagram/references

# Kiro CLI (global)
mkdir -p ~/.kiro/skills/aws-architecture-diagram
cp kiro/SKILL.md ~/.kiro/skills/aws-architecture-diagram/SKILL.md
cp -r references ~/.kiro/skills/aws-architecture-diagram/references

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "vidanov-skills",
  3. "description": "AWS architecture diagram generation skill with verified icons and reference templates",
  4. "version": "1.1.0",
  5. "owner": {
  6. "name": "Alexey Vidanov",
  7. "email": "alexey@vidanov.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "aws-architecture-diagram",
  12. "source": "./plugins/aws-architecture-diagram",
  13. "description": "Generate AWS architecture diagrams as draw.io XML with 270+ verified icons, left-to-right layout, and reference templates",
  14. "version": "1.1.0",
  15. "author": {
  16. "name": "Alexey Vidanov"
  17. },
  18. "homepage": "https://github.com/vidanov/aws-architecture-diagram-skill",
  19. "repository": "https://github.com/vidanov/aws-architecture-diagram-skill",
  20. "license": "MIT",
  21. "keywords": ["aws", "architecture", "diagram", "drawio", "draw.io", "icons"],
  22. "category": "devops"
  23. }
  24. ]
  25. }
README.md · README · 232 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AWS Architecture Diagram Skill
  2. <div align="center">
  3. [![Website](https://img.shields.io/badge/Website-vidanov.github.io-8C4FFF)](https://vidanov.github.io/aws-architecture-diagram-skill/)
  4. ![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)
  5. ![Install: one command](https://img.shields.io/badge/install-npx%20skills%20add-brightgreen.svg)
  6. ![Icons: 270+](https://img.shields.io/badge/icons-270%2B%20verified-orange.svg)
  7. ![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
  8. </div>
  9. ![Prompt → AI Agent + Skill → .drawio diagram](docs/hero.png)
  10. <div align="center">
  11. [Quick start](#quick-start) · [Examples](#example-output) · [Why icons break](#why-icons-break-and-how-this-skill-prevents-it) · [Comparison](#comparison) · [Contributing](#contributing)
  12. </div>
  13. One prompt. One `.drawio` file. Every icon renders correctly because the skill carries a verified catalog of 270+ stencil names, not guesses.
  14. <div align="center">
  15. <img src="docs/terminal-demo.svg" alt="Terminal demo: generating an AWS architecture diagram from a prompt" width="800">
  16. </div>
  17. <div align="center">
  18. [![Watch the demo on YouTube](https://img.youtube.com/vi/UdXDE5rEzTM/maxresdefault.jpg)](https://youtu.be/UdXDE5rEzTM)
  19. **[Watch the demo on YouTube](https://youtu.be/UdXDE5rEzTM)**
  20. </div>
  21. Works with any AI assistant: ChatGPT, Claude Projects, Kiro CLI, Claude Code, Cursor, or internal agents.
  22. ## The problem this solves
  23. AI agents generate broken AWS diagrams. Icons show as empty boxes because the stencil names are wrong. Layout is random. Styling is inconsistent. You spend more time fixing the output than you saved generating it.
  24. This skill gives the agent the correct stencil names, layout rules, and styling conventions. The output opens clean in draw.io with no manual fixes.
  25. ## Quick start
  26. ```bash
  27. npx skills add vidanov/aws-architecture-diagram-skill
  28. ```
  29. Install to a specific agent:
  30. ```bash
  31. npx skills add vidanov/aws-architecture-diagram-skill --agent claude-code
  32. npx skills add vidanov/aws-architecture-diagram-skill --agent cursor
  33. npx skills add vidanov/aws-architecture-diagram-skill --agent kiro-cli
  34. ```
  35. Install globally (available in all projects):
  36. ```bash
  37. npx skills add vidanov/aws-architecture-diagram-skill --global
  38. ```
  39. [![skills.sh](https://skills.sh/b/vidanov/aws-architecture-diagram-skill)](https://skills.sh/vidanov/aws-architecture-diagram-skill)
  40. <details>
  41. <summary><b>ChatGPT, Claude Projects, or any AI with custom instructions</b></summary>
  42. No CLI required:
  43. 1. Copy the prompt from [`chatgpt/PROMPT.md`](chatgpt/PROMPT.md) into your system prompt or custom instructions
  44. 2. Upload the reference files from [`chatgpt/references/`](chatgpt/references/) to the knowledge base
  45. 3. Start asking for diagrams
  46. > Tip: Set temperature to 0.3 for consistent XML output.
  47. </details>
  48. <details>
  49. <summary><b>Manual install (Claude Code / Kiro CLI)</b></summary>
  50. ```bash
  51. # Claude Code
  52. mkdir -p ~/.claude/skills/aws-architecture-diagram
  53. cp claude/SKILL.md ~/.claude/skills/aws-architecture-diagram/SKILL.md
  54. cp -r references ~/.claude/skills/aws-architecture-diagram/references
  55. # Kiro CLI (global)
  56. mkdir -p ~/.kiro/skills/aws-architecture-diagram
  57. cp kiro/SKILL.md ~/.kiro/skills/aws-architecture-diagram/SKILL.md
  58. cp -r references ~/.kiro/skills/aws-architecture-diagram/references
  59. ```
  60. </details>
  61. ## Usage
  62. Ask for a diagram:
  63. ```
  64. Create an AWS architecture diagram for a serverless API with Lambda, DynamoDB, and API Gateway
  65. ```
  66. With export:
  67. ```
  68. Create an AWS architecture diagram as PNG for a real-time data pipeline with Kinesis, Lambda, and S3
  69. ```
  70. ## Example output
  71. ### Event-driven order processing
  72. > "Create an event-driven order processing architecture with SQS, Lambda, DynamoDB, and EventBridge"
  73. ![Event-Driven Order Processing](docs/example-event-driven.png)
  74. [Download .drawio](examples/example-event-driven.drawio)
  75. ### Real-time IoT analytics
  76. > "Create a real-time IoT analytics pipeline with Kinesis, Lambda, S3 data lake, and DynamoDB"
  77. ![Real-Time IoT Analytics](docs/example-streaming.png)
  78. [Download .drawio](examples/example-streaming.drawio)
  79. ### 3-tier web application
  80. > "Create a 3-tier web application with CloudFront, ALB, ECS Fargate, Aurora, and ElastiCache"
  81. ![3-Tier Web Application](docs/example-3tier.png)
  82. [Download .drawio](examples/example-3tier.drawio)
  83. ### 3D serverless API (isometric)
  84. > "Create a 3D AWS architecture diagram for a serverless API with Lambda, DynamoDB, and S3"
  85. ![3D Serverless API](docs/example-3d-serverless-api.drawio.png)
  86. [Download .drawio](examples/example-3d-serverless-api.drawio)
  87. ### 3D e-commerce website architecture (isometric)
  88. > "Create a 3D isometric AWS architecture for an e-commerce website"
  89. ![3D E-Commerce Architecture](docs/example-3d-ecommerce-website-architecture.drawio.png)
  90. [Download .drawio](examples/example-3d-ecommerce-website-architecture.drawio)
  91. ## Why icons break (and how this skill prevents it)
  92. draw.io AWS icons have two patterns with opposite `strokeColor` rules:
  93. | Pattern | Style | strokeColor | Use for |
  94. |---------|-------|-------------|---------|
  95. | Service-level | `shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.<name>` | `#ffffff` (required) | Main service icons (colored square + white glyph) |
  96. | Resource-level | `shape=mxgraph.aws4.<name>` | `none` (required) | Sub-resources (silhouette icons) |
  97. Confusing these two patterns is the #1 cause of broken icons in AI-generated diagrams. The skill encodes the correct pattern for every icon.
  98. draw.io stencil names also don't match current AWS service names. Renamed services keep old identifiers (OpenSearch is still `elasticsearch_service` in the stencil). The skill carries the correct mapping so the agent never guesses.
  99. ## What the skill enforces
  100. - Left-to-right flow (UI on left, data on right)
  101. - 78px icons, strokeWidth=2 edges, AWS color palette
  102. - Minimum 220px horizontal spacing, 250px vertical between lanes
  103. - Two-step approach: generate XML, export to PNG, visually verify, fix if needed
  104. - Only verified stencil names (no empty-box surprises)
  105. ## Supported services (270+ icons)
  106. | Category | Examples |
  107. |----------|----------|
  108. | Compute | Lambda, EC2, ECS, EKS, Fargate |
  109. | App Integration | API Gateway, SNS, SQS, EventBridge, Step Functions |
  110. | Database | DynamoDB, RDS, Aurora, ElastiCache |
  111. | Storage | S3, EFS, EBS |
  112. | Networking | CloudFront, Route 53, VPC, ELB (ALB/NLB) |
  113. | Security | IAM, Cognito, KMS, WAF |
  114. | Analytics/ML | Kinesis, Athena, Bedrock, SageMaker |
  115. ## Known broken stencils (avoid these)
  116. - `mxgraph.aws4.dynamodb_table` → use `mxgraph.aws4.dynamodb` instead
  117. - `mxgraph.aws4.dynamodb_stream` → use `mxgraph.aws4.dynamodb` with label
  118. - `mxgraph.aws4.general_saml_token` → use `mxgraph.aws4.traditional_server`
  119. ## Comparison
  120. | Solution | Output | Editable | Zero deps | Verified icons |
  121. |----------|--------|----------|-----------|----------------|
  122. | **This skill** | `.drawio` | yes | yes (markdown file) | yes (270+) |
  123. | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) | `.drawio` | yes | no (MCP server) | no |
  124. | [awslabs/aws-diagram-mcp-server](https://pypi.org/project/awslabs.aws-diagram-mcp-server/) | PNG | no | no (Python+GraphViz) | N/A |
  125. | [awslabs/diagram-as-code](https://github.com/awslabs/diagram-as-code) | PNG/SVG | no | no (Go binary) | N/A |
  126. | [clouda.ai](https://clouda.ai/) | PNG | no | N/A (SaaS) | N/A |
  127. No runtime dependencies. A markdown file, not a server. Output is native `.drawio` XML you can open, edit, and version-control.
  128. ## Structure
  129. ```
  130. aws-architecture-diagram-skill/
  131. ├── chatgpt/
  132. │ ├── PROMPT.md # Universal prompt (any AI assistant)
  133. │ └── references/ # Icon catalog in .txt format
  134. ├── kiro/SKILL.md # Kiro CLI version
  135. ├── claude/SKILL.md # Claude Code version
  136. ├── references/ # Icon catalog in .md format (9 files)
  137. ├── examples/ # Example .drawio outputs
  138. ├── templates/ # Base templates
  139. └── docs/ # Hero image, example PNGs
  140. ```
  141. ## Contributing
  142. PRs welcome:
  143. - Found a broken stencil name? Fix it.
  144. - Want to add a new AWS service icon? Add it to the correct references file.
  145. - Layout improvement ideas? Open an issue or PR.
  146. - Bug with a specific AI agent? Report it.
  147. ## Contributors
  148. - [@svetozarm](https://github.com/svetozarm) (Svetozar Miucin) · Kiro CLI install support
  149. - [@SyedSamrozeAli](https://github.com/SyedSamrozeAli) (Syed Samroze Ali) · 3D isometric diagram support
  150. ## License
  151. MIT
  152. ---
  153. If this saved you a diagramming session, a star ⭐ helps the next person find it.
  154. ## Also by the author
  155. - [writing-craft-skill](https://github.com/vidanov/writing-craft-skill): teach AI agents to write well using classic copywriting craft plus AI anti-pattern detection
  156. - [shape](https://github.com/vidanov/shape): runtime governance for AI agents (phases, transactions, budget gates, proof traces)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.