make-pr-easy-to-review
Installation
SKILL.md
Target reviewability without behavior changes; prefer PR description/review notes over code edits.
Workflow
- Resolve PR from URL/current branch.
- Inspect commits, diff size, paths, generated files, and description. For stacks, compare
baseRefName, record adjacent layers, and operate only on the owning branch. - Find noise: stale description, unrelated changes, mixed mechanical/logic commits, missing tests, unclear entry points.
- Propose before history rewrite/force-push; reorder/fold/cascade needs explicit whole-stack approval.
- Apply safe improvements; prove tree/diff still matches intent.
History
Only rewrite history when the user asks or agrees to the plan. Capture identity first:
gh pr view <PR> --json title,headRefName,baseRefName,state,commits --jq '{title,headRefName,baseRefName,state,commits}'
git fetch origin <headRefName> <baseRefName>
ORIGINAL_TREE=$(git rev-parse origin/<headRefName>^{tree})