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.
An exceptionally well-engineered orchestrator skill body: fully sequenced 8-step workflow with validation gates, feedback loops, and consent prompts, plus copy-paste-ready commands and exact routing logic. Remaining gaps are minor — some repeated prohibition/routing language, and a cross-linked reference web that puts a few files two hops from the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense, compressed instruction set with zero background-concept explanation — every line is procedural. It falls short of the lean anchor 5 only through repetition: the install/build/test prohibition block restates its command list twice, "do NOT proceed to architecture planning" appears in consecutive routing rows, and per-step "You MUST read X" markers duplicate the Step 3 reference table. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact shell commands ("New-Item -ItemType Directory -Path \".copilot-azure/sessions/{uuid}\" -Force", "git rev-parse HEAD", "az account show"), a concrete grep pattern ("aws-sdk|@aws-sdk|boto3|google-cloud|@google-cloud|firebase"), exact ask_user prompt text, a first-match-wins routing table with explicit conditions, and named schema fields to write. No section relies on vague direction. | 5 / 5 |
Workflow Clarity | The 8-step pipeline is explicitly sequenced with validation checkpoints ("Verify context.json exists on disk", the readiness gate, "Session MUST exist on disk before any scanning") and a remediation loop with re-eval mandate — a fix → statically verify → re-evaluate feedback loop of exactly the kind the anchor-5 example describes. Because destructive/batch operations here do have validation and consent gates, the guideline cap of 3 does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clean overview pointing to 11 reference files that all exist on disk, each signaled at the exact step where it is needed — close to the one-level-deep anchor 5. It stays at 4 because the bundle is a cross-linked web (readiness-gate.md itself links to five other references, session-protocol.md defers to subscription-resolution.md, zero-code-path.md to subagent-starter-scaffold.md), so some content sits two hops from the main file and four references (dependency-compatibility.md, session-schemas.ts, subagent-starter-scaffold.md, subscription-resolution.md) are not discoverable from SKILL.md directly. | 4 / 5 |
Total | 18 / 20 Passed |