Content
77%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.
A well-structured deployment-orchestration skill: the 10-step workflow has genuine validation checkpoints and error-recovery routing, and all progressive-disclosure links resolve to real, purpose-labeled files. The main weakness is token efficiency — the prerequisite/validation warning is repeated across five separate blocks — and the body delegates all deploy commands to recipe files, leaving its own executable guidance thin.
Suggestions
Collapse the 'AUTHORITATIVE GUIDANCE', '⛔ STOP', Rules 1-2, and 'VALIDATION PROOF CHECK' blocks into one prerequisite-check section — the same validation requirement is currently stated five times, wasting context.
Include at least one representative deploy command per recipe type (e.g. `azd up --env <env>`) in the body so the execution step is actionable without first loading a recipe file.
Merge the trailing 'References' section into the existing steps/SDK tables — it re-lists troubleshooting.md and post-deployment.md links that already appear above.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The steps table, rules, and reference listings are lean, but the opening prerequisite block pads heavily with repetition — the same requirement is restated in the 'AUTHORITATIVE GUIDANCE' blockquote, the '⛔ STOP' check, Rules 1-2, Step 1, and the 'VALIDATION PROOF CHECK' note ('DO NOT ASSUME', 'DO NOT SKIP', 'Skipping steps causes deployment failures'). The warning content could be stated once, so this sits at 'mostly efficient with some unnecessary explanation' rather than a lower score since the operational content itself is tight. | 3 / 5 |
Actionability | Gives one concrete executable command ('run `azd provision --no-prompt`, then verify `AcrPull` role has propagated'), a precise steps table with file paths, a named MCP tool table with specific tool identifiers like `mcp_azure_mcp_azd` and `azure__role`, and an explicit URL-formatting rule. It falls short of fully executable because the core deploy execution is delegated to recipe READMEs rather than including even one representative deploy command inline. | 4 / 5 |
Workflow Clarity | A 10-step table clearly sequences the workflow with explicit validation checkpoints (plan status = `Validated` with populated Validation Proof, mandatory pre-deploy checklist, RBAC health check, verify success with endpoint accessibility, live role verification), plus a dedicated error-recovery step routing to each recipe's `errors.md`. This matches the anchor for clear sequence with explicit validation steps and feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The body is a clean overview: every referenced path (pre-deploy-checklist.md, global-rules.md, recipes/README.md, recipes/azd/post-deployment.md, recipes/azd/verify.md, live-role-verification.md, all five sdk/ files, troubleshooting.md) exists on disk, links are one level deep and clearly labeled with purpose, and detailed content is properly split out. The deep-link anchor `#container-apps--acr--pre-deploy-rbac-health-check` resolves to a real heading in the checklist. Navigation is easy and well-signaled. | 5 / 5 |
Total | 17 / 20 Passed |