azure-resource-visualizer Skill for Claude: Diagram an Azure Resource Group

Makes Claude read an Azure resource group and draw its architecture as a Mermaid diagram in a markdown file.

Installs: 572.7K; on skills.sh
Stars: 1.6K; on GitHub
Files: 3; besides SKILL.md
Updated: Oct 2026; last repo commit

azure-resource-visualizer makes Claude inspect an Azure resource group and draw how the resources connect. It lists the resources, maps network links, data flows, identities and config references, then builds a Mermaid diagram. The result is saved as [resource-group-name]-architecture.md.

If you do not name a resource group, Claude lists them and waits for your choice. The file has a header, a summary, a resource inventory, the diagram, relationship notes and recommendations. The skill says to use placeholder names for secrets and never to modify or delete Azure resources.

Good for

Architects documenting an existing Azure setup
New team members trying to understand what runs where
Anyone who needs an architecture doc without drawing it by hand

Install azure-resource-visualizer

Claude Code

Copy this prompt.

Install the azure-resource-visualizer skill in Claude Code. Run this command:

/plugin install azure@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Azure CLI signed in.

Pick one route, not both. The plugin installs all the Azure skills and wires in the Azure and Foundry tool servers they call. The skills CLI route installs only the skills named in the command, and does not wire in the Azure or Foundry tool servers, so enable the Azure MCP server separately if you want the tools the skills call. Sign in with az login first.

From the project README. Source.

What's in the skill

When it loads

Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. WHEN: create architecture diagram, visualize Azure resources, show resource relationships, generate Mermaid diagram, analyze resource group, diagram my resources, architecture visualization, resource topology, map Azure infrastructure.

Sections in SKILL.md

Core Responsibilities
Workflow Process
Step 1: Resource Group Selection
Step 2: Resource Discovery & Analysis
Step 3: Diagram Construction
Step 4: File Creation
Operating Guidelines
Quality Standards
Tool Usage Patterns
Constraints & Boundaries
Edge Cases & Error Handling
Output Format Specifications
Mermaid Diagram Syntax
Markdown Structure
Success Criteria

Key facts

Author: Microsoft
License: MIT (stated in SKILL.md)
GitHub stars: 1,609 for the whole microsoft/azure-skills repo (Nov 2, 2026)
Last commit: Oct 30, 2026
What installs: SKILL.md plus 3 bundled files (guides and examples); no scripts in the file list
Needs: Azure MCP tools or the Azure CLI; read access to the resource group
Part of: The azure plugin in microsoft/azure-skills
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Works in: GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, OpenCode (plugin README)

What it includes

Lists resource groups and waits for your pick
Skipped if you name the group; Claude checks that it exists.
Read · Resource group selection
Reads each resource's type, SKU, region, network and identity settings
Uses Azure MCP tools or az commands, plus Resource Graph for bulk lookups across subscriptions.
Network · Discovery and analysis
Builds a grouped, labeled Mermaid graph
Groups by layer such as network, compute, data, security and monitoring, and labels every connection.
Diagram construction
Writes [resource-group-name]-architecture.md
Saved in the workspace root or in docs/ if it exists, using a bundled template.
Write · File creation

From the official docs

Permissions

Low risk

Claude reads every resource in a group and writes a file that lists your infrastructure. Keep that file out of public repos.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The output file lists your infrastructure
It records resource names, SKUs and network layout. Keep it out of public repos.
Secrets are meant to be placeholders
The SKILL.md says to use placeholder names, never secret values, in the diagram. Check the file anyway.

Technical details

Scopes	Reads configuration of every resource in the chosen group Writes one markdown file in your workspace Uses Azure MCP tools or az commands

Questions

What does azure-resource-visualizer do?

It reads the resources in an Azure resource group and writes a Mermaid architecture diagram with an inventory and notes, saved as a markdown file.

How do I install it?

Use the install box at the top of this page. In Claude Code the plugin command installs the Azure skills together with the Azure tools they call, so pick it unless you want this one skill only. Run az login before you start.

Can it change my Azure resources?

No. The SKILL.md lists "Modify or delete Azure resources" under Never Do and calls the analysis read-only.

Where does the diagram go?

In a file named [resource-group-name]-architecture.md, in your workspace root or in docs/ if that folder exists.

Is it safe?

It reads configuration and writes one file. skills.sh lists Gen Agent Trust Hub, Socket and Snyk as pass.

What if the group has 50+ resources?

The SKILL.md suggests splitting the result into several diagrams, for example one per layer.

Does it work in the Claude app, Codex or Cursor?

The Azure README lists GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI and OpenCode as hosts for the plugin. It does not list the Claude desktop or web app.

Information

updated Nov 2, 2026

Repository: microsoft/azure-skills
Folder: skills/azure-resource-visualizer

microsoft/azure-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

microsoft/azure-skills README · github.com
azure-resource-visualizer SKILL.md · github.com
azure-resource-visualizer on skills.sh · skills.sh