Generate architecture diagrams as fully editable SVG with native AWS, Azure, and GCP icons for cloud diagrams, or hand-drawn generic icons for everything else. Deterministic layout computes zone nesting and orthogonal routing instead of hand-placed coordinates. Triggers on: "architecture diagram", "infra diagram", "system diagram", "deployment diagram", "topology diagram", "draw architecture", "AWS diagram", "Azure diagram", "GCP diagram", "cloud infrastructure diagram", "VPC diagram", "draw my AWS setup". Use when a user wants a static architecture diagram they can still edit afterward in Figma, Illustrator, or Inkscape. NOT for architecture reviews, use architecture-reviewer.
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Generate architecture diagrams as fully editable SVG with native AWS, Azure, and GCP icons for cloud diagrams, or hand-drawn generic icons for everything else. Deterministic layout computes zone nesting and orthogonal routing instead of hand-placed coordinates. Triggers on: "architecture diagram", "infra diagram", "system diagram", "deployment diagram", "topology diagram", "draw architecture", "AWS diagram", "Azure diagram", "GCP diagram", "cloud infrastructure diagram", "VPC diagram", "draw my AWS setup". Use when a user wants a static architecture diagram they can still edit afterward in Figma, Illustrator, or Inkscape. NOT for architecture reviews, use architecture-reviewer.
Produces standalone, fully editable .svg files: real inlined vector icons (AWS/Azure/GCP official architecture icons, or a hand-drawn generic set for anything else), deterministic zone-aware layout, orthogonal connection routing, real <text> labels. Zero raster images, zero <use> clones — every icon is inlined per node so the output opens cleanly as an editable layer tree in Figma, Illustrator, Inkscape, or draw.io.
When to use this
Situation
Use this skill?
"Draw our AWS/Azure/GCP architecture"
Yes
"System topology diagram for docs"
Yes
"I need to edit this diagram afterward in Figma"
Yes — this is the differentiator vs. every raster-output alternative
Multi-cloud or hybrid (cloud + on-prem) diagram
Yes — mix provider: per node freely
Interactive, click-through, or animated diagram
No — use static-web-artifacts-builder
Hand-drawn / whiteboard-style sketch
No — use tldraw
Data chart, plot, or dashboard
No — use chart-clarity
Reviewing or critiquing an existing architecture
No — use architecture-reviewer
Single-frame concept illustration with no components/connections
No — use concept-to-image
Prerequisites
python3 with pyyaml installed (uv run --with pyyaml python3 scripts/render.py ... if not already available).
Cloud-provider icons need a one-time, per-machine network fetch. Icons are never bundled in this skill — AWS, Azure, and GCP's own terms permit using their icons to build diagrams but none grant redistribution rights, so nothing is vendored. The first time a diagram needs a given provider's icons, run:
This builds a local cache (default ~/.cache/armory/cloud-icons, override with --cache-dir or $XDG_CACHE_HOME) pinned to a specific jgraph/drawio commit, so output is reproducible. Subsequent renders reuse the cache — no network needed after the first fetch per provider. provider: generic needs no fetch at all; it uses the bundled hand-drawn icon set in references/icons-generic.md.
Workflow
Parse the user's request: components (with descriptions), containment hierarchy (zones — VPC/Region/Resource Group/Subnet), connections (with semantic types if specified), and cloud provider(s).
Resolve services to icons. For each cloud component, read references/services-aws.yaml, references/services-azure.yaml, or references/services-gcp.yaml (whichever matches its provider) — or references/icons-generic.md for non-cloud — and note the exact slug to use as that node's service field. If a service genuinely has no icon in that provider's set (documented per-provider in each table), either pick the closest sibling category or leave service unset — the renderer falls back to a labeled placeholder rather than a wrong icon.
Ensure the icon cache is warm for every provider used (see Prerequisites). Skip this for provider: generic.
Author the spec — a small YAML file per references/spec-format.md: title, direction (LR/TB), zones (with parent for nesting), nodes (id, label, service, zone, color), edges (from, to, label, type).
Read every line printed to stderr. error: lines mean the spec is invalid (fix and rerun). warning: lines mean the diagram rendered but something needs attention — a missing icon, an overflowing label, overlapping zones. Fix the spec's node/zone data, not the SVG output directly.
Verify before handing off — see Verification below. Do not skip this step; a diagram with unresolved warnings looks unprofessional even though the file is technically valid SVG.
Output the final .svg to the working directory or user-specified path. Mention the icon-cache prerequisite only if this was the first render for a given provider.
Spec fields at a glance
Full schema and worked examples: references/spec-format.md. Summary:
title:stringdirection:LR|TB# default LRprovider:aws|azure|gcp|generic# default provider for nodes that omit itzones:-id:stringlabel:stringparent:string|null# nesting — omit for a top-level zonenodes:-id:string# uniquelabel:stringsublabel:string# optional secondary lineservice:string# icon cache slug — see services-aws.yaml / services-azure.yaml / services-gcp.yamlprovider:string# overrides the top-level provider for this nodezone:string|null# zone id this node belongs tocolor:"#RRGGBB"# icon fill coloredges:-from:string# node idto:string# node idlabel:string# optionaltype:realtime|batch|event|control|default
Connection type semantics
type
color
style
use for
realtime
blue
solid
REST, gRPC, synchronous requests
batch
red
dashed
SFTP, file transfer, scheduled jobs
event
green
solid
pub-sub, webhooks, event-driven triggers
control
orange
solid
management plane, monitoring, config push
default
gray
solid
when semantics are unspecified or only one flow type exists
A legend renders automatically whenever more than one connection type is used in a diagram; it's omitted entirely when every edge is default.
Unsupported / partial coverage
Kubernetes and on-premises providers have no dedicated icon set yet — model them with provider: generic (server, container, database, queue, and 31 other hand-drawn glyphs in references/icons-generic.md, 35 total) until a future milestone adds native K8s/on-prem icon coverage.
GCP and Azure icon coverage is narrower than AWS's (297 and ~700 icons vs. 1037). references/services-aws.yaml, references/services-azure.yaml, and references/services-gcp.yaml each document that provider's specific gaps (e.g. GCP has no dedicated Vertex AI or Artifact Registry icon; Azure has no dedicated Pipelines/Boards/Artifacts icon) rather than silently substituting a misleading icon.
Interactive elements (click-through, animation, mode toggles) are out of scope — this skill produces one static SVG. Use static-web-artifacts-builder for that.
PNG/PDF export isn't built in. Pipe the SVG through a converter afterward if a raster format is needed: rsvg-convert diagram.svg -o diagram.png or cairosvg diagram.svg -o diagram.pdf.
Infer zone nesting from naming conventions (Region > VPC > Subnet, Resource Group > VNet > Subnet).
Default to default connection type and no legend when the user doesn't specify flow semantics.
Default to LR direction for request/data-flow diagrams, TB for hierarchical or layered ones.
Use provider: generic and the hand-drawn icon set when no cloud provider is specified or the architecture is vendor-neutral.
Ask for clarification only when the component list or topology is fundamentally unclear — never when a single icon is missing (fall back per Unsupported above).
Troubleshooting
Problem
Cause
Fix
error: could not fetch <provider> icons
No network on first use, or a transient GitHub/CDN timeout
Rerun fetch_icons.py for that provider — it retries individual file fetches automatically; a full retry from scratch is cheap since already-cached icons are skipped
warning: no icon for node 'x'
The service slug doesn't exist in that provider's cache, or the icon cache for that provider was never fetched
Check references/services-aws.yaml (or the -azure/-gcp equivalent) for the exact slug; run fetch_icons.py --provider aws (or azure/gcp) if the cache is cold
warning: zone overlap
Two zones' member nodes are interleaved in rank/order so their bounding boxes collide
Reorder the spec's nodes list so each zone's members are listed together, or check the zone assignments are correct
warning: label may overflow its node box
A node or edge label is too long for the fixed-width node box
Shorten the label, or move detail into sublabel
Diagram looks fine locally but breaks when reopened elsewhere
Should not happen — render.py never emits <image>, <use>, or external hrefs (enforced by check_editability, run automatically on every render)
If this happens anyway, file it as a bug — it means the invariant broke
Icons render as plain colored squares with an initial letter, no glyph
The node has no service set, or the slug wasn't found — this is the deliberate fallback, not a crash
Add the correct service slug from the provider's reference table
Verification
Before handing a diagram to the user, confirm:
render.py exited 0 (a nonzero exit means an editability violation slipped through — treat as a bug, not something to work around)
Every warning: line printed to stderr has been addressed or is a deliberate, explainable tradeoff (e.g. "no icon exists for this service, using a placeholder")
Zone containment matches the described architecture (open the SVG or render it to PNG and look — rsvg-convert diagram.svg -o /tmp/check.png)
Every node the user asked for is present and labeled
Connection types match the described data flows, and the legend appears only when more than one type is used
Output
Write the final SVG to the working directory (or the user-specified path) and report:
The output path
Any warnings that were left unresolved and why
Whether this was the first render for a given provider (mention the icon-cache fetch cost only once, not on every subsequent render)
Reference table
File
Contents
Read when
references/spec-format.md
Full YAML spec schema, field-by-field, with edge cases
Always, before authoring a spec
references/services-aws.yaml
AWS service name → icon slug + color, ~70 entries, documented gaps
Diagramming AWS components
references/services-azure.yaml
Azure service name → icon slug + color, ~45 entries, documented gaps
Diagramming Azure components
references/services-gcp.yaml
GCP service name → icon slug + color, ~35 entries, documented gaps
