Content
92%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-engineered operational skill: executable commands with concrete thresholds, a clearly sequenced seven-stage workflow with validation and destructive-change guards at every risky step, and a clean one-level-deep reference structure verified against the actual bundle. The only weakness is mild redundancy — the never-close rules and one gh command are each stated twice — which keeps conciseness just short of the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and entirely repo-specific — label semantics, house title conventions, and gate rules are all non-obvious knowledge, not concepts Claude already has — but a few spots could be trimmed: the never-close/no-git rule is stated both in the intro ("Never close an issue, never touch a pull request, never run git") and again in Hard limits, and the regression-pass gh command largely duplicates the Pass A command shape. This lands on the 4 anchor (efficient with minor trimmable instances), below 5 due to that repetition and occasional editorial asides. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact gh commands with flags and --jq filters ready to run, concrete thresholds (600-character truncation, 1000-result search cap, ~200-word comment limit), findings-to-actions decision tables for every stage, and an explicit allowed-command allowlist. Placeholders like <limit> and <sort> are parameters the skill itself defines in Run scope, so the commands are copy-paste ready, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The seven stages are explicitly sequenced with a stage table declaring each stage's question and writes, and validation checkpoints are present everywhere they matter for this batch/destructive operation: re-read an issue's current title and body immediately before editing, slice-truncation detection ("never report a truncated slice as covered"), the "Cannot tell — compute it now, then judge" recovery loop, and destructive-change guards ("remove only on a clear, statable criteria failure"). This matches the 5 anchor's feedback loops and checklists, exceeding the 4 anchor. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all three referenced files (references/good-student-issue.md, references/factory-candidate.md, references/body-formatting.md) exist with real content, are exactly one level deep, and are clearly signaled via the gate-policy table and the stage 6 pointer; policies are self-contained and removable by design. The 455-line body holds per-stage operational rules rather than bulk material that belongs in separate files, matching the 5 anchor's clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 19 / 20 Passed |