Skip to content
Back to search

architecture-diagram-generator

Generate beautiful dark-themed system architecture diagrams as standalone HTML/SVG files. Works as a Claude AI skill.

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/cocoon-ai-architecture-diagram-generator/badge.svg)](/listings/cocoon-ai-architecture-diagram-generator)

HTML

<a href="/listings/cocoon-ai-architecture-diagram-generator"><img src="/api/listings/cocoon-ai-architecture-diagram-generator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

Step 1: Install the Skill

> ⚠️ Available on Free, Pro, Max, Team, and Enterprise plans (Code Execution must be enabled in **Settings → Capabilities** first)

1. Download [`architecture-diagram.zip`](architecture-diagram.zip) 2. Go to [claude.ai](https://claude.ai) → **Customize** → **Skills** 3. Click the **+** button → **+ Create skill** → **Upload a skill**, then upload the zip file 4. Toggle the skill on

📚 Need help? See the [full installation guide](#-installation) below.

Step 2: Get Text that Describes Your Architecture

You just need a text description of your system. Pick whichever works for you:

**Option A: Have AI analyze your codebase**

Open your code in Cursor, Claude Code, Windsurf, or ChatGPT and ask:

Analyze this codebase and describe the architecture. Include all major
components, how they connect, what technologies they use, and any cloud
services or integrations. Format as a list for an architecture diagram.

**Option B: Write it yourself**

Just list your components and how they connect:

- React frontend talking to a Node.js API
- PostgreSQL database
- Redis for caching
- Hosted on AWS with CloudFront CDN

**Option C: Ask for a typical architecture**

Don't have a specific system? Ask Claude for a starting point:

What's a typical architecture for a SaaS application?

Step 3: Generate Your Diagram by Asking Claude to Use the Skill

Take the output from Step 2 and paste it into [Claude](https://claude.ai) (with the Architecture Diagram Generator skill installed):

Use your architecture diagram skill to create an architecture diagram from this description:

[PASTE YOUR ARCHITECTURE DESCRIPTION HERE]

That's it! Claude will generate a beautiful HTML file you can open in any browser.

Then! You can iterate simply by using chat. Ask Claude: Please update XYZ to see your diagram update in real time. You can ask Claude to fix any issues you have with the diagram as well.

---

Example Prompts for Common Scenarios

**For a web app:**

Create an architecture diagram for a web application with:
- React frontend
- Node.js/Express API
- PostgreSQL database
- Redis cache
- JWT authentication

**For AWS serverless:**

Create an architecture diagram showing:
- CloudFront CDN
- API Gateway
- Lambda functions (Node.js)
- DynamoDB
- S3 for static assets
- Cognito for auth

**For microservices:**

Create an architecture diagram for a microservices system with:
- React web app and mobile clients
- Kong API Gateway
- User Service (Go), Order Service (Java), Product Service (Python)
- PostgreSQL, MongoDB, and Elasticsearch databases
- Kafka for event streaming
- Kubernetes orchestration

---

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.

README.md · README · 286 lines

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

  1. # Architecture Diagram Generator
  2. **Need an architecture diagram? Get AI to build you one.**
  3. Use [Claude.ai](https://claude.ai) with this special skill to generate professional architecture diagrams in seconds. Describe your system, and Claude creates a beautiful, dark-themed diagram as a standalone HTML file you can open in any browser.
  4. - **No design skills needed** — just describe your architecture in plain English
  5. - **Iterate quickly** — ask Claude to add components, change layouts, or update styles
  6. - **Share easily** — output is a single HTML file, no special software required
  7. - **Export built in** — Copy / PNG / PDF buttons baked into every diagram
  8. ![Version](https://img.shields.io/badge/version-1.1-blue)
  9. ![License](https://img.shields.io/badge/license-MIT-green)
  10. ![Claude](https://img.shields.io/badge/Claude-Skill-orange)
  11. ## 🚀 Quick Start (3 Steps)
  12. ### Step 1: Install the Skill
  13. > ⚠️ Available on Free, Pro, Max, Team, and Enterprise plans (Code Execution must be enabled in **Settings → Capabilities** first)
  14. 1. Download [`architecture-diagram.zip`](architecture-diagram.zip)
  15. 2. Go to [claude.ai](https://claude.ai) → **Customize** → **Skills**
  16. 3. Click the **+** button → **+ Create skill** → **Upload a skill**, then upload the zip file
  17. 4. Toggle the skill on
  18. 📚 Need help? See the [full installation guide](#-installation) below.
  19. ### Step 2: Get Text that Describes Your Architecture
  20. You just need a text description of your system. Pick whichever works for you:
  21. **Option A: Have AI analyze your codebase**
  22. Open your code in Cursor, Claude Code, Windsurf, or ChatGPT and ask:
  23. ```
  24. Analyze this codebase and describe the architecture. Include all major
  25. components, how they connect, what technologies they use, and any cloud
  26. services or integrations. Format as a list for an architecture diagram.
  27. ```
  28. **Option B: Write it yourself**
  29. Just list your components and how they connect:
  30. ```
  31. - React frontend talking to a Node.js API
  32. - PostgreSQL database
  33. - Redis for caching
  34. - Hosted on AWS with CloudFront CDN
  35. ```
  36. **Option C: Ask for a typical architecture**
  37. Don't have a specific system? Ask Claude for a starting point:
  38. ```
  39. What's a typical architecture for a SaaS application?
  40. ```
  41. ### Step 3: Generate Your Diagram by Asking Claude to Use the Skill
  42. Take the output from Step 2 and paste it into [Claude](https://claude.ai) (with the Architecture Diagram Generator skill installed):
  43. ```
  44. Use your architecture diagram skill to create an architecture diagram from this description:
  45. [PASTE YOUR ARCHITECTURE DESCRIPTION HERE]
  46. ```
  47. That's it! Claude will generate a beautiful HTML file you can open in any browser.
  48. Then! You can iterate simply by using chat. Ask Claude: Please update XYZ to see your diagram update in real time. You can ask Claude to fix any issues you have with the diagram as well.
  49. ---
  50. ### Example Prompts for Common Scenarios
  51. **For a web app:**
  52. ```
  53. Create an architecture diagram for a web application with:
  54. - React frontend
  55. - Node.js/Express API
  56. - PostgreSQL database
  57. - Redis cache
  58. - JWT authentication
  59. ```
  60. **For AWS serverless:**
  61. ```
  62. Create an architecture diagram showing:
  63. - CloudFront CDN
  64. - API Gateway
  65. - Lambda functions (Node.js)
  66. - DynamoDB
  67. - S3 for static assets
  68. - Cognito for auth
  69. ```
  70. **For microservices:**
  71. ```
  72. Create an architecture diagram for a microservices system with:
  73. - React web app and mobile clients
  74. - Kong API Gateway
  75. - User Service (Go), Order Service (Java), Product Service (Python)
  76. - PostgreSQL, MongoDB, and Elasticsearch databases
  77. - Kafka for event streaming
  78. - Kubernetes orchestration
  79. ```
  80. ---
  81. ## 📸 Examples
  82. ### Web Application (React + Node.js + PostgreSQL)
  83. ![Web App Architecture](examples/images/web-app.png)
  84. ### AWS Serverless (Lambda + API Gateway + DynamoDB)
  85. ![AWS Serverless Architecture](examples/images/aws-serverless.png)
  86. ### Microservices (Kubernetes + API Gateway)
  87. ![Microservices Architecture](examples/images/microservices.png)
  88. ## 📤 Export your diagram
  89. Open the HTML file in any modern browser and use the toolbar in the header:
  90. - **📋 Copy** — copy a high-resolution PNG to your clipboard, paste straight into Slides, Docs, or Slack
  91. - **🖼️ PNG** — download a high-resolution PNG file (great for slides and screenshots)
  92. - **📄 PDF** — download a PDF that preserves the dark theme
  93. No install. No command line. Just open the file and click.
  94. ## ✨ Features
  95. - **Beautiful dark theme** — Slate-950 background with subtle grid pattern
  96. - **Semantic color coding** — Consistent colors for frontend, backend, database, cloud, and security components
  97. - **Self-contained output** — Single HTML file with embedded CSS and inline SVG
  98. - **Works in any browser** — nothing to install, just open the file
  99. - **Professional typography** — JetBrains Mono for that technical aesthetic
  100. - **Smart layering** — Arrows render cleanly behind component boxes
  101. ## 🎨 Color Palette
  102. | Component Type | Color | Use For |
  103. | -------------- | ------- | --------------------------------- |
  104. | Frontend | Cyan | Client apps, UI, edge devices |
  105. | Backend | Emerald | Servers, APIs, services |
  106. | Database | Violet | Databases, storage, AI/ML |
  107. | Cloud/AWS | Amber | Cloud services, infrastructure |
  108. | Security | Rose | Auth, security groups, encryption |
  109. | External | Slate | Generic, external systems |
  110. ## 📦 Installation
  111. > ⚠️ **Available on:** Free, Pro, Max, Team, and Enterprise plans
  112. >
  113. > **Prerequisite:** Code Execution must be enabled before you can upload a custom skill:
  114. > - Free / Pro / Max — turn on under **Settings → Capabilities**
  115. > - Team / Enterprise — admin enables under **Organization settings → Skills**
  116. > 📚 **New to Claude Skills?** Check out the official guide: [Use Skills in Claude](https://support.claude.com/en/articles/12512180-use-skills-in-claude)
  117. ### Claude.ai (Recommended)
  118. 1. Download [`architecture-diagram.zip`](architecture-diagram.zip)
  119. 2. Go to **Customize** → **Skills**
  120. 3. Click the **+** button, then **+ Create skill**, then **Upload a skill**
  121. 4. Choose the zip file and toggle the skill on
  122. ### Claude.ai Projects (Alternative)
  123. 1. In your Claude.ai Project, upload the [`architecture-diagram.zip`](architecture-diagram.zip) to the Project Knowledge
  124. ### Claude Code CLI
  125. Extract to your skills directory:
  126. ```bash
  127. # Global skills
  128. unzip architecture-diagram.zip -d ~/.claude/skills/
  129. # Or project-local
  130. unzip architecture-diagram.zip -d ./.claude/skills/
  131. ```
  132. ### Manual Setup
  133. Simply ensure both files are accessible to Claude:
  134. ```
  135. architecture-diagram/
  136. ├── SKILL.md # Skill instructions
  137. └── resources/
  138. └── template.html # Base template
  139. ```
  140. ## 💾 Output
  141. Claude generates a self-contained HTML file that you can:
  142. - Open directly in any browser
  143. - Share with teammates (just send the file!)
  144. - Include in documentation
  145. - Print or export to PDF
  146. - Host on any static site
  147. ## 📐 What's Included in Output
  148. Each generated diagram includes:
  149. 1. **Header** — Project title with animated status indicator
  150. 2. **Main diagram** — SVG with all components and connections
  151. 3. **Summary cards** — 3 info cards highlighting key details
  152. 4. **Footer** — Project metadata
  153. ## 🛠 Customization
  154. The skill uses a consistent design system, but Claude will adapt:
  155. - **Layout** — Components positioned based on your system's flow
  156. - **Connections** — Arrows showing data flow and relationships
  157. - **Labels** — Protocols, ports, and annotations
  158. - **Groupings** — Security groups, cloud regions, bounded contexts
  159. ## 📄 Example Output
  160. The generated HTML structure:
  161. ```html
  162. <!DOCTYPE html>
  163. <html>
  164. <head>
  165. <!-- Embedded styles, Google Fonts -->
  166. </head>
  167. <body>
  168. <div class="container">
  169. <div class="header"><!-- Title --></div>
  170. <div class="diagram-container">
  171. <svg><!-- Architecture diagram --></svg>
  172. </div>
  173. <div class="cards"><!-- Summary cards --></div>
  174. <p class="footer"><!-- Metadata --></p>
  175. </div>
  176. </body>
  177. </html>
  178. ```
  179. ## 🔧 Technical Details
  180. - **SVG viewBox:** Typically 1000-1100px wide, scales responsively
  181. - **Font:** JetBrains Mono (loaded from Google Fonts)
  182. - **Background:** `#020617` with 40px grid pattern
  183. - **Z-ordering:** Arrows drawn first, masked by opaque backgrounds under transparent component fills
  184. ## 📄 Sister skill
  185. For step-by-step workflows that unfold in time — approval flows, runbooks, automation pipelines, [process-flow-diagram-generator](https://github.com/Cocoon-AI/process-flow-diagram-generator) — same design language, different shape language.
  186. ## 📝 License
  187. MIT License — Free to use, modify, and distribute.
  188. ## 👥 Contributing
  189. Suggestions and improvements welcome! Feel free to:
  190. - Open an issue for bugs or feature requests
  191. - Submit a PR with enhancements
  192. - Share your generated diagrams
  193. ## 📬 Contact
  194. **Cocoon AI**
  195. 📧 hello@cocoon-ai.com
  196. ---
  197. Made with ❤️ by [Cocoon AI](https://cocoon-ai.com)

Ratings and comments

Sign in to rate this skill.

Sign in

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