azure-resource-lookup
List, find, and show Azure resources across subscriptions or resource groups. Handles prompts like "list websites", "list virtual machines", "list my VMs", "show storage accounts", "find container apps", and "what resources do I have". USE FOR: resource inventory, find resources by tag, tag analysis, orphaned resource discovery (not for cost analysis), unattached disks, count resources by type, cross-subscription lookup, and Azure Resource Graph queries. DO NOT USE FOR: deploying/changing resources, cost optimization, or non-Azure clouds.
83
78%
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 ./.github/plugins/azure-skills/skills/azure-resource-lookup/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 an excellent skill description that covers all key dimensions thoroughly. It provides specific concrete actions, includes natural user trigger phrases as examples, explicitly defines both when to use and when not to use the skill, and clearly distinguishes itself from related Azure skills through boundary conditions. The DO NOT USE FOR clause is a particularly effective addition for reducing skill selection conflicts.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: list, find, show resources, resource inventory, find by tag, tag analysis, orphaned resource discovery, unattached disks, count resources by type, cross-subscription lookup, and Azure Resource Graph queries. | 3 / 3 |
Completeness | Clearly answers both 'what' (list, find, show Azure resources across subscriptions/resource groups) and 'when' (explicit USE FOR and DO NOT USE FOR clauses with specific trigger scenarios). The DO NOT USE FOR clause adds extra clarity for disambiguation. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural user phrases like 'list websites', 'list virtual machines', 'list my VMs', 'show storage accounts', 'find container apps', 'what resources do I have', plus technical terms like 'Azure Resource Graph queries' and 'cross-subscription lookup'. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear Azure resource listing/querying niche. The explicit DO NOT USE FOR clause (deploying/changing resources, cost optimization, non-Azure clouds) sharply delineates boundaries and reduces conflict risk with deployment or cost analysis skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
57%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-organized skill with good structure and progressive disclosure, featuring useful routing tables and clear tool references. Its main weaknesses are the lack of concrete, executable query examples inline (deferring to a reference file) and missing validation/feedback loops in the workflow. The content could be more concise by trimming the 'When to Use' section and some explanatory text.
Suggestions
Add 2-3 complete, executable ARG query examples inline for common scenarios (e.g., list all VMs, find unattached disks, tag audit) rather than deferring all patterns to the reference file.
Add a validation checkpoint after Step 3 — e.g., 'If results are empty, verify subscription scope and resource type spelling; retry with broader scope or corrected type filter.'
Trim the 'When to Use This Skill' bullet list — much of it overlaps with the description and can be reduced to 3-4 key use cases.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'When to Use This Skill' section is somewhat redundant with the frontmatter description and could be trimmed. The routing table is useful but verbose. The tip callout and some explanatory text could be tightened. Overall mostly efficient but has room for compression. | 2 / 3 |
Actionability | Provides concrete tool names, CLI commands, and a YAML snippet for MCP tool invocation, but the actual KQL query examples are deferred to a reference file rather than shown inline. The bash example is helpful but generic — no complete, copy-paste-ready query for a common scenario like listing all VMs or finding unattached disks. | 2 / 3 |
Workflow Clarity | The 3-step workflow is clearly sequenced and logical, with a good routing decision in Step 1. However, there are no explicit validation checkpoints — no step to verify the query returned expected results, no feedback loop for empty results or errors beyond the error table. The error handling table is useful but disconnected from the workflow steps. | 2 / 3 |
Progressive Disclosure | Content is well-structured with clear sections (Quick Reference, MCP Tools, Workflow, Error Handling, Constraints). References to external files like 'references/azure-resource-graph.md' are one level deep and clearly signaled. The routing table and quick reference provide good at-a-glance information. | 3 / 3 |
Total | 9 / 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.
- Repository
- microsoft/azure-skills
- Commit
9d594ab
- 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.