Our review
Automatically updates an existing GitHub pull request after adding commits by revising title and body while preserving the template format.
Strengths
- Automatically detects and applies PR templates
- Infers changes from commit logs and diffs
- Handles language detection for title and body
- Checks for unpushed commits before pushing
Limitations
- Requires `gh` CLI to be installed and authenticated
- Only works if there is already an open PR for the branch
- Language detection may be ambiguous without user input
When you have added commits to a branch with an existing PR and want to keep its description up to date.
If there is no open PR for the branch yet (use `/create-pr` instead).
Security analysis
SafeThe skill uses only safe git and gh commands (status, diff, log, push, pr edit, etc.) and explicitly requires user confirmation before pushing changes or editing PRs. No destructive operations, no external data exfiltration, no execution of arbitrary code.
No concerns found
Examples
Update the pull request on this branch with the latest changes.I've just pushed a new commit to fix a bug. Please update the PR description accordingly.Please update the PR using the project template and push any pending commits.name: update-pr description: Update an existing GitHub pull request after adding commits by revising title/body, preserving template format, and pushing pending branch changes. allowed-tools: Bash(git status *), Bash(git diff *), Bash(git log *), Bash(git rev-parse *), Bash(git push *), Bash(git ls-files *), Bash(gh repo view *), Bash(gh pr view *), Bash(gh pr edit *), Read, Glob, Grep, AskUserQuestion
Pre-fetched context
!git rev-parse --abbrev-ref HEAD
!git status --short
!git ls-files ':(top,icase).github/pull_request_template.md' ':(top,icase).github/pull_request_template/*.md' ':(top,icase)pull_request_template.md'
Instructions
Update the existing pull request for the current branch. Follow this flow:
-
Gather context: Get default branch via
gh repo view --json defaultBranchRef -q .defaultBranchRef.name, then rungit log --oneline,git diff --stat, andgit diffagainst it. -
Missing PR check: Run
gh pr view --json number,url,title,body,baseRefName,headRefName,isDraft. If it fails, tell the user there is no open PR for this branch. Ask whether to switch to/create-pror abort. -
Uncommitted changes: If
git statusabove shows output, ask whether to commit them, ignore them, or abort. Do not proceed until answered. -
PR template:
- If a template path is listed,
Readit before writing title/body. - Detect
template_languagefrom headings/instructions/checklists (ignore code, URLs, HTML comments). - Keep template headings/order and keep HTML comments (
<!-- -->). - If no template exists, skip.
- If a template path is listed,
-
Compose updated PR content:
- Infer what changed since the previous PR revision from the commit log and diff.
- Title: Conventional Commits, under 72 chars.
- Decide title language before drafting and keep it fixed unless the user requests a change.
- Title language policy: use
template_languagefirst whenever it can be detected. - If the user explicitly asks to override language for the current PR, follow that override.
- If no
template_languageis detected, use: explicit user request > latest substantive user message > English. - Ignore slash commands (for example
/update-pr), code blocks, file paths, and URLs when inferring language. - If language signals conflict or are ambiguous, ask the user which language to use before drafting.
- Keep
type(scope)tokens standard (feat,fix, etc.); localize only the description text. - Body: if template exists, fill its sections. If not, use Summary / Changes / Concerns / References.
- Proactively include any reference links (issues, docs, related PRs) found in conversation history.
-
Confirm: Show the full updated PR title/body. Ask if the user wants to change the title, add links, or make any edits — apply and re-confirm. Do not push or edit until approved.
-
Push and update:
- Push (
git push -u origin HEAD) only if there are unpushed commits (git log @{upstream}..HEAD). - Update with
gh pr edit --title "<title>" --body-file <file>. - Return the PR URL.
- Push (
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.