Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a solid structure for Azure resource lookup with useful routing tables and clear MCP tool mappings. However, it falls short on actionability by not including concrete, executable ARG query examples for the most common use cases (listing web apps, finding orphaned resources), instead delegating to `extension_cli_generate`. The workflow would benefit from explicit validation steps and the referenced bundle file for query patterns is missing.
Suggestions
Add 2-3 complete, executable ARG query examples for the most common scenarios (e.g., listing web apps, finding unattached disks) rather than relying solely on extension_cli_generate to produce queries.
Add a validation checkpoint after Step 3 (e.g., 'If results are empty, verify subscription scope with mcp_azure_mcp_subscription_list and confirm resource type spelling').
Condense the 'When to Use This Skill' section to 3-4 key bullet points — the detailed trigger list duplicates the skill description metadata.
Provide the referenced `references/azure-resource-graph.md` bundle file with common KQL patterns, or inline the most critical patterns directly in the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content. The 'When to Use This Skill' section is overly verbose with 10+ bullet points that largely restate the description. The routing table is useful but could be more compact. The warning/tip callouts add value but the overall document could be tightened. | 2 / 3 |
Actionability | Provides concrete CLI commands and MCP tool invocations, but the core workflow relies on `extension_cli_generate` to produce the actual query rather than giving executable examples directly. The YAML block for MCP invocation is helpful, but the skill lacks complete copy-paste-ready ARG query examples for common scenarios (e.g., listing web apps, finding orphaned disks). | 2 / 3 |
Workflow Clarity | The 3-step workflow is clearly sequenced (check dedicated tool → generate ARG query → execute), but lacks validation checkpoints. There's no feedback loop for verifying query results, handling empty results beyond a table entry, or confirming the right subscription scope was used before proceeding. The error handling table is helpful but separate from the workflow. | 2 / 3 |
Progressive Disclosure | References `references/azure-resource-graph.md` for query patterns which is good progressive disclosure, but no bundle files are provided so the reference is unverifiable. The routing table and error handling are inline which is appropriate for their size, but the 'When to Use This Skill' section could be condensed since it largely duplicates the description metadata. | 2 / 3 |
Total | 8 / 12 Passed |