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.
Badge for your README
Markdown
[](/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
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)
- # Architecture Diagram Generator
- **Need an architecture diagram? Get AI to build you one.**
- 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.
- - **No design skills needed** — just describe your architecture in plain English
- - **Iterate quickly** — ask Claude to add components, change layouts, or update styles
- - **Share easily** — output is a single HTML file, no special software required
- - **Export built in** — Copy / PNG / PDF buttons baked into every diagram
- 
- 
- 
- ## 🚀 Quick Start (3 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
- ```
- ---
- ## 📸 Examples
- ### Web Application (React + Node.js + PostgreSQL)
- 
- ### AWS Serverless (Lambda + API Gateway + DynamoDB)
- 
- ### Microservices (Kubernetes + API Gateway)
- 
- ## 📤 Export your diagram
- Open the HTML file in any modern browser and use the toolbar in the header:
- - **📋 Copy** — copy a high-resolution PNG to your clipboard, paste straight into Slides, Docs, or Slack
- - **🖼️ PNG** — download a high-resolution PNG file (great for slides and screenshots)
- - **📄 PDF** — download a PDF that preserves the dark theme
- No install. No command line. Just open the file and click.
- ## ✨ Features
- - **Beautiful dark theme** — Slate-950 background with subtle grid pattern
- - **Semantic color coding** — Consistent colors for frontend, backend, database, cloud, and security components
- - **Self-contained output** — Single HTML file with embedded CSS and inline SVG
- - **Works in any browser** — nothing to install, just open the file
- - **Professional typography** — JetBrains Mono for that technical aesthetic
- - **Smart layering** — Arrows render cleanly behind component boxes
- ## 🎨 Color Palette
- | Component Type | Color | Use For |
- | -------------- | ------- | --------------------------------- |
- | Frontend | Cyan | Client apps, UI, edge devices |
- | Backend | Emerald | Servers, APIs, services |
- | Database | Violet | Databases, storage, AI/ML |
- | Cloud/AWS | Amber | Cloud services, infrastructure |
- | Security | Rose | Auth, security groups, encryption |
- | External | Slate | Generic, external systems |
- ## 📦 Installation
- > ⚠️ **Available on:** Free, Pro, Max, Team, and Enterprise plans
- >
- > **Prerequisite:** Code Execution must be enabled before you can upload a custom skill:
- > - Free / Pro / Max — turn on under **Settings → Capabilities**
- > - Team / Enterprise — admin enables under **Organization settings → Skills**
- > 📚 **New to Claude Skills?** Check out the official guide: [Use Skills in Claude](https://support.claude.com/en/articles/12512180-use-skills-in-claude)
- ### Claude.ai (Recommended)
- 1. Download [`architecture-diagram.zip`](architecture-diagram.zip)
- 2. Go to **Customize** → **Skills**
- 3. Click the **+** button, then **+ Create skill**, then **Upload a skill**
- 4. Choose the zip file and toggle the skill on
- ### Claude.ai Projects (Alternative)
- 1. In your Claude.ai Project, upload the [`architecture-diagram.zip`](architecture-diagram.zip) to the Project Knowledge
- ### Claude Code CLI
- Extract to your skills directory:
- ```bash
- # Global skills
- unzip architecture-diagram.zip -d ~/.claude/skills/
- # Or project-local
- unzip architecture-diagram.zip -d ./.claude/skills/
- ```
- ### Manual Setup
- Simply ensure both files are accessible to Claude:
- ```
- architecture-diagram/
- ├── SKILL.md # Skill instructions
- └── resources/
- └── template.html # Base template
- ```
- ## 💾 Output
- Claude generates a self-contained HTML file that you can:
- - Open directly in any browser
- - Share with teammates (just send the file!)
- - Include in documentation
- - Print or export to PDF
- - Host on any static site
- ## 📐 What's Included in Output
- Each generated diagram includes:
- 1. **Header** — Project title with animated status indicator
- 2. **Main diagram** — SVG with all components and connections
- 3. **Summary cards** — 3 info cards highlighting key details
- 4. **Footer** — Project metadata
- ## 🛠 Customization
- The skill uses a consistent design system, but Claude will adapt:
- - **Layout** — Components positioned based on your system's flow
- - **Connections** — Arrows showing data flow and relationships
- - **Labels** — Protocols, ports, and annotations
- - **Groupings** — Security groups, cloud regions, bounded contexts
- ## 📄 Example Output
- The generated HTML structure:
- ```html
- <!DOCTYPE html>
- <html>
- <head>
- <!-- Embedded styles, Google Fonts -->
- </head>
- <body>
- <div class="container">
- <div class="header"><!-- Title --></div>
- <div class="diagram-container">
- <svg><!-- Architecture diagram --></svg>
- </div>
- <div class="cards"><!-- Summary cards --></div>
- <p class="footer"><!-- Metadata --></p>
- </div>
- </body>
- </html>
- ```
- ## 🔧 Technical Details
- - **SVG viewBox:** Typically 1000-1100px wide, scales responsively
- - **Font:** JetBrains Mono (loaded from Google Fonts)
- - **Background:** `#020617` with 40px grid pattern
- - **Z-ordering:** Arrows drawn first, masked by opaque backgrounds under transparent component fills
- ## 📄 Sister skill
- 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.
- ## 📝 License
- MIT License — Free to use, modify, and distribute.
- ## 👥 Contributing
- Suggestions and improvements welcome! Feel free to:
- - Open an issue for bugs or feature requests
- - Submit a PR with enhancements
- - Share your generated diagrams
- ## 📬 Contact
- **Cocoon AI**
- 📧 hello@cocoon-ai.com
- ---
- Made with ❤️ by [Cocoon AI](https://cocoon-ai.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.