| name | pr-workflow |
| description | Create pull requests and manage the PR workflow. Use when creating a PR, reviewing PRs, managing feature branch merges, or asking about PR conventions, code review process, or the collaborative feature branch workflow. |
| argument-hint | PR or issue number |
| allowed-tools | ["Read","Grep","Glob","Bash(gh pr *)","Bash(gh api *)","Bash(git *)"] |
PR Workflow Skill
Related Skills
github-issues — PRs must reference an issue via Closes #<number>
- Branch naming rules:
.claude/rules/branch-naming.md
Before Creating a PR
- Verify branch naming — must match
<author>/<type>/issue-<number>-<short-description>
- Check diff size — warn if over ~400 changed lines and suggest splitting
- Ensure commits reference the issue — e.g.,
Add validation (#12)
- Push the branch to remote if not already pushed
Creating a PR
Use the PR template (.github/PULL_REQUEST_TEMPLATE.md):
gh pr create \
--title "Short descriptive title" \
--body "## Summary
Closes #<issue-number>
## Changes
- Change 1
- Change 2
## How to Test
1. Step 1
2. Step 2
## Checklist
- [x] PR is under ~400 changed lines
- [x] Branch follows naming convention
- [x] Commits reference the issue number
- [ ] Tests pass
- [ ] At least one teammate has been requested for review" \
--reviewer "teammate-username"
Key Rules
- Always include
Closes #<number> or Fixes #<number> in the PR body
- Target the
main branch (or parent feature branch for sub-branches)
- Request at least one teammate as reviewer
- Use merge commits only — never squash or rebase
- Delete the branch after merging
Collaborative Feature Branch Workflow
When multiple people are actively coding the same feature in parallel:
- Feature owner creates a feature branch from
main
- Each contributor creates a sub-branch off the feature branch
- Contributors open PRs targeting the feature branch (not main)
- Feature owner reviews and merges contributor PRs
- Each contributor is responsible for resolving conflicts in their own PR
- When complete, feature owner PRs the feature branch into
main
If only one person is implementing a feature, skip this — PR directly to main.
See reference.md for the git commands.