Content
88%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 tightly scoped orchestration skill: it delegates step detail to a workflow script while giving concrete commands, a hard prerequisite gate, explicit validation checkpoints, and safe hand-off rules for deployment. The only weaknesses are mild redundancy in the emphasis blocks and a recipes hub that pushes most reference content two levels deep.
Suggestions
State the azure-prepare → azure-validate → azure-deploy ordering once (e.g., in the STOP prerequisite block) and drop the repetition in Rule 1 and the closing block.
Add one-line links from the body to the top-level reference docs (region-availability.md, policy-validation.md, aspire-functions-secrets.md) or note that the recipes README indexes them, so they are discoverable without traversing the per-tool recipe folders.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence ('Run the workflow script and follow its instructions'), but the azure-prepare → azure-validate ordering is stated three times (workflow chain diagram, STOP block, Rule 1) and the 'AUTHORITATIVE GUIDANCE' / 'VALIDATION AUTHORITY' emphasis blocks restate the same MUST constraints, so a few tokens could be trimmed. Not a 5 because not every token earns its place; not a 3 because there is no over-explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Gives copy-paste-ready commands for both platforms ('pwsh references/scripts/workflow.ps1 -WorkspacePath <workspace-path>' and the bash equivalent) plus a concrete iteration protocol ('re-run with that value (-CompletedStep <value>) ... Repeat until it reports the azure-validate workflow is complete'), and all referenced files (workflow.ps1/.sh, recipes/README.md, role-verification.md, global-rules.md) exist in the bundle. Fully executable guidance covering the common flow. | 5 / 5 |
Workflow Clarity | Clear sequenced flow with an explicit prerequisite gate ('azure-prepare was invoked ... status Approved or later'), script-driven checkpoints recorded in '.azure/validate-status.json', an explicit pass rule ('All checks must pass—do not deploy with failures'), and an error-recovery feedback loop ('If any validation failed, fix the issues and re-run azure-validate'), plus a destructive-action 'ask_user' guard. Meets the anchor for explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | The body is a well-signaled overview with verified one-level links (workflow scripts, recipes/README.md, role-verification.md, global-rules.md) and the bundle is coherently organized by tool. Not a 5 because the bulk of validation detail sits two levels deep via the recipes hub (SKILL.md → recipes/README.md → bicep/README.md → region-availability.md etc.) and several top-level reference docs are not surfaced from the body itself. | 4 / 5 |
Total | 18 / 20 Passed |