skills.rest
memasanz
memasanzCOMMUNITY
Explore all skills by this author →
GitHub

azure-architecture-diagrams

Generates Azure architecture diagrams as .drawio files and PNG/SVG exports using Microsoft's official V23 icon bundle.

1|Updated May 29, 2026
Search Tags:#azure#icons#svg#well-architected#drawio#architecture diagram#png export
One-click install
npx skills add https://github.com/memasanz/agent-harness --skill azure-architecture-diagrams-memasanz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-architecture-diagrams
Source: https://github.com/memasanz/agent-harness/tree/main/.github/skills/azure-architecture-diagrams
Command: npx skills add https://github.com/memasanz/agent-harness --skill azure-architecture-diagrams-memasanz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? draw.io's built-in Azure stencil is a 2019-era file with rebranded service names (Cognitive Search, Form Recognizers, AI Studio) and no icons for post-2023 services like OneLake, Microsoft Fabric, or Azure AI Foundry, so diagrams built with it look stale and fail review. ## Core Features & Use Cases - Official icon staging: Vendored copies of Microsoft's Azure V23 and Fabric SVG bundles are staged into a per-user cache by idempotent bootstrap scripts, with a -Refresh option to download the current release. - Library and manifest generation: A build script produces a drag-droppable draw.io shape library plus a JSON manifest of base64 data-URI icons for programmatic .drawio authoring. - WAF conventions and export presets: Reference docs encode Well-Architected Framework diagram rules (containers, arrows, layers, naming currency) and per-target draw.io CLI export commands for slides, GitHub, Microsoft Learn, and print. - Use Case: The azure-architect persona producing specs/ARCHITECTURE.md invokes this skill to emit a paired architecture.drawio and HiDPI architecture.png with current service icons. ## Quick Start Ask the agent to create a polished Azure architecture diagram for your project using the official V23 icons and export it as a high-resolution PNG into specs/images/.

Frequently Asked Questions about azure-architecture-diagrams

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Azure architecture diagram in draw.io with current icons?▼

Run the bootstrap script to stage Microsoft's V23 and Fabric SVG bundles into a local cache, then run build-library.ps1 to generate a draw.io shape library. Open the library via File > Open Library from > Device and drag current icons onto the canvas.

Why are draw.io's built-in Azure shapes outdated?▼

The built-in mxgraph.azure stencil is a single file from around 2019 that was never refreshed. It uses old labels like Cognitive Search and Form Recognizers and lacks icons for OneLake, Microsoft Fabric, Teams, and Azure AI Foundry.

Why do icons disappear in headless draw.io PNG export?▼

draw.io splits style strings on semicolons, so a raw data URI containing ';base64' is parsed as two style entries and the CLI exporter silently drops the icon. URL-encode the semicolon as %3B, as the generated manifest already does.

What draw.io export settings give high-resolution PNGs for slides?▼

Use the -s scale flag: -s 2 for HiDPI slide decks and -s 3 for print quality, plus -b for border padding. The -z zoom flag only scales the Electron UI and has no effect on export quality.

Can I use this skill for AWS or GCP architecture diagrams?▼

No, it is scoped to Azure because draw.io's AWS (aws4.xml) and GCP (gcp2.xml) built-in stencils are already current. For Mermaid diagrams in markdown or non-Azure clouds, use those native stencils instead.

Are the vendored Microsoft Azure icons licensed for redistribution?▼

Microsoft permits icon use in architectural diagrams, training materials, and documentation but forbids selling or standalone redistribution. The icons/NOTICE.md file details the terms and advises commercial forks to download fresh copies from Microsoft.

Related Skills

Explore More Software Engineering Skills→
jongiojongio
6

azure-resource-visualizer

Analyze Azure resource groups to generate Mermaid architecture diagrams.

Community
Advanced
githubgithub
38.5k

drawio

Generate draw.io diagrams as .drawio files and export them to PNG, SVG, or PDF.

Official
Intermediate
aws-samplesaws-samples
12

aws-plan

Plan AWS architecture workflows from discovery through delivery.

Official
Advanced
OpenAEC-FoundationOpenAEC-Foundation
4

drawio-impl-network

Enforces Cisco19 vendor namespaces and zone containers in Draw.io network diagrams.

Official
Advanced