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.
The body is an exemplary instruction-only skill: lean, sequenced, and grounded in exact git and gh commands, with validation explicitly gating every destructive action. Its only shortcoming is that the late-commit fix-forward and worktree-cleanup steps give direction rather than executable commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-dense with no explanations of concepts Claude already knows; every step carries operational content. The repeated emphasis on destructive-operation gating is safety-critical instruction, not padding, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Most steps give fully executable commands (gh pr view with JSON fields, git rev-list --parents, git merge-base --is-ancestor, git show --remerge-diff, and complete git patch-id --stable pipelines covering both merge shapes). Steps 3-4 rely on direction rather than commands ("fix-forward with a new PR", "Resolve and validate the exact worktree path"), which are minor gaps keeping it below copy-paste-complete. | 4 / 5 |
Workflow Clarity | The five steps are clearly sequenced with explicit validation checkpoints gating the destructive operations: "Prepare cleanup only after the content diff is empty" and "If the content diff is non-empty and you are unsure why, stop and report rather than deleting anything". This provides exactly the validate-before-destructive feedback loop the rubric requires, including the patch-id re-check for the behind-main case. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized Steps and Notes sections, and its single external reference (docs/agents/pull-request-workflow.md#landed) is one level deep and clearly signaled with section anchors. No bundle files exist to inline or bury, so the structure fully satisfies the simple-skill organization anchor. | 5 / 5 |
Total | 19 / 20 Passed |