Content
81%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.
This is an exceptionally actionable process skill: exact commands, verbatim ledger formats, validation gates on every step, and explicit feedback loops for both task execution and the final fix pass. Its only real cost is token weight — the dot graph duplicates the prose workflow and several principles are restated multiple times across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive with almost no explanation of concepts Claude already knows, but the ~38-line dot digraph duplicates the prose Process/Task Loop sections, and key points repeat across sections ("a test you watched fail and then pass" reappears in the Process, the Task Loop, the completion contract, and the rationalizations table), so it is mostly efficient but could be tightened — anchor 3, not 2 because nearly every line is non-obvious guidance rather than padding, and not 4 because the graph/prose duplication is genuine token overhead. | 3 / 5 |
Actionability | Fully executable guidance throughout: exact script invocations ("scripts/task-start PLAN_FILE N", "scripts/task-done PLAN_FILE N BASE -- <test command>", "review-package PLAN_FILE MERGE_BASE HEAD" with "MERGE_BASE = the commit the branch started from, e.g. git merge-base main HEAD") and verbatim ledger line formats ("Task <N>: complete (commits <base7>..<head7>, tests: <command> → <result>)") are copy-paste ready and cover the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | A clearly sequenced multi-step process (Setup → per-task loop → final review → fix pass → finish) with explicit validation checkpoints and feedback loops: every step's "Expected:" line is compared against real output with three defined outcomes, "A failing run records nothing; the task is not complete", a four-item completion contract with evidence, and a fix pass where "a suite that is not green after the pass means the pass is not over" — anchor 5. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clearly signaled one-level-deep references: this skill's scripts/task-start and scripts/task-done exist in the bundle and match their documented usage, and sibling-skill paths ("../subagent-driven-development/scripts/sdd-workspace", "../subagent-driven-development/scripts/review-package", "../requesting-code-review/code-reviewer.md") are each named with what they provide. The ~38-line dot graph and the 14-row rationalizations table are inline content that could live in reference files to keep the core loop lean, leaving minor organization gaps — anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |