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-structured, actionable skill body with a clear multi-step workflow and good use of bundle files for detail. Its main weakness is verbosity from overlapping checklist sections that restate the same requirements.
Suggestions
Consolidate the redundant Quality Standards, Always Do/Never Do, and Success Criteria sections into a single checklist to reduce token cost without losing guidance.
Replace 'test syntax mentally before output' with a concrete Mermaid validation step or a rendered-syntax self-check to turn the diagram-generation step into a real feedback loop.
Trim the repeated Operating Guidelines/Constraints prose where it rephrases points already covered in the workflow steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely actionable and avoids explaining basic concepts, but it restates the same guidance across overlapping sections (Quality Standards, Always Do/Never Do, Success Criteria, Constraints), adding padding that could be consolidated. | 2 / 3 |
Actionability | It provides concrete executable commands (e.g. "az resource list --resource-group <name> --output json", "az network vnet show"), specific MCP intent strings, and exact Mermaid syntax patterns (graph TB/LR, subgraph, -->, -.->, ==>) that are copy-paste ready. | 3 / 3 |
Workflow Clarity | Steps 1–4 are clearly sequenced with an explicit user-confirmation checkpoint ("Wait for user response before proceeding") and RG-existence validation, plus an Edge Cases & Error Handling section that gives recovery guidance for permission, empty-group, and 50+ resource scenarios. | 3 / 3 |
Progressive Disclosure | The body is an overview with well-signaled, one-level-deep references to real bundle files — references/azure-resource-graph.md, assets/example-diagram.md, and assets/template-architecture.md — each linked in context where relevant, with content appropriately split out. | 3 / 3 |
Total | 11 / 12 Passed |