Pull Request Skill
When to Use This Skill
Use this skill when asked to:
- Create a pull request for the current branch.
- Update an existing PR branch or description.
- Rewrite a PR body.
- Follow up on CI or check failures for an existing PR.
References
- PR conventions and local validation:
AGENTS.md(Essential Commands and Commit Style sections)
Lifecycle Rules
Check for an existing PR before creating a new one:
gh pr list --head "$(git branch --show-current)" --author @me --json number --jq '.[0].number // empty'If that returns a number, update that PR. If it returns empty output, create a new one.
Check you are not on main. If the current branch is
mainormaster, create a feature branch before doing PR work.Default to draft. Use
gh pr create --draftunless the user explicitly asks for ready-for-review.Keep description aligned with the full diff. Re-read the diff against the base branch before writing or updating the title and body. Describe the entire PR diff, not just the last commit.
Never auto-merge. Do not merge or mark ready for review unless the user explicitly asks.
Never push to main or master.
PR Title Format
Follow the commit style from AGENTS.md:
type(scope): message
Examples:
feat(mcp): add tool allowlist filteringfix(intercept/messages): handle empty streaming chunksrefactor(provider): extract common auth logic
PR Description
- Start with a one-line summary of what and why.
- List key changes as bullet points.
- Note any breaking changes or migration steps.
- Do not fabricate or embellish — describe only what the diff contains.
CI / Checks Follow-up
Always watch CI checks after pushing. Do not push and walk away.
After pushing:
- Monitor CI with
gh pr checks <PR_NUMBER> --watch. - Use
gh pr view <PR_NUMBER> --json statusCheckRollupfor programmatic check status.
If checks fail:
- Find the failed run ID from the
gh pr checksoutput. - Read the logs with
gh run view <run-id> --log-failed. - Fix the problem locally.
- Run
make testandmake fmtbefore pushing the fix. - Push the fix.
Pre-Push Validation
Before pushing, always run:
make fmt
make test
What Not to Do
- Do not reference or call helper scripts that do not exist in this repository.
- Do not auto-merge or mark ready for review without explicit user request.
- Do not push to
origin/mainororigin/master. - Do not skip local validation before pushing.
- Do not fabricate or embellish PR descriptions.
- Do not use
--no-verifyon git operations.