Content
78%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 a tight, well-structured stage contract: clear when-to-use framing, a sequenced procedure with a fail-fast validation gate and explicit failure-mode routing, and a References section whose four links all resolve to real files. The skill is instruction-only (no code, appropriately), and its only weaknesses are underspecified validation commands and a verbatim duplicate of the description.
Suggestions
In the Validation section, name the exact commands to run for package-level changes (e.g., the specific plugin validation and SDK proof commands the repository wrapper provides) instead of referencing them generically.
Replace the 'When to use' section's verbatim copy of the frontmatter description with any incremental routing detail, or drop the section to save tokens.
Make 'Run the smallest relevant local check for changed files' concrete by giving an example check per changed-file type.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, sectioned, and free of explanations of concepts Claude already knows; every section adds stage-specific contract detail. Not a 5 because the 'When to use' section restates the frontmatter description verbatim ("Use when status is confused, work resumed after drift, evidence lanes disagree, or a closeout claim may be stale"), a duplicated line that could be trimmed; not a 3 because there is no padded or unnecessary explanation beyond that one redundancy. | 4 / 5 |
Actionability | Concrete guidance throughout: an exact deliverable schema ("schema_version, stage, status, evidence_refs, blocked_by, and next_stage"), explicit classifications ("pass, fail, blocked, or not_checked"), and routing rules with failure modes. Not a 5 because the validation step says "run plugin validation and SDK proof commands from the repository wrapper" without naming the actual commands, leaving the executor to look them up; not a 3 because the guidance is otherwise executable and specific rather than pseudocode-level. | 4 / 5 |
Workflow Clarity | The Procedure is a clear 5-step sequence with an explicit validation gate: "stop at the first failed required gate, classify the blocker, and do not proceed to downstream stages until the failure is resolved or explicitly waived," plus recovery routing ("a blocker with the smallest recovery step"). Not a 5 because "Run the smallest relevant local check" leaves the actual checkpoint command unspecified; not a 3 because fail-fast checkpoints and error-recovery routing are explicitly present, not implicit. | 4 / 5 |
Progressive Disclosure | A short, well-organized body (~55 lines) with a clearly labeled References section of four one-level-deep links — "Stage contract: [contract](./references/contract.yaml)", "Eval cases", "Task profile", "Source context" — all of which exist in ./references/ with no scripts/ or assets/ directories to disclose. Content is appropriately split and navigation is trivial, matching the anchor-5 pattern; there is no inlined bulk content that should have been moved out. | 5 / 5 |
Total | 17 / 20 Passed |