Content
100%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.
A lean, highly actionable procedure: concrete executable commands at every step, a clear six-phase sequence with an explicit final verification check and done-when checklist guarding a batch-edit workflow, and well-organized single-file structure with no content that should be split out. It assumes Claude's competence throughout and adds only repo-specific knowledge Claude could not infer on its own.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, instruction-only prose: every sentence directs an action ("Run every command from the repo root. Shell variables do not carry over between commands: run each code block as one command.") and nothing explains concepts Claude already knows. The two-sentence intro earns its place by stating when and why to run the skill; there is no padding to trim, matching the anchor-5 'every token earns its place' case rather than anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | The guidance is fully executable: step 1 gives copy-paste-ready git/gh pipelines (the grep -E over diff lines, the sed extraction of '@@' hunk headers), step 2 gives a complete git grep invocation with a worked TERMS example, and step 6 gives the final verification grep. Placeholders (<the base from open-pr Step 2, else main>, <doc files>) are clearly labeled inputs the agent fills from prior output, which the rubric treats as justified flexibility rather than pseudocode; the common cases are covered concretely. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps (find changes → find stale docs → update in place → prohibited edits → commit/report → done-when) with an explicit validation checkpoint: the final grep in section 6 "prints only the hits that you noted as still true", and the 'Done when' checklist requires every hit to be updated or explicitly justified. Because this batch-edit workflow does include verification steps, the destructive/batch cap at 3 does not apply, and the sequence matches the anchor-5 pattern of explicit validation plus a completion checklist. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained procedure (~90 lines, no references/, scripts/, or assets/ directories exist) organized into six numbered sections that mirror the workflow, so navigation is trivial. Nothing belongs in a separate file — the grep/diff pipelines are the core procedure, not reference material — so content placement is appropriate and there are no buried or nested references; this fits anchor 5's 'content appropriately split / easy navigation' better than anchor 4, which would require identifying a real organization gap. | 5 / 5 |
Total | 20 / 20 Passed |