| name | review-pr |
| description | Review and merge GitHub pull requests for Spatie packages. Use when asked to review a PR, review a pull request, merge a PR, or when given a GitHub PR URL to review. Also triggers on 'review this PR,' 'check this pull request,' 'merge this,' or '/review-pr'. Uses gh CLI for all GitHub operations. |
Review PR
Review a GitHub pull request, verify CI status, merge it, and thank the author. Only tag a release when explicitly asked.
Workflow
1. Fetch PR details
Use gh CLI to get the PR diff, description, and CI status:
gh pr view <number> --json title,body,additions,deletions,files,reviews,statusCheckRollup,headRefName,baseRefName
gh pr diff <number>
2. Review the changes
Run the shared review lanes against this PR, in report-only mode. Read the lane definitions from:
~/.claude/skills/review-code/references/lanes.md
Run every applicable lane against the PR, following the "Running the lanes" section for whichever harness you are. Give each lane the diff from step 1 as its target.
Report only. Never apply fixes to someone else's PR, even for findings that would be auto-applied in /review-code. The output of this step is a verdict, not an edit.
On top of the lane findings, judge:
- Whether the change matches the PR description
- Test coverage for new functionality
- Whether it fits the existing patterns of this package
If there are issues, post a review comment via gh pr review <number> --request-changes --body "..." and stop.
3. Check CI status
All CI checks must be green before merging. Verify via the statusCheckRollup field from step 1. If CI is failing or pending, inform the user and stop.
