drawio-skill
Agents365-ai/drawio-skillSkill that turns natural language, Terraform, SQL, OpenAPI and other sources into editable draw.io diagrams, with incremental sync, drift detection and CI tests.
Recommended
Broad access Depth 4/5
Azure Resource Visualizer (Azure Skills) skill
Microsoft skill that inspects an Azure resource group and writes a Mermaid architecture diagram showing how the resources connect.
Our verdict Recommended
Does one job clearly, produces output you can paste into docs, and tells the agent not to print secret values.
What the azure-resource-visualizer skill does
azure-resource-visualizer turns a resource group into a diagram. If you do not name a group, the agent lists the groups with locations as a numbered list and waits for your choice. It then queries every resource with Azure MCP tools or az, capturing names, types, SKUs, regions and key settings, and maps relationships: network links such as VNet peering, subnets, NSGs and private endpoints, data flow from apps to databases or functions to storage, managed identities, app settings that point at Key Vault, and parent-child dependencies. For bulk discovery across subscriptions it references an Azure Resource Graph query file. The output is a markdown document with an embedded Mermaid diagram. The skill instructs the agent to use placeholder names for secrets and connection strings, never real values, and the folder includes an architecture template and a worked example diagram under assets. The SKILL.md is about 8.5 KB; there are four files in total and no scripts.
Good for
- Documenting an existing Azure environment for onboarding or review
- Producing Mermaid diagrams of network and data-flow relationships
Not for
- Designing a new architecture from scratch
- Non-Azure diagram work (see drawio or Mermaid skills)
Depth 2/5
8.5 KB SKILL.md with two templates and one query reference; no scripts or evals.
Dependencies and costs
- Azure account or subscription
- Azure CLI signed in with az login
- Azure MCP Server (installed with the plugin; needs Node.js 18+ for npx)
- Reader access to the resource group
- Telemetry: The skill files contain no telemetry code. The Azure MCP Server that the plugin wires in has its own telemetry; the repo README says to disable it with AZURE_MCP_COLLECT_TELEMETRY=false.
Security review
Review before installingReads an Azure resource group and writes a Mermaid architecture diagram as a markdown file. It uses read-only az or MCP queries and instructs the agent to show placeholders instead of real secret values.
Worth knowing
- Relies on a CLI or package we could not reviewInspects a resource group with Azure MCP tools or az and Resource Graph queries..github/plugins/azure-skills/skills/azure-resource-visualizer/SKILL.md:41
- Installs packages or toolsTells you to run 'az extension add --name resource-graph'..github/plugins/azure-skills/skills/azure-resource-visualizer/references/azure-resource-graph.md:21
What we checked
The skill folder (4 files) on Oct 29, 2026. Not a full review: it relies on code outside the repository: Azure CLI (az) and the az extensions it installs on demand; not part of the files we have; Azure MCP Server, started by the plugin through npx; its configuration sits outside this skill folder.
NVIDIA SkillSpector static scan: 2 pattern hits (Privilege Escalation 1, Excessive Agency 1). The one hit is the word 'secrets' in an example diagram; the skill says to use placeholder names for secret values in diagrams.
A review, not a certification. Skills change after we check them — read the files before installing.
License
MIT (declared in the SKILL.md frontmatter); the repo is a mirror synced from microsoft/GitHub-Copilot-for-Azure and has no top-level LICENSE file in our copy. Commercial use allowed under MIT.
Can it run unattended?
Not really. It starts by asking the user to pick a resource group and is built for single interactive runs.
Alternatives
Mermaid Architect (design-doc-mermaid)
SpillwaveSolutions/design-doc-mermaidA Mermaid diagram and design-doc skill with a 23 KB router, 11 document templates, guides and scripts to validate and render diagrams with mermaid-cli.
With caveats
Check first Depth 3/5
Archify
tt-a1i/archifyA skill that turns a description or a codebase into a validated, interactive standalone HTML diagram or one-page explainer.
Recommended
Check first Depth 5/5
FAQ
What does azure-resource-visualizer do?
It examines an Azure resource group, works out how the resources relate (network, data flow, identity, configuration) and generates a Mermaid diagram in a markdown file.
Will the diagram expose my secrets?
The skill says to use only placeholder names for secret values such as keys and connection strings, so the generated document should not contain real ones. Review the output before sharing.
How do I install azure-resource-visualizer?
Install Microsoft's Azure plugin: /plugin install azure@claude-plugins-official in Claude Code, or add microsoft/azure-skills to the Codex marketplace.
azure-resource-visualizer vs a Mermaid or draw.io skill?
The visualizer discovers the live Azure topology for you. General diagram skills such as drawio-skill or design-doc-mermaid draw from descriptions or code, without querying Azure.
Sources: GitHub repository; install counts from skills.sh via Best Skills (CC BY 4.0). Review based on the published SKILL.md.