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, well-sequenced orchestration skill: lean prose with explicit per-stage validation gates, an error-recovery loop, and clean one-level-deep bundling of the four local reference files. The main gaps are directional rather than demonstrated guidance (no inline example artifact) and sibling-skill links that do not resolve in this bundle.
Suggestions
Fix or qualify the four sibling-skill references (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) — they do not resolve in this bundle, so mark them as cross-skill pointers available only when the full skill family is installed.
Include one compact filled example of a contract or checkpoint inline (a two-line illustration of the four fields) so the abstract directive "use explicit fields when they make a handoff clearer" has a concrete target without requiring a trip to worked-examples.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense prescriptive instruction with zero concept explanations — no "what is planning" padding, no restating what Claude already knows; every sentence issues a directive ("Execute one bounded unit per owner at a time, check its result, and record the observed evidence before dependent work"). Matches the 'lean and efficient; assumes Claude's competence; every token earns its place' anchor; even level 4 would require over-explanation to trim, and none is evident. | 5 / 5 |
Actionability | Concrete scaffolds are provided: the four named contract fields ("Outcome", "Scope and constraints", "Verification", "Completion condition"), a three-row depth selection table with explicit criteria, per-step "Ready when" gates, and a five-item output checklist — comparable to 'mostly executable guidance with minor gaps' for an instruction-only skill. Not 5 because no filled example or template artifact appears in the body itself (demonstrations are delegated to worked-examples.md), and some directives stay directional ("Choose evidence that observes the claimed outcome") without showing what that choice looks like. | 4 / 5 |
Workflow Clarity | Five clearly sequenced stages, each closed by an explicit "Ready when:" validation checkpoint, plus a feedback loop — "When a check fails, use its evidence to diagnose and correct the unit; when attempts repeat the same failure, revisit the premise" — and pause conditions ("Pause the affected work when progress requires a new decision, capability, or authorization"). This matches the level-5 anchor (clear sequence, explicit validation steps, error-recovery loops, checklists); the skill involves no destructive or batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | Good structure against the actual bundle: all four referenced files (references/task-contracts.md, decomposition.md, verification.md, worked-examples.md) exist and are substantive, references are one level deep, appear inline at the decision point with a when-to-read condition, and are re-listed with purpose annotations under References. Not 5 because four of the eight referenced paths — ../behavioural-specs/SKILL.md, ../task-breakdown/SKILL.md, ../writing-plans/SKILL.md, ../using-beads/SKILL.md — do not resolve in this bundle, leaving navigation broken for half the reference list. | 4 / 5 |
Total | 18 / 20 Passed |