azure-diagrams

Generate Azure architecture diagrams from Bicep, Terraform, and ARM templates.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jonathan-vella/azure-agentic-infraops-workshop --skill azure-diagrams-jonathan-vella
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-diagrams
Source: https://github.com/jonathan-vella/azure-agentic-infraops-workshop/tree/main/.github/skills/azure-diagrams
Command: npx skills add https://github.com/jonathan-vella/azure-agentic-infraops-workshop --skill azure-diagrams-jonathan-vella

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires diagrams, matplotlib, Pillow, graphviz, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The Azure Diagrams Skill provides a turnkey solution to create professional Azure architecture diagrams from IaC and design prompts, reducing the time from concept to shareable visuals.

Core Features & Use Cases

  • Diagram generation from IaC: Convert Bicep, Terraform, and ARM templates into Azure diagrams with official icons.
  • Concept-to-diagram prompts: Produce diagrams from plain-language prompts for architecture reviews, proposals, and documentation.
  • Output quality & formats: Output high-DPI PNG/SVG diagrams suitable for CI, docs, and presentations.

Quick Start

Use the azure-diagrams skill to generate a sample diagram from a minimal IaC snippet, or a design prompt, to verify the end-to-end workflow.

Frequently Asked Questions about azure-diagrams

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

FAQPage Schema
How do I generate Azure architecture diagrams from Terraform or Bicep code?▼

You can generate Azure architecture diagrams from Terraform, Bicep, or ARM templates by passing the Infrastructure as Code snippets as input. The tool parses the IaC definitions and automatically maps the declared resources to official Azure icons using the Python diagrams library.

Can I create Azure diagrams from plain text design prompts without writing Infrastructure as Code?▼

Yes, you can produce Azure diagrams directly from plain-language design prompts. By describing your intended architecture in natural language, the tool generates matching visual diagrams suitable for architecture reviews, solution proposals, and project documentation.

What is the best way to automate Azure diagram generation for CI pipelines and documentation?▼

The best way to automate Azure diagram generation for CI pipelines is to output high-DPI PNG or SVG files. These high-resolution formats are explicitly supported, ensuring the generated architecture diagrams are presentation-ready and can be embedded directly into automated documentation workflows.

Does the Python diagrams library work with ARM templates and official Azure icons?▼

Yes, the Python diagrams library works with ARM templates and renders them using official Azure icons. It processes ARM template inputs alongside Bicep and Terraform, applying the correct Azure service nodes to produce standardized architecture visuals.

Do I need to install Graphviz and Python dependencies to generate Azure diagrams?▼

Yes, you need to install Graphviz and Python dependencies including the diagrams library, matplotlib, and Pillow. These underlying packages handle the visual rendering, image processing, and graph layout required to output the final Azure architecture diagrams.

Why does my Azure diagram generation fail when rendering complex architecture graphs?▼

Azure diagram generation can fail during complex graph rendering if the Graphviz system binaries are not installed or properly configured on your machine. Ensure both the Graphviz executable and the Python diagrams package are correctly installed to resolve layout and rendering errors.