Content
100%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 orchestration skill body: lean phase-by-phase guidance with concrete commands, thresholds and placeholders, explicit validation and feedback loops around the risky operations (eval runs, segment push, finalization), and a verified one-level-deep reference structure where every detail file is real and well-signaled. The body stays an overview while the reference files carry the executable detail, which is exactly the intended division.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~85-line body is dense throughout with zero explanation of concepts Claude already knows ("The data already exists in CDP: there is no workflow and no model.") and uses tables for scanability. The Quick Reference's repetition of a few facts is deliberate lookup structure rather than padding, so the lean/every-token-earns-its-place anchor fits better than 4's trimmable over-explanation. | 5 / 5 |
Actionability | Guidance is executable: copy-paste commands ("tdx auth status", "tdx ps desc \"<PS>\" -o agent_outputs/<project_slug>/schema.json"), exact template placeholders ({{parent_segment_id}}, {{engagement_dir}}), and exact thresholds ("≥ 9/10 Pass", "at least 3 on the customer's definitions", "at least 2 Compliance cases"). The single in-body ellipsis ("tdx sg list -r …") is completed verbatim in the referenced references/discovery.md, so there is no real gap; 4 would require missing key details, which the verified reference files close. | 5 / 5 |
Workflow Clarity | Five phases are sequenced in a summary table and expanded per phase, with an explicit feedback loop ("Score, record the round, propose fixes with the failure → fix table, apply on approval, rebuild, re-run — until ≥ 9/10 Pass"), approval gates ("show it; ask for permission to run"), and a hard finalization gate ("if any remain, say what is missing and do not finalize"). Batch and destructive operations are guarded ("segment prompts stop at validate + dry-run", push only on approval), so the destructive/batch validation cap does not apply and the content matches the anchor-5 validate-fix-retry pattern. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all five references/ files exist and are each signaled in the body with their purpose ("references/agent-setup.md (placeholders, build checks, agent files table)"), are one level deep, and are dense and self-contained (verified in discovery.md and eval-setup.md). External ../shared/* and project_templates/ paths are direct one-hop references the body says when to read, so nothing is buried through nesting; this fits anchor 5's clear-overview, well-signaled structure. | 5 / 5 |
Total | 20 / 20 Passed |