Content
73%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 process skill with excellent workflow structure: staged sequence, explicit readiness gates, failure-driven feedback loops, and clean one-level-deep reference files. The main gaps are abstract, template-less guidance in the body (specifics all live one hop away) and a References section whose cross-skill links are dead in this environment.
Suggestions
Inline a compact fill-in template or one mini contract example in stage 2 so the four-field contract is immediately usable without opening references/task-contracts.md.
Fix or remove the four cross-skill references (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) that do not resolve, or note explicitly that they apply only when those sibling skills are installed.
State the compact-path rule once (it currently appears in Role, stage 2, and Output) and drop the duplicated link list in the References section in favor of the inline, context-anchored pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence — no concept explanations, no padding — and defers all detail to reference files. It falls short of anchor 5 because the "quick answer stays compact / need not load this specialist" message is repeated in three places (Role, stage 2, Output) and several doubly-qualified sentences could be trimmed without loss. | 4 / 5 |
Actionability | Concrete elements exist — the four contract fields (Outcome, Scope and constraints, Verification, Completion condition), the depth-selection table, and the five-bullet checkpoint/handoff list — but most execution guidance is abstract direction ("Choose evidence that observes the claimed outcome", "Update the authoritative record") with the working specifics a reference-hop away. This matches anchor 3 (some concrete guidance but incomplete, key details missing) rather than anchor 4's mostly-executable guidance. | 3 / 5 |
Workflow Clarity | Five clearly sequenced stages, each closed by an explicit "**Ready when:**" validation checkpoint, plus a genuine error-recovery feedback loop ("When a check fails, use its evidence to diagnose and correct the unit; when attempts repeat the same failure, revisit the premise"), pause conditions for missing authorization, and a resume/reconcile stage with a final output checklist. This matches anchor 5 (explicit validation steps, feedback loops, checklists) and exceeds anchor 4, whose checkpoints are only "mostly present". | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: SKILL.md is a ~110-line overview and all four in-scope references (task-contracts, decomposition, verification, worked-examples) exist, are one level deep, and are each signalled inline with an explicit "read when" condition plus a purpose line in the References section. It misses anchor 5 because the References section duplicates the inline links and four of its eight entries point outside the bundle (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) and do not resolve in this environment — half the reference list is unresolvable. | 4 / 5 |
Total | 16 / 20 Passed |