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 ./plugin/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.

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 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.'

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
microsoft/github-copilot-for-azure
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.