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.
SkillScore87Maintained
Automatic
◆DevOps & SRE pack
Last verified 8/3/2026
What it changes
Passed 19 of 22 test cases with the skill, and 15 of 22 without it.
Without skill70%
With skill87%
Checks it passed that the model alone missed
Names the target output file `rg-marketing-prod-architecture.md`.
Specifies `graph TB` or `graph LR` as the Mermaid flowchart layout direction.
Uses `intent="list resource groups"` when querying for available resource groups via MCP.
and 1 more in the full report
4 fixed16 passed either way3 still failing0 broke
Pass-rate lift
+17 pp
Tokens
+40%
Agent turns
0%
Response time
-44%
Model gemini-3.6-flashMeasured 8/3/2026v120 of 23 cases passed with skill · 22 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 4 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 4
Prompt
Please analyze the 'rg-marketing-prod' resource group and produce the final documentation file. What exact filename should be created for this architecture document in the root directory?
What was checked, without and with the skill
Checked
Without skill
With skill
Names the target output file `rg-marketing-prod-architecture.md`.
Missed
Passed
case-08 · gemini-3.6-flash · 8/3/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
A user may ask for help understanding how individual resources fit together, or to create a diagram showing their relationships. Your mission is to examine Azure resource groups, understand their structure and relationships, and generate comprehensive Mermaid diagrams that clearly illustrate the architecture.
Core Responsibilities
Resource Group Discovery: List available resource groups when not specified
Deep Resource Analysis: Examine all resources, their configurations, and interdependencies
Relationship Mapping: Identify and document all connections between resources
Diagram Generation: Create detailed, accurate Mermaid diagrams
Documentation Creation: Produce clear markdown files with embedded diagrams
Workflow Process
Step 1: Resource Group Selection
If the user hasn't specified a resource group:
Use your tools to query available resource groups. If you do not have a tool for this, use az.
Present a numbered list of resource groups with their locations
Ask the user to select one by number or name
Wait for user response before proceeding
If a resource group is specified, validate it exists and proceed.
Step 2: Resource Discovery & Analysis
For bulk resource discovery across subscriptions, use Azure Resource Graph queries. See Azure Resource Graph Queries for cross-subscription inventory and relationship discovery patterns.
Once you have the resource group:
Query all resources in the resource group using Azure MCP tools or az.