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.

75

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable skill body with a clear multi-step workflow and good use of bundle files for detail. Its main weakness is verbosity from overlapping checklist sections that restate the same requirements.

Suggestions

Consolidate the redundant Quality Standards, Always Do/Never Do, and Success Criteria sections into a single checklist to reduce token cost without losing guidance.

Replace 'test syntax mentally before output' with a concrete Mermaid validation step or a rendered-syntax self-check to turn the diagram-generation step into a real feedback loop.

Trim the repeated Operating Guidelines/Constraints prose where it rephrases points already covered in the workflow steps.

DimensionReasoningScore

Conciseness

The body is largely actionable and avoids explaining basic concepts, but it restates the same guidance across overlapping sections (Quality Standards, Always Do/Never Do, Success Criteria, Constraints), adding padding that could be consolidated.

2 / 3

Actionability

It provides concrete executable commands (e.g. "az resource list --resource-group <name> --output json", "az network vnet show"), specific MCP intent strings, and exact Mermaid syntax patterns (graph TB/LR, subgraph, -->, -.->, ==>) that are copy-paste ready.

3 / 3

Workflow Clarity

Steps 1–4 are clearly sequenced with an explicit user-confirmation checkpoint ("Wait for user response before proceeding") and RG-existence validation, plus an Edge Cases & Error Handling section that gives recovery guidance for permission, empty-group, and 50+ resource scenarios.

3 / 3

Progressive Disclosure

The body is an overview with well-signaled, one-level-deep references to real bundle files — references/azure-resource-graph.md, assets/example-diagram.md, and assets/template-architecture.md — each linked in context where relevant, with content appropriately split out.

3 / 3

Total

11

/

12

Passed

Description

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.

A strong, specific description that clearly states the skill's purpose and gives an explicit, natural-language trigger list. It avoids vague language and uses the correct voice throughout.

DimensionReasoningScore

Specificity

"Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources" names the domain and multiple concrete actions (analyze, generate diagrams, show relationships), matching the level-3 anchor.

3 / 3

Completeness

It states what the skill does up front and provides an explicit WHEN trigger list, satisfying both the "what" and "when" requirements with explicit trigger guidance.

3 / 3

Trigger Term Quality

The WHEN clause lists natural phrases a user would say — "create architecture diagram", "visualize Azure resources", "diagram my resources", "map Azure infrastructure" — giving good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

The Azure + Mermaid architecture-diagram niche is specific with distinct triggers unlikely to collide with unrelated skills; voice is imperative/third person with no first/second-person penalty.

3 / 3

Total

12

/

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.

Validation16 / 16 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.