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.
77
71%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/plugins/azure-skills/skills/azure-resource-visualizer/SKILL.mdQuality
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 a strong skill description that clearly communicates its purpose, lists concrete actions, and provides an explicit WHEN clause with comprehensive trigger terms. The description is concise, uses third person voice, and occupies a distinct niche combining Azure resource analysis with Mermaid diagram generation. It follows best practices closely and would perform well in skill selection among many candidates.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Analyze Azure resource groups', 'generate detailed Mermaid architecture diagrams', 'showing the relationships between individual resources'. These are specific, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (analyze Azure resource groups and generate Mermaid architecture diagrams showing resource relationships) and 'when' (explicit WHEN clause with multiple trigger scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'create architecture diagram', 'visualize Azure resources', 'show resource relationships', 'generate Mermaid diagram', 'diagram my resources', 'map Azure infrastructure', 'resource topology'. These are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: Azure resource groups + Mermaid diagrams + architecture visualization. The combination of Azure-specific terminology and Mermaid output format makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill has good structural organization with appropriate progressive disclosure to reference files, but suffers significantly from verbosity and redundancy. Multiple sections repeat the same constraints and guidelines, and the skill explains many concepts Claude already understands (Mermaid syntax basics, markdown structure, what Azure resource types are). The workflow is reasonably clear but lacks validation checkpoints for the diagram output.
Suggestions
Cut the 'Core Responsibilities' section entirely (it's restated in the workflow), merge 'Quality Standards' and 'Constraints & Boundaries' into a single concise section, and remove the 'Output Format Specifications' section since Claude already knows Mermaid and markdown syntax.
Add a concrete validation step after diagram generation, such as checking that all discovered resource IDs appear in the Mermaid output and that the syntax parses correctly.
Replace the vague MCP tool usage patterns (e.g., `intent="list resource groups"`) with actual executable tool call examples or specific CLI commands that can be copy-pasted.
Remove the 'Success Criteria' section which largely duplicates the constraints, and eliminate motivational closing statements that consume tokens without adding actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose with significant redundancy. It explains concepts Claude already knows (what Mermaid syntax is, what markdown headers to use, basic Azure CLI commands), repeats the same points across multiple sections (e.g., 'don't skip resources' appears in both quality standards and constraints), and includes motivational language ('Your goal is to provide clarity and insight') that wastes tokens. The 'Core Responsibilities' section restates what the workflow already covers. Success criteria largely duplicates the constraints section. | 1 / 3 |
Actionability | The skill provides some concrete guidance (specific az CLI commands, Mermaid syntax patterns, connection type conventions) but lacks fully executable code examples. The tool usage patterns use vague pseudo-parameters like `intent="list resource groups"` without showing actual MCP tool calls. The diagram construction guidance is descriptive rather than providing a complete executable example inline (it references an external file instead). | 2 / 3 |
Workflow Clarity | The four-step workflow is clearly sequenced and includes a user confirmation checkpoint at Step 1. However, there are no validation checkpoints for the critical diagram generation step—no 'validate Mermaid syntax' step, no feedback loop for handling malformed diagrams or incomplete resource discovery. The instruction to 'test syntax mentally' is not a real validation step. For a multi-step process involving file creation, this lacks proper verification. | 2 / 3 |
Progressive Disclosure | The skill appropriately references external files for detailed content: Azure Resource Graph queries in a reference file, an example diagram in assets, and a template in assets. These are one-level-deep, clearly signaled references. The main skill provides an overview with clear navigation to supporting materials. | 3 / 3 |
Total | 8 / 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.
742d20b
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.