Content
96%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 exceptionally well-crafted orchestration contract: every phase has concrete commands, exact paths, explicit gates, and validation loops, all delivered with no wasted tokens. The only structural improvement available is offloading the spec template and reviewer checklist into a reference file to shorten the always-loaded overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~185-line body is dense imperative instruction with zero concept explanation, zero padding, and no re-teaching of things Claude already knows — e.g. "Never begin implementation on `main` or `master` without explicit user consent", "After two failed fixes, stop patching and re-derive the cause". Every token earns its place, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste git commands ("git worktree add \"$path\" -b \"$branch\" <base>", "git check-ignore -q \"$path\"", "git rev-parse --short"), an exact spec-document template with frontmatter fields and task syntax, a Report template, and an enumerated reviewer package (workspace path, base/head SHA, diff command, one-line-per-command verification summary). Per the rubric's scoring note, absence of code in an instruction-only skill is not penalized when guidance is this concrete. | 5 / 5 |
Workflow Clarity | The pipeline (Step 0 orient → grill → workspace → spec → implement → verify → review → finalize → finish) is explicitly sequenced with routing rules ("Every path passes through Workspace before Spec or Implement"), explicit validation checkpoints (fresh-evidence verification, PRE-EXISTING baseline marking, verify strictly before review), and a feedback loop for error recovery (fix criticals → re-verify → re-review, with an explicit impasse-report exit when the loop stops converging). Destructive actions are gated ("never auto-approve the destructive option", worktree removal scoped to `.worktrees/`). | 5 / 5 |
Progressive Disclosure | The skill is a single-file contract with no bundle files and no nested references, well-organized under clear phase headings — good structure with easy navigation. It falls short of the 5 anchor because the spec template and the reviewer checklist are inlined in SKILL.md where a one-level-deep reference file could keep the overview leaner, a minor organization gap rather than content that clearly belongs elsewhere. | 4 / 5 |
Total | 19 / 20 Passed |