| name | review-pr |
| description | Reviews the current local diff or branch at the end of a coding session for high-confidence bugs and repository instruction-file compliance. Use when asked to run `/review-pr` before commit, before push, or before handing changes off for PR creation or update, and when only certain, actionable findings should be reported while style feedback is ignored. |
Local Review
Perform systematic review with actionable, validated feedback only.
Use this skill as an explicit local self-review step before handoff, not as a generic replacement for native PR review tools.
Run it before /done when a coding session produced changes worth checking.
Reference Files
| File | Read When |
|---|
references/severity-rubric.md | Default: choosing severity labels and filtering weak findings |
references/comment-examples.md | Before producing a local review report |
references/review-surfaces.md | When deciding whether the work stays in local self-review or should hand off to PR-specific workflows |
Scope
- Default target: staged or uncommitted local changes
- Secondary target: current branch diff against base when the working tree is clean or the user asks for branch review
- Explicit PR requests are secondary: keep the same review criteria, but treat them as a handoff path rather than the main workflow
- Keep the skill focused on concrete bugs, missing validation/tests that clearly matter, and repository instruction-file compliance
- Do not use this skill for inbound PR comments or thread resolution; use
pr-comments for that
Workflow
Copy this checklist to track progress:
Review progress:
- [ ] Discover local review target
- [ ] Gather context and scoped instruction files
- [ ] Choose the local review path
- [ ] Validate findings
- [ ] Produce the review report
