All skills
microsoft avatar

/azure-resource-visualizer

@72b7dda official

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.

Use this Skill: https://skilld.dev/gh/microsoft/github-copilot-for-azure/azure-resource-visualizer

This session only. Nothing lands on disk.

assetsexample-diagram.md

≈445 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Example Architecture Diagram

This example shows a typical Azure resource group with resources organized into logical layers.

Sample Mermaid Diagram

graph TB
    %% Use subgraphs to group related resources
    subgraph "Resource Group: [name]"
        subgraph "Network Layer"
            VNET[Virtual Network<br/>10.0.0.0/16]
            SUBNET1[Subnet: web<br/>10.0.1.0/24]
            SUBNET2[Subnet: data<br/>10.0.2.0/24]
            NSG[Network Security Group]
        end
        
        subgraph "Compute Layer"
            APP[App Service<br/>Plan: P1v2]
            FUNC[Function App<br/>Runtime: .NET 10]
        end
        
        subgraph "Data Layer"
            SQL[Azure SQL Database<br/>DTU: S1]
            STORAGE[Storage Account<br/>Type: Standard LRS]
        end
        
        subgraph "Security & Identity"
            KV[Key Vault]
            MI[Managed Identity]
        end
    end
    
    %% Define relationships with descriptive labels
    APP -->|"HTTPS requests"| FUNC
    FUNC -->|"SQL connection"| SQL
    FUNC -->|"Blob/Queue access"| STORAGE
    APP -->|"Uses identity"| MI
    MI -->|"Access secrets"| KV
    VNET --> SUBNET1
    VNET --> SUBNET2
    SUBNET1 --> APP
    SUBNET2 --> SQL
    NSG -->|"Rules applied to"| SUBNET1

Diagram Features

This example demonstrates:

  • Layered organization: Resources grouped by function (Network, Compute, Data, Security)
  • Detailed node labels: Each resource includes configuration details (SKUs, tiers, settings)
  • Descriptive connections: Relationships are labeled to show data flow and dependencies
  • Subgraphs: Logical grouping makes the architecture easy to understand
  • Resource variety: Shows common Azure services and their interconnections

Source: SKILL.md on GitHub

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides architecture visualization for Azure environments and includes strong safety guidelines, such as instructions to use placeholders for secrets. It includes a potential consideration regarding indirect prompt injection, which is a common characteristic of skills that process external metadata. See the detailed analysis for more information.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    4 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 72b7dda. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 5 months ago
metadata
{
  "author": "Microsoft",
  "version": "0.0.0-placeholder"
}
  • Infrastructure
  • azure
  • architecture
  • mermaid
  • resource-groups
  • visualization
  • diagrams
  • azure-cli

README badge

README badge for microsoft/github-copilot-for-azure/azure-resource-visualizer

Analyzes Azure resource groups and generates Mermaid architecture diagrams showing resource types, configurations, and relationships. Useful for documenting existing infrastructure, understanding data flows between services, and identifying dependencies across compute, networking, storage, and identity layers.

Generated from the current SKILL.md.

Does this skill work with all Azure resource types?
The skill analyzes all resources in a specified resource group using Azure MCP tools or CLI, but the quality of relationship mapping depends on whether those resources expose their dependencies through Azure APIs. Well-integrated services like App Service, Functions, Storage, and Databases will be fully mapped; custom or third-party resources may have limited relationship detection.
Can this skill analyze resources across multiple resource groups or subscriptions?
The skill focuses on a single resource group at a time, but it can use Azure Resource Graph queries for cross-subscription inventory discovery. Cross-resource-group dependencies are noted in the diagram as external references.
Will secret values appear in the generated diagrams?
No. The skill explicitly replaces all secret values—keys, connection strings, Key Vault secrets—with meaningful placeholder names in the diagrams and documentation.
What format does the skill output?
A markdown file containing a resource inventory table, detailed Mermaid architecture diagram with logical grouping, relationship explanations, and notes. The diagram uses top-to-bottom or left-to-right layout depending on architecture width.
Does this skill modify or delete Azure resources?
No. The skill performs read-only analysis only and will never modify or delete resources.

Generated from the current SKILL.md. These answers refresh after source changes.