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-organized, highly actionable reference skill with executable commands, a clear workflow, error-recovery guidance, and clean one-level progressive disclosure. The only weakness is redundancy between the body's When-to-Use list and the frontmatter description.
Suggestions
Trim the 9-item "When to Use This Skill" bullet list to the few cases not already covered by the description (e.g. keep the App Service/Web Apps ARG-routing note) to reduce token overlap with the frontmatter.
Collapse the opening paragraph into the Quick Reference or Workflow section so the body starts with actionable content rather than restating the description.
Add a one-line "verify scope" checkpoint in Step 3 (e.g. confirm `--subscriptions`/`--first` is set before running) to make the execute-and-format step's validation explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with dense tables, but the 9-item "When to Use This Skill" list and the opening paragraph substantially duplicate the description's USE FOR content and could be trimmed. It is not a wall of concept-explanation, but it could be tightened. | 2 / 3 |
Actionability | Copy-paste-ready throughout: `az graph query -q "<KQL>" -o table`, the extension_cli_generate YAML snippet, JMESPath shaping example, install command, and an error→cause→fix table with concrete remedies. | 3 / 3 |
Workflow Clarity | A clear three-step sequence (check dedicated tool → generate ARG query → execute and format) with an error-handling table providing fix-and-retry feedback loops; operations are explicitly read-only, so the destructive-validation cap does not apply. | 3 / 3 |
Progressive Disclosure | Body is a well-sectioned overview that signals a single real one-level-deep reference — [Azure Resource Graph Query Patterns](references/azure-resource-graph.md), which exists and holds the detailed KQL patterns — keeping navigation shallow. | 3 / 3 |
Total | 11 / 12 Passed |