shrink-this-pr
Installation
SKILL.md
Shrink This PR
PRs over ~400 lines get rubber-stamped or stalled. Both outcomes are bad. This skill is the algorithm for splitting a fat PR into a stack of small, reviewable, mergeable PRs.
When to use
- PR is >500 lines (excluding lockfiles, generated code).
- PR mixes mechanical refactor with new feature work.
- PR touches >10 files for one logical change.
- Reviewer says "I can't review this" or "lgtm" without comments (the latter is worse).
- You're about to open a PR like this — better to split before review than after.
When NOT to use
- Changes are atomic (one schema migration + the matching code change).
- Time-critical hotfix where review-friendliness is secondary.
- Generated/scripted refactor of 1000 files (mass rename) — single PR is fine.