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 ./plugin/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.
| 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 and appropriate use of progressive disclosure with external references. However, it is significantly over-verbose, repeating concepts across multiple sections (Core Responsibilities, Operating Guidelines, Constraints, Success Criteria all overlap). Actionability is moderate—while some concrete commands and syntax patterns are provided, the core tool usage relies on vague intent descriptions rather than specific executable examples, and the actual diagram example is entirely deferred to a reference file.
Suggestions
Cut 'Core Responsibilities' and 'Success Criteria' sections entirely—they restate what the workflow already covers and add ~40 lines of redundant content.
Merge 'Operating Guidelines' constraints into the relevant workflow steps rather than having a separate section that repeats the same guidance.
Add a concrete inline Mermaid diagram snippet (5-10 lines) showing the exact syntax patterns expected, rather than deferring entirely to example-diagram.md.
Add an explicit validation step after diagram generation, such as checking for common Mermaid syntax errors (unclosed brackets, invalid characters in node IDs) rather than 'test syntax mentally.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with significant redundancy. The 'Core Responsibilities' section restates what the workflow already covers. 'Operating Guidelines', 'Constraints & Boundaries', and 'Success Criteria' sections heavily overlap. Phrases like 'Your mission is to examine Azure resource groups' and the motivational closing sentence are unnecessary padding. Claude already knows how to structure markdown, use subgraphs, and handle edge cases like permission errors. | 1 / 3 |
Actionability | Provides some concrete guidance like specific az CLI commands and Mermaid syntax patterns, but much of the content is descriptive rather than executable. The tool usage patterns use vague pseudo-parameters like `intent="list resource groups"` without specifying actual tool names or APIs. No complete executable code block or copy-paste-ready example is provided inline—the actual example diagram is deferred to a reference file. | 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 fixing invalid diagrams, and 'test syntax mentally before output' is not a real validation step. For a multi-step process that generates complex Mermaid syntax, this is a significant gap. | 2 / 3 |
Progressive Disclosure | Good use of progressive disclosure with references to external files: azure-resource-graph.md for advanced queries, example-diagram.md for a complete sample, and template-architecture.md for the output template. References are one level deep and clearly signaled with descriptive link text. The main file serves as an overview with appropriate detail level. | 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.
a46a937
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.