Our review
Updates an existing GitHub pull request after adding commits by revising title/body, preserving template format, and pushing pending branch changes.
Strengths
- Automates PR title and body updates with language detection and template adherence.
- Handles unpushed commits and uncommitted changes interactively.
- Incorporates references to issues, docs, or related PRs from conversation history.
Limitations
- Requires gh and git to be installed and configured locally.
- Works only for local branches with an open PR on GitHub.
- Language detection may be ambiguous if the template or user messages are mixed.
Use this skill after adding commits to a branch to update the corresponding pull request in a clean, guided manner.
Do not use it for creating a new PR, for closed PRs, or if you just need a quick title change without the full workflow.
Security analysis
SafeThe skill uses git and gh commands only for PR management, no destructive or exfiltrating actions, all within safe boundaries.
No concerns found
Examples
Update the pull request for this branch with the latest changes.I've pushed more fixes. Please update this PR and use French for the title.Update the PR body to include the issue #123 and the related PR #456 in the References section.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.