Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary lean skill body: terse sections, explicit qualifier and mutation-approval checkpoints, concrete error-routing, and a clean single-level handoff to the catalog reference. The only improvement space is inlining one or two concrete verification commands in the body rather than deferring all mechanics to the catalog.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~38 lines of lean tables and terse directives with zero padding and no explanation of concepts Claude already knows (e.g., "None required. Use advertised read-only Azure tools or CLI queries."). Every section earns its place. | 5 / 5 |
Actionability | The workflow gives concrete, executable directives ("Capture exact code, nested message, operation, and AKS resource", "Require every qualifier; codes are not substrings", "require explicit approval before every mutation") and the Error Handling table maps inputs to concrete responses. It falls short of anchor 5 only because the per-error verification mechanics (e.g., `az vm list-skus`, `az aks check-acr`) live entirely in the catalog reference rather than the body, leaving minor gaps in copy-paste-ready specifics. | 4 / 5 |
Workflow Clarity | The four-step workflow is a clear sequence with explicit validation checkpoints: the qualifier gate in step 2 ("Require every qualifier"), read-only verification in step 3, and the mutation approval gate in step 4 ("require explicit approval before every mutation"). The Error Handling table supplies recovery routing for non-matching inputs, fulfilling the error-recovery expectation of anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a lean overview and the bulk detail (the signature catalog) is correctly split into a single, clearly signaled, one-level-deep reference — "Use the [catalog](references/error-code-map.md)" — which exists as a real file with no further nesting. Navigation is trivial. | 5 / 5 |
Total | 19 / 20 Passed |