Content
81%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 strong procedural skill body: ordered resolution steps, executable git/gh commands, explicit validation checkpoints, and well-handled ambiguity via user prompts. Minor improvements are possible in tightening the dense Inputs prose and supplying commands for the shallow-repo deepening and metadata-recording steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is procedural with no explanations of concepts Claude already knows, and the gh/git gotchas ('Do not rely on bare gh pr view…') earn their tokens. Not 5: the Inputs paragraph is a dense wall of prose and a few sentences ('Keep these values distinct…') could be tightened into a list. | 4 / 5 |
Actionability | Provides concrete, executable commands for the core steps — 'git fetch --no-tags "$TARGET_SOURCE" "+refs/heads/$TARGET_BRANCH:refs/comparison/target"', 'gh pr list --repo <candidate-base-repository> --state open --head …', 'git merge-base --all', 'git rev-list --count'. Not 5: two steps lack commands — deepening shallow histories and recording the comparison commit's short SHA/date/subject are described but not executable. | 4 / 5 |
Workflow Clarity | Clear three-step sequence with explicit validation ('Verify $BASE_COMMIT is non-empty and is an ancestor of both $TARGET_REF and $REVIEW_REF'), ordered PR-resolution sources with stop conditions, and feedback loops for error recovery (nonzero merge-base status, empty base in shallow repos, multiple best ancestors). Risky actions are gated — merging the target branch 'never perform it without explicit approval'. | 5 / 5 |
Progressive Disclosure | A single well-organized file with clear section headers (Inputs, Steps 1–3, Outputs, Edge Cases) and no nested or buried references; nothing clearly belongs in a separate file. Not 5: at ~110 lines it exceeds the under-50-line single-file exception, and the Edge Cases section partially restates guidance already embedded in the steps. | 4 / 5 |
Total | 17 / 20 Passed |