Pull Request Review
Use this skill to review a pull request against the repository quality bar and leave actionable feedback.
Workflow
- Read the PR description to understand the goal
- Review the linked issue(s) for context
- Check that tests are included and passing
- Review code changes file by file
- Verify documentation is updated if needed
- Leave constructive feedback with specific suggestions
- Approve, request changes, or comment based on findings
Examples
Approval comment:
Looks good! Clean implementation with comprehensive tests.
Minor suggestion: Consider extracting the validation logic
in `UserService.ts:45` into a separate function for reusability.
Approved ✅
Request changes:
Good progress, but a few items need attention:
1. Missing test for error handling in `fetchUser()`
2. The new endpoint needs documentation in the API docs
3. Consider adding input validation for the email field
Please address these and I'll re-review.
Quality Bar
- Start with understanding the PR's goal
- Be constructive and specific in feedback
- Distinguish between required changes and suggestions
- Test the changes locally if complex
- Check for security implications
- Verify backward compatibility
- Approve only when confident in the changes
Resource Strategy
- Add
scripts/only when the task is fragile, repetitive, or benefits from deterministic execution. - Add
references/only when details are too large or too variant-specific to keep inSKILL.md. - Add
assets/only for files that will be consumed in the final output. - Keep extra docs out of the skill folder; prefer
SKILL.mdplus only the resources that materially help.