architecture-diagram
Skill1 starsChanged 26 days agoMITView on GitHub
Create polished dark-themed architecture diagrams as self-contained HTML+SVG files. Use when the user asks for system, infrastructure, cloud, security, or network topology diagrams.
48 other projects use a version of this, 22 of them edited.
Adopted by
Most recently taken up by
- zyx0407/skillstheir own version, first seen Nov 16, 2026
- bharathgnana/archdiagramtheir own version, first seen Nov 16, 2026
- rodos4312/Meu-Agentedited, first seen Nov 15, 2026
- ottuck/diagram-polishtheir own version, first seen Nov 15, 2026
- incredible404-rgb/zstacktheir own version, first seen Nov 15, 2026
- betoxf/universal-computer-usetheir own version, first seen Nov 15, 2026
Used with
Projects with it also use competitor-news-monitor, blocked-page-recovery and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Samin12Skillcompetitor-news-monitor
Watch named companies for material news; cited digests.
Also in 6 projects that use this
nobodyohm-webSkillblocked-page-recovery
Recover blocked/paywalled/WAF'd pages via fallbacks.
Also in 6 projects that use this
Samin12Skilldocument-to-action-items
Extract cited obligations, deadlines, tasks from documents.
Also in 6 projects that use this
VercelSkillagent-desktop-linux
Linux platform guide for the agent-desktop CLI. Lists per command group what works on X11 and on Wayland, how to check the AT-SPI accessibility bus, the first-contact gotchas (app names, Chromium and Electron flags, headed focus, blocked key combos), and where to find lifecycle, screenshot, clipboard, tray, notification and troubleshooting details. Triggers on: "linux desktop automation", "AT-SPI tree", "automate GNOME app", "agent-desktop on Linux", "accessibility bus not available", "empty supported_surfaces", "wayland screenshot consent", or any Linux GUI interaction task.
Also in 3 projects that use this
VercelSkillagent-desktop-macos
macOS platform guide for the agent-desktop CLI. Use for desktop automation on macOS: granting Accessibility and Screen Recording permission (TCC), what headed mode does on macOS (physical-first click, type and scroll), surfaces (menu, menubar, sheet, popover, alert, dock, menu-bar-extras), menu bar apps and system panels with no window, Notification Center, Chromium and Electron apps including launch --cdp, and fixing PERM_DENIED, empty accessibility trees, ACTION_FAILED and APP_UNRESPONSIVE.
Also in 3 projects that use this
michaellam26Skillsdlc-review
Trigger stage-specific reviews for an SDLC project and save results to reviews/
Also in 5 projects that use this
- +2 more from vercel-labs
- +1 more from Samin12
Other versions48 projects use a version of this.
Word for word · 2
- Cocoon-AI/architecture-diagram-generator★ 7.4k100% same
- iasiv5/skills★ 3100% same
Edited · 22
- NousResearch/hermes-agent★ 264k17% same
- Tommy-yw/RunbookHermes★ 54615% same
- wundercorp/loki★ 2817% same
- ulises-jeremias/agent-toolkit★ 2040% same
- delorenj/skills★ 1717% same
- Samin12/skills★ 817% same
- The-Utopia-Studio/skills★ 692% same
- MakiDevelop/claude-skills★ 373% same
- abduznik/abduznik-skills★ 217% same
- john-data-chen/hermes-agent-backup★ 217% same
12 more not listed
Wrote their own version · 24
- lahfir/agent-desktop★ 24ksame name
- vercel-labs/agent-desktop★ 24ksame name
- Mathews-Tom/armory★ 340same name
- konraddzbik/architecture-diagram-skill★ 143same name
- proyecto26/system-design-skills★ 118same name
- microsoft/github-copilot-modernization★ 48same name
- Nanford/Nanford-skills★ 18same name
- d-oit/rust-2026-template★ 15same name
- ZhouYinLong-lab/Dog-Skills★ 7same name
- iopsystems/skills-mcp★ 6same name
14 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository76 other files it gives its agents.
- criteria-auditSkill
- disk-space-auditSkill
- frontend-slidesSkill
- gpt-researcherSkill
- banner-designSkill
- brandSkill
- designSkill
- design-systemSkill
- slidesSkill
- ui-stylingSkill
- ui-ux-pro-maxSkill
- intended-vs-implementedSkill
- cohort-analysisSkill
- brainstorm-okrsSkill
- create-prdSkill
- job-storiesSkill
- outcome-roadmapSkill
- pre-mortemSkill
- prioritization-frameworksSkill
- release-notesSkill
- retroSkill
- sprint-planSkill
- stakeholder-mapSkill
- strategy-red-teamSkill
- summarize-meetingSkill
- test-scenariosSkill
- user-storiesSkill
- wwasSkill
- beachhead-segmentSkill
- competitive-battlecardSkill
- growth-loopsSkill
- gtm-motionsSkill
- gtm-strategySkill
- ideal-customer-profileSkill
- marketing-ideasSkill
- north-star-metricSkill
- positioning-ideasSkill
- product-nameSkill
- value-prop-statementsSkill
- competitor-analysisSkill
- customer-journey-mapSkill
- market-segmentsSkill
- market-sizingSkill
- sentiment-analysisSkill
- user-personasSkill
- user-segmentationSkill
- analyze-feature-requestsSkill
- brainstorm-experiments-existingSkill
- brainstorm-experiments-newSkill
- brainstorm-ideas-existingSkill
- brainstorm-ideas-newSkill
- identify-assumptions-existingSkill
- identify-assumptions-newSkill
- interview-scriptSkill
- metrics-dashboardSkill
- opportunity-solution-treeSkill
- prioritize-assumptionsSkill
- prioritize-featuresSkill
- summarize-interviewSkill
- ansoff-matrixSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. 0 are common, 11 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 43 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Create professional technical architecture diagrams as self-contained HTML files with inline SVG graphics and CSS styling.
- Distinctive: line 16
Use these semantic colors for component types:
- Distinctive: line 30
Use JetBrains Mono for all text (monospace, technical aesthetic):
- Distinctive: line 52
Arrows: Use SVG marker for arrowheads:
- Distinctive: line 79
CRITICAL: When stacking components vertically, ensure proper spacing to avoid overlaps:
- Distinctive: line 83
Inline connectors (message buses): Place IN the gap between components, not overlapping
- Distinctive: line 97
CRITICAL: Place legends OUTSIDE all boundary boxes (region boundaries, cluster boundaries, security groups).
- Distinctive: line 100
Place legend at least 20px below the lowest boundary
- Distinctive: line 124
When generating a new diagram, keep these intact in the template:
- Very specific: line 163
Update the <title> and header text
- Very specific: line 165
Add/remove/reposition component boxes
- Distinctive: line 167
Update the three summary cards
- Very specific: line 172
Always produce a single self-contained .html file with:
- Distinctive: line 175
No JavaScript required (pure CSS animations)
“Common” is measured: kept by at least 6 in 10 of the 43 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Architecture Diagram Skill
Create professional technical architecture diagrams as self-contained HTML files with inline SVG graphics and CSS styling.
Version 1.1 · MIT License · Authored by Cocoon AI
Design System
Color Palette
Use these semantic colors for component types:
| Component Type | Fill (rgba) | Stroke |
| Frontend | rgba(8, 51, 68, 0.4) | #22d3ee (cyan-400) |
| Backend | rgba(6, 78, 59, 0.4) | #34d399 (emerald-400) |
| Database | rgba(76, 29, 149, 0.4) | #a78bfa (violet-400) |
| AWS/Cloud | rgba(120, 53, 15, 0.3) | #fbbf24 (amber-400) |
| Security | rgba(136, 19, 55, 0.4) | #fb7185 (rose-400) |
| Message Bus | rgba(251, 146, 60, 0.3) | #fb923c (orange-400) |
| External/Generic | rgba(30, 41, 59, 0.5) | #94a3b8 (slate-400) |
Typography
Use JetBrains Mono for all text (monospace, technical aesthetic):
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">Font sizes: 12px for component names, 9px for sublabels, 8px for annotations, 7px for tiny labels.
Visual Elements
Background: #020617 (slate-950) with subtle grid pattern:
<pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
<path d="M 40 0 L 0 0 0 40" fill="none" stroke="#1e293b" stroke-width="0.5"/>
</pattern>Component boxes: Rounded rectangles (rx="6") with 1.5px stroke, semi-transparent fills.
Security groups: Dashed stroke (stroke-dasharray="4,4"), transparent fill, rose color.
Region boundaries: Larger dashed stroke (stroke-dasharray="8,4"), amber color, rx="12".
Arrows: Use SVG marker for arrowheads:
<marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
<polygon points="0 0, 10 3.5, 0 7" fill="#64748b" />
</marker>Arrow z-order: Draw connection arrows early in the SVG (after the background grid) so they render behind component boxes. SVG elements are painted in document order, so arrows drawn first will appear behind shapes drawn later.
Masking arrows behind transparent fills: Since component boxes use semi-transparent fills (rgba(..., 0.4)), arrows behind them will show through. To fully mask arrows, draw an opaque background rect (e.g., fill="#0f172a") at the same position before drawing the semi-transparent styled rect on top:
<!-- Opaque background to mask arrows -->
<rect x="X" y="Y" width="W" height="H" rx="6" fill="#0f172a"/>
<!-- Styled component on top -->
<rect x="X" y="Y" width="W" height="H" rx="6" fill="rgba(76, 29, 149, 0.4)" stroke="#a78bfa" stroke-width="1.5"/>Auth/security flows: Dashed lines in rose color (#fb7185).
Message buses / Event buses: Small connector elements between services. Use orange color (#fb923c stroke, rgba(251, 146, 60, 0.3) fill):
<rect x="X" y="Y" width="120" height="20" rx="4" fill="rgba(251, 146, 60, 0.3)" stroke="#fb923c" stroke-width="1"/>
<text x="CENTER_X" y="Y+14" fill="#fb923c" font-size="7" text-anchor="middle">Kafka / RabbitMQ</text>Spacing Rules
CRITICAL: When stacking components vertically, ensure proper spacing to avoid overlaps:
- Standard component height: 60px for services, 80-120px for larger components
- Minimum vertical gap between components: 40px
- Inline connectors (message buses): Place IN the gap between components, not overlapping
Example vertical layout:
Component A: y=70, height=60 → ends at y=130
Gap: y=130 to y=170 → 40px gap, place bus at y=140 (20px tall)
Component B: y=170, height=60 → ends at y=230Wrong: Placing a message bus at y=160 when Component B starts at y=170 (causes overlap) Right: Placing a message bus at y=140, centered in the 40px gap (y=130 to y=170)
Legend Placement
CRITICAL: Place legends OUTSIDE all boundary boxes (region boundaries, cluster boundaries, security groups).
- Calculate where all boundaries end (y position + height)
- Place legend at least 20px below the lowest boundary
- Expand SVG viewBox height if needed to accommodate
Example:
Kubernetes Cluster: y=30, height=460 → ends at y=490
Legend should start at: y=510 or below
SVG viewBox height: at least 560 to fit legendWrong: Legend at y=470 inside a cluster boundary that ends at y=490 Right: Legend at y=510, below the cluster boundary, with viewBox height extended
Layout Structure
- Header - Title with pulsing dot indicator, subtitle, and export toolbar
- Main SVG diagram - Contained in rounded border card
- Summary cards - Grid of 3 cards below diagram with key details
- Footer - Minimal metadata line
Export Toolbar (built-in)
Every diagram ships with a single unobtrusive ⋯ toggle in the header. Click it to reveal three buttons — 📋 Copy (high-DPI PNG to clipboard, scale: 2), 🖼️ PNG (high-DPI PNG download), 📄 PDF (PNG embedded in a one-page PDF via jsPDF). The toolbar collapses back to the icon by default so it doesn't clutter the diagram. All three formats use the same html2canvas capture (with the toolbar excluded and 32px padding around the content), so PDF preserves the dark theme without going through the browser's print dialog.
When generating a new diagram, keep these intact in the template:
- The two CDN scripts in
<head>(pinned versions, with Subresource Integrity hashes andcrossorigin="anonymous"):https://cdn.jsdelivr.net/npm/html2canvas@1.4.1/dist/html2canvas.min.js—integrity="sha384-ZZ1pncU3bQe8y31yfZdMFdSpttDoPmOZg2wguVK9almUodir1PghgT0eY7Mrty8H"https://cdn.jsdelivr.net/npm/jspdf@2.5.2/dist/jspdf.umd.min.js—integrity="sha384-en/ztfPSRkGfME4KIm05joYXynqzUgbsG5nMrj/xEFAHXkeZfO3yMK8QQ+mP7p1/"- SRI ensures generated diagrams are tamper-resistant against CDN compromise. Do not modify the hashes; if the version is bumped, the new hash must be computed fresh.
id="report-container"on the outermost.containerdiv (this is what gets captured).toolbarmarkup with.toolbar-actions(collapsed by default) and.toolbar-toggle(the⋯button).toolbarCSS +@media print { .toolbar { display: none !important; } }copyAsImage(),downloadPNG(), anddownloadPDF()script before</body>, all usinggetBoundingClientRect()+html2canvas(document.body, { x, y, width, height, ignoreElements })to capture a precise rect with breathing room and no toolbar
Caveats: clipboard API needs a user gesture and a secure context (https/file/localhost). SVG <foreignObject> renders inconsistently in html2canvas — stick to plain <svg> shapes and <text>. Bump scale: 2 to 3 or 4 for higher-res output.
Component Box Pattern
<rect x="X" y="Y" width="W" height="H" rx="6" fill="FILL_COLOR" stroke="STROKE_COLOR" stroke-width="1.5"/>
<text x="CENTER_X" y="Y+20" fill="white" font-size="11" font-weight="600" text-anchor="middle">LABEL</text>
<text x="CENTER_X" y="Y+36" fill="#94a3b8" font-size="9" text-anchor="middle">sublabel</text>Info Card Pattern
<div class="card">
<div class="card-header">
<div class="card-dot COLOR"></div>
<h3>Title</h3>
</div>
<ul>
<li>• Item one</li>
<li>• Item two</li>
</ul>
</div>Template
Copy and customize the template at resources/template.html. Key customization points:
- Update the
<title>and header text - Modify SVG viewBox dimensions if needed (default:
1000 x 680) - Add/remove/reposition component boxes
- Draw connection arrows between components
- Update the three summary cards
- Update footer metadata
Output
Always produce a single self-contained .html file with:
- Embedded CSS (no external stylesheets except Google Fonts)
- Inline SVG (no external images)
- No JavaScript required (pure CSS animations)
The file should render correctly when opened directly in any modern browser. The export toolbar uses two CDN scripts (html2canvas and jsPDF) — no other JavaScript dependencies.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

