Content
63%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.
The body is exceptionally actionable and its phase/gate sequencing is rigorous, but it pays for that with severe verbosity and zero content split out into bundle files, and two copy-paste step-numbering defects blur the sequence. It reads as a generated composite that inlined six skills' worth of defensive rationale without compression.
Suggestions
Split per-phase detail into one-level-deep reference files (e.g. the Review Phase's JiT mutation machinery and the Push Phase's CI-await procedure are self-contained procedures that would live as references), keeping SKILL.md as the gate-and-sequence overview.
Strip dated incident annotations and repeated cross-phase warnings down to a single statement each — rules like the agent-handle redemption and no-`git-stash` guidance appear nearly verbatim in multiple phases.
Fix the malformed step numbering in the Implement Phase ("6. **6. **Hand off...") and Push Phase (step 7's text embedded in step 6's parenthetical and repeated as step 7), which make the intended sequence ambiguous at those points.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~585-line body is heavily padded with defensive digressions, dated incident annotations ("observed 2026-09-06, `plan-affected-surface-scout`"), and rules repeated across phases (handle-redemption rules appear in Plan step 2 and Review step 3; the no-`git stash` rules in both Implement and Review). It does not teach concepts Claude already knows, which keeps it above the lowest anchor, but the padding goes far beyond "some unnecessary explanation". | 2 / 5 |
Actionability | Fully executable throughout: exact commands (`git status --porcelain`, `git worktree add <scratch-dir> HEAD`), manifest-detection priority lists, exact CI exit-code semantics, verbatim prompt templates, and a concrete verdict-selection order leave no meaningful gaps. | 5 / 5 |
Workflow Clarity | Six phases in strict order with explicit gates, feedback loops (RED→GREEN→REFACTOR→CHECK), and a final verification checklist, but structural copy-paste defects muddy the sequence: Implement Phase's duplicated "6. **6. **Hand off" numbering and Push Phase step 6 inlining step 7's full text inside a parenthetical while step 7 repeats it. | 4 / 5 |
Progressive Disclosure | Headers, gates, and a verification section give the body real structure, but it is a self-contained monolith — no bundle files exist and ~100 KB of material that clearly belongs in separate files (per-phase detail, the JiT mutation machinery, the CI-await procedure) is entirely inlined. | 3 / 5 |
Total | 14 / 20 Passed |