CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

77

Quality

71%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/plugins/azure-skills/skills/azure-resource-visualizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
microsoft/azure-skills
Reviewed

Table of Contents

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.