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/github-copilot-for-azure --skill azure-resource-visualizer94
Does it follow best practices?
Evaluation — 98%
↑ 1.13xAgent success when using this skill
Validation for skill structure
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 explicitly distinguishes itself from related Azure skills. The DO NOT USE FOR section is a particularly strong addition that helps Claude avoid selecting this skill incorrectly.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Analyze Azure resource groups', 'generate detailed Mermaid architecture diagrams', 'showing the relationships between individual resources'. These are 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 strong actionability and clear workflow progression. The main weakness is moderate verbosity - the 'Always Do/Never Do' checklists and 'Success Criteria' section repeat information already covered in the workflow. The progressive disclosure is excellent with appropriate external references for examples and templates.
Suggestions
Consolidate the 'Constraints & Boundaries' and 'Success Criteria' sections - they largely duplicate the workflow requirements and add ~40 lines without new information
Remove the 'Core Responsibilities' section (lines 7-11) as these are restated more concretely in the workflow steps
| 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 file naming conventions, and specific tool usage patterns with intent parameters. 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 explicit validation steps like 'verify resource group name' and permission checking. | 3 / 3 |
Progressive Disclosure | Well-structured with clear references to external files: example-diagram.md for samples, template-architecture.md for templates, and azure-resource-graph.md for advanced queries. References are one level deep and clearly signaled with descriptive links. | 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.