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 exemplary process skill: fully executable commands, an explicit validation contract at every step, and honest handling of failure modes and judgment calls. The only real costs are token weight — some repetition and two bulky inline artifacts — not clarity or actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token is skill-specific policy (ledger mechanics, rulings, completion contract, fix-pass rules) with no explanation of concepts Claude already knows; the 'Common Rationalizations' table and ruling-format repetition are mostly load-bearing. Minor trimming is possible — 'by its absolute path, from the working tree you're executing in' is repeated three times, and the ruling format is spelled out in three places — which keeps it below a 5 but well above the padded level of a 3. | 4 / 5 |
Actionability | Commands are copy-paste ready with exact argument shapes ('scripts/task-start PLAN_FILE N', 'scripts/task-done PLAN_FILE N BASE -- <test command>', 'sdd-workspace PLAN_FILE') and both local scripts exist and match their documented usage. Ledger line formats are given verbatim ('Task <N>: complete (commits <base7>..<head7>, tests: <command> → <result>)'), covering the common cases completely. | 5 / 5 |
Workflow Clarity | The full flow is sequenced twice — prose (Setup → Task Loop with four numbered steps → Final Review → Finish) and a dot graph — with explicit validation checkpoints at every risky point: 'Expected:' line comparison with three defined outcomes, a four-item completion contract, task-done recording only on a passing run, and a TDD fix pass with a green-suite gate. Error-recovery feedback loops (systematic-debugging for code wrong, ruling-and-ledger for plan wrong) are explicit, matching the top anchor. | 5 / 5 |
Progressive Disclosure | Structure is good: the process body belongs inline, and every reference — two local scripts plus cross-skill paths like '../subagent-driven-development/scripts/sdd-workspace' and '../requesting-code-review/code-reviewer.md' — is clearly signaled with its purpose and one level deep. Not a 5 because the ~40-line dot graph and the 16-line rationalizations table are bulky inline content that could live in reference files, and cross-skill paths depend on bundle layout outside this skill. | 4 / 5 |
Total | 18 / 20 Passed |