make-pr-easy-to-review
Cleans up a PR's history and description and adds reviewer guidance, without changing code behaviour.
- Kind
- Skill
- Works with
- Cursor
- Source
- cursor/plugins @ 9580c23696ac
- Path
- cursor-team-kit/skills/make-pr-easy-to-review/SKILL.md
- License
- MIT
- Jobs
- Git workflow, Documentation
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# Make PR Easy to Review
Prepare a PR so a reviewer can quickly understand the intent, important files, and risk. The default goal is reviewability without behavior changes.
## Workflow
1. Resolve the target PR from the user-provided URL or current branch.
2. Inspect commits, diff size, changed paths, generated files, and PR description.
3. Identify reviewability issues: noisy commits, stale description, unrelated changes, mixed mechanical and logic changes, missing tests, or unclear reviewer entry points.
4. Propose a plan before rewriting history or force-pushing.
5. Apply safe improvements, then verify the tree or diff still matches the intended code.
## History Cleanup
Only rewrite history when the user asks for it or agrees to the plan. Before rewriting:
```bash
gh pr view <PR> --json title,headRefName,baseRefName,state,commits
git fetch origin <headRefName> <baseRefName>
ORIGINAL_TREE=$(git rev-parse origin/<headRefName>^{tree})
```
Good commit groupings usually follow dependency order:
1. Schema/storage or generated API definitions.
2. Core logic.
3. Wiring and integration.
4. UI or surface behavior.
5. Tests.
After rewriting, verify content identity:
```bash
…