close-feature-pr
Merge and close a feature PR with gh after a quick PR hygiene review (title, required sections, testing notes) aligned with create-feature-pr. Use when the user asks to merge/close a feature PR, delete the remote branch, and do post-merge cleanup.
When & Why to Use This Skill
This Claude skill automates the end-to-end process of merging and closing GitHub Pull Requests (PRs). It ensures high-quality repository maintenance by performing a PR hygiene review, verifying CI check statuses, executing the merge, and handling comprehensive post-merge cleanup for both remote and local environments.
Use Cases
- Automating the final merge of feature branches while ensuring PR documentation—including summaries, testing notes, and risk assessments—meets project standards.
- Streamlining developer workflows by automatically deleting remote feature branches and syncing the local base branch immediately after a successful merge.
- Enforcing quality gates by programmatically checking that PRs are not in draft status and that all required CI/CD checks have passed before finalizing code integration.
| name | close-feature-pr |
|---|---|
| description | Merge and close a feature PR with gh after a quick PR hygiene review (title, required sections, testing notes) aligned with create-feature-pr. Use when the user asks to merge/close a feature PR, delete the remote branch, and do post-merge cleanup. |
Close Feature PR
Contract
Prereqs:
- Run inside the target git repo.
gitandghavailable onPATH, andgh auth statussucceeds.- Working tree clean (
git status --porcelain=v1is empty).
Inputs:
- PR number (or current-branch PR).
- Optional: merge readiness decisions (draft → ready; checks pass).
Outputs:
- PR merged (default merge commit) and remote branch deleted.
- Local checkout switched back to base branch and updated; local feature branch deleted (best-effort).
Exit codes:
0: success- non-zero: checks failing, PR not mergeable, auth issues, or git/gh command failures
Failure modes:
- PR is draft (must confirm and mark ready first).
- Required checks failing or branch not mergeable.
- Missing
ghauth or insufficient permissions.
Setup
- Ensure
gh auth statussucceeds. - Load local helper commands (optional):
source $AGENT_KIT_HOME/scripts/kit-tools.sh
When to use
- The user asks to merge/close a PR and clean up the feature branch.
Workflow
- Identify the PR number
- Prefer current branch PR:
gh pr view --json number -q .number
- Prefer current branch PR:
- Preflight
- Ensure working tree is clean:
git status --porcelain=v1should be empty - Ensure checks pass:
gh pr checks <pr> - Ensure PR is not draft:
gh pr view <pr> --json isDraft -q .isDraftshould befalse(iftrue, confirm with the user then rungh pr ready <pr>)
- Ensure working tree is clean:
- Review PR hygiene (aligned with
create-feature-pr)- Title reflects feature outcome; capitalize the first word.
- PR body includes:
Summary,Changes,Testing,Risk / Notes. - If PR body includes
Open Questionsand/orNext Stepsand they are not already- None, update them to the latest status (resolve questions or confirm with the user, check off completed steps, link follow-ups). Testingrecords results (pass/failed/skipped) and reasons if not run.- If edits are needed: use
gh pr edit <pr> --title .../gh pr edit <pr> --body-file ....
- Merge and delete branch
- Default merge method: merge commit
gh pr merge <pr> --merge --delete-branch
- Local cleanup
- Resolve refs:
baseRefName="$(gh pr view <pr> --json baseRefName -q .baseRefName)"headRefName="$(gh pr view <pr> --json headRefName -q .headRefName)"
git switch "$baseRefName" && git pull --ff-only- Delete local feature branch if it still exists:
git branch -d "$headRefName"
- Resolve refs:
Optional helper script
- Use
scripts/close_feature_pr.shin this skill folder to run a deterministic merge + cleanup. - If
scripts/close_feature_pr.shfails, attempt to fix the underlying cause (prefer fixing the script when it's a script bug, otherwise fix the documented prerequisites/workflow), re-run it, and explicitly report whether the fix succeeded.