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. USE FOR: 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 DO NOT USE FOR: creating/modifying resources (use azure-deploy), security scanning (use azure-security), performance troubleshooting (use azure-diagnostics), code generation (use relevant service skill)

Install with Tessl CLI

npx tessl i github:microsoft/github-copilot-for-azure --skill azure-resource-visualizer
What are skills?

94

1.13x

Does it follow best practices?

Evaluation98%

1.13x

Agent success when using this skill

Validation for skill structure

SKILL.md
Review
Evals

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 an excellent skill description that excels across all dimensions. It provides specific capabilities, comprehensive trigger terms in a structured USE FOR format, and explicitly distinguishes itself from related Azure skills. The DO NOT USE FOR section is a particularly strong addition that helps Claude avoid selecting this skill incorrectly.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Analyze Azure resource groups', 'generate detailed Mermaid architecture diagrams', 'showing the relationships between individual resources'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both what (analyze resource groups, generate Mermaid diagrams showing relationships) AND when (explicit USE FOR clause with multiple trigger scenarios). Also includes helpful DO NOT USE FOR guidance to prevent misuse.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'create architecture diagram', 'visualize Azure resources', 'diagram my resources', 'resource topology', 'map Azure infrastructure'. The USE FOR section provides comprehensive trigger terms.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche (Azure + Mermaid diagrams + architecture visualization). The DO NOT USE FOR section explicitly differentiates from related skills like azure-deploy, azure-security, and azure-diagnostics, minimizing conflict risk.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a well-structured skill with strong actionability and clear workflow progression. The main weakness is moderate verbosity - the 'Always Do/Never Do' checklists and 'Success Criteria' section repeat information already covered in the workflow. The progressive disclosure is excellent with appropriate external references for examples and templates.

Suggestions

Consolidate the 'Constraints & Boundaries' and 'Success Criteria' sections - they largely duplicate the workflow requirements and add ~40 lines without new information

Remove the 'Core Responsibilities' section (lines 7-11) as these are restated more concretely in the workflow steps

DimensionReasoningScore

Conciseness

The skill contains some unnecessary verbosity, particularly in the 'Core Responsibilities' section which restates obvious goals, and the extensive 'Always Do/Never Do' lists that partially duplicate earlier content. However, it avoids explaining basic Azure concepts Claude would know.

2 / 3

Actionability

Provides concrete, executable guidance including specific Azure CLI commands, exact Mermaid syntax patterns, clear file naming conventions, and specific tool usage patterns with intent parameters. The workflow steps are specific and actionable.

3 / 3

Workflow Clarity

Clear 4-step sequential workflow with explicit checkpoints (wait for user selection, validate resource group exists). Includes error handling section for edge cases and explicit validation steps like 'verify resource group name' and permission checking.

3 / 3

Progressive Disclosure

Well-structured with clear references to external files: example-diagram.md for samples, template-architecture.md for templates, and azure-resource-graph.md for advanced queries. References are one level deep and clearly signaled with descriptive links.

3 / 3

Total

11

/

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.

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.