azure-resource-visualizer

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.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers a clear, actionable, well-referenced workflow with concrete commands and syntax. Its main weakness is verbosity from redundant checklist and format-specification sections that repeat the workflow.

Suggestions

Consolidate the 'Quality Standards', 'Always Do/Never Do', and 'Success Criteria' sections into a single concise checklist — they largely restate the workflow steps and inflate the body.

Move the 'Output Format Specifications' (Mermaid/Markdown syntax detail) into a reference file, keeping only the essential syntax snippets inline in Step 3.

Add an explicit validate-then-fix loop for Mermaid syntax (e.g., 'if the diagram fails to render, simplify node labels and re-check') to lift workflow clarity above 4.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of concept explanations Claude already knows, but the 'Quality Standards', 'Always Do/Never Do', 'Success Criteria', and 'Output Format Specifications' sections substantially duplicate the workflow steps and could be tightened.	3 / 5
Actionability	Provides concrete executable guidance — az CLI commands ('az resource list --resource-group <name> --output json'), specific MCP intent patterns, and exact Mermaid syntax — with only minor gaps (no full inline diagram example, though one is referenced).	4 / 5
Workflow Clarity	A clearly sequenced four-step workflow with most checkpoints present ('Wait for user response before proceeding', 'validate it exists', 'test syntax mentally before output'); minor validation gaps keep it just below the top anchor.	4 / 5
Progressive Disclosure	Three real bundle files (references/azure-resource-graph.md, assets/example-diagram.md, assets/template-architecture.md) are each clearly signaled and one level deep, but the body retains inline material (success criteria, format specs) that could be further split out.	4 / 5
	Total	15 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-constructed description that concretely states what the skill does and provides an extensive, natural set of trigger phrases. It is clearly distinct from neighboring skills.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — 'Analyze Azure resource groups', 'generate detailed Mermaid architecture diagrams', 'showing the relationships between individual resources' — with only minor coverage gaps, fitting the anchor above the 1-2-action midpoint.	4 / 5
Completeness	Explicitly answers both what ('Analyze Azure resource groups and generate detailed Mermaid architecture diagrams...') and when ('WHEN: create architecture diagram, visualize Azure resources...') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases including synonyms users would actually say — 'create architecture diagram', 'visualize Azure resources', 'diagram my resources', 'map Azure infrastructure', 'resource topology' — matching the full-coverage anchor.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Azure resource-group visualization via Mermaid) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: microsoft/azure-skills
Path: .github/plugins/azure-skills/skills/azure-resource-visualizer/SKILL.md
Commit: 16dc8c5

Reviewed: about 12 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.