Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. USE FOR: 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 DO NOT USE FOR: creating/modifying resources (use azure-deploy), security scanning (use azure-security), performance troubleshooting (use azure-diagnostics), code generation (use relevant service skill)
Install with Tessl CLI
npx tessl i github:microsoft/azure-skills --skill azure-resource-visualizer94
Quality
92%
Does it follow best practices?
Impact
98%
1.13xAverage score across 3 eval scenarios
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that excels across all dimensions. It provides specific capabilities, comprehensive trigger terms in a structured USE FOR format, and proactively prevents conflicts with a DO NOT USE FOR section that references related skills. The description is well-structured, uses third person voice correctly, and would enable Claude to accurately select this skill from a large skill library.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Analyze Azure resource groups', 'generate detailed Mermaid architecture diagrams', 'showing the relationships between individual resources'. Clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (analyze resource groups, generate Mermaid diagrams showing relationships) AND when (explicit USE FOR clause with multiple trigger scenarios). Also includes helpful DO NOT USE FOR guidance to prevent misuse. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'create architecture diagram', 'visualize Azure resources', 'diagram my resources', 'resource topology', 'map Azure infrastructure'. The USE FOR section provides comprehensive trigger terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche (Azure + Mermaid diagrams + architecture visualization). The DO NOT USE FOR section explicitly differentiates from related skills like azure-deploy, azure-security, and azure-diagnostics, minimizing conflict risk. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with excellent workflow clarity and progressive disclosure. The actionability is strong with concrete commands, syntax examples, and clear tool usage patterns. The main weakness is moderate verbosity - the skill could be tightened by consolidating the 'Always Do/Never Do' section with earlier constraints and removing some redundant explanations of goals.
Suggestions
Consolidate the 'Constraints & Boundaries' section with the 'Quality Standards' section to reduce redundancy - many items are restated
Remove or significantly trim the 'Core Responsibilities' section as these goals are implicit in the workflow steps that follow
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some unnecessary verbosity, particularly in the 'Core Responsibilities' section which restates obvious goals, and the extensive 'Always Do/Never Do' lists that partially duplicate earlier content. However, it avoids explaining basic Azure concepts Claude would know. | 2 / 3 |
Actionability | Provides concrete, executable guidance including specific Azure CLI commands, exact Mermaid syntax patterns, clear tool usage patterns with specific intent parameters, and references to template files. The workflow steps are specific and actionable. | 3 / 3 |
Workflow Clarity | Clear 4-step sequential workflow with explicit checkpoints (wait for user selection, validate resource group exists). Includes error handling section for edge cases and clear decision points throughout the process. | 3 / 3 |
Progressive Disclosure | Well-structured with clear references to external files (azure-resource-graph.md, example-diagram.md, template-architecture.md) that are one level deep and clearly signaled. Main content stays focused on workflow while detailed examples are appropriately externalized. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Table of Contents
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.