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 written orchestrator body with a clearly sequenced, well-gated pipeline and highly concrete operational instructions. Its main weaknesses are repeated warning text and references to three sub-skill files that are not present in the bundle.
Suggestions
Ship or fix the prepare/SKILL.md, scaffold/SKILL.md, and deploy/SKILL.md references — three MUST READ steps currently point to files missing from the bundle.
State the 'NEVER invoke azure-deploy' rule once (e.g., in the deploy-recovery note) and reference it from Steps 3/8 instead of repeating it three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational (tables for steps, when/when-not, and error handling) with no concept explanations Claude already knows, matching 'efficient'. Minor trimmable redundancy: the 'NEVER invoke {"skill": "azure-deploy"}' rule is stated three times (deploy-recovery note, Step 8, Workflow header note), and the Post-scaffold transition paragraph is wordy — this keeps it below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | Fully concrete instruction-level guidance: named session artifacts (prereq-output.json, prepare-plan.json, scaffold-manifest.json, deploy-result.json), exact skill invocations ('{"skill": "azure-app-onboard-prereq"}'), machine-checkable halt conditions ('overallHealth: "blocked" OR routeToSkill set'), the exact approval prompt text, and per-step required file reads — copy-paste-ready operational direction covering the common cases. | 5 / 5 |
Workflow Clarity | A 10-step sequenced pipeline with explicit validation checkpoints (Scaffold Gate before generating files, Deploy Gate before any deployment, self-review in Step 7, health-check in Step 9), explicit halt conditions, a checklist (deploy-checklist.md), and an error-handling table with a retry/skip/abort feedback loop — matching the level-5 anchor for destructive/batch operations. | 5 / 5 |
Progressive Disclosure | Good structure with clearly signaled, one-level-deep references that all exist in references/ (pipeline-rules.md, session-protocol.md, intent-gathering.md, approval-gates.md, handoff-protocol.md, mcp-tool-reference.md, iac-resources.md), matching the 'mostly clear, minor organization gaps' anchor. The gap: 'prepare/SKILL.md', 'scaffold/SKILL.md', and 'deploy/SKILL.md' are marked MUST READ in Steps 5/7/9 but are absent from the bundle, leaving broken navigation for three core steps. | 4 / 5 |
Total | 18 / 20 Passed |