"Finalize GitHub PRs end-to-end: update branch/PR, monitor CI until green, squash-merge, and clean up local/remote state. Use when asked to $fin or to finish/land/merge/close a PR, watch checks or runs, squash-merge, delete the branch, and sync local state."
Install
npx skillscat add tkersey/dotfiles/fin Install via the SkillsCat registry.
SKILL.md
Fin
Overview
Finish a PR end-to-end: push updates, watch checks, squash-merge, and clean up state.
Workflow
Identify the PR and target branch.
- Use
gh pr view(current branch) orgh pr listto locate it.
- Use
Update the PR.
- Ensure the branch is up to date, run required checks, and push:
git status, fix issues, thengit push.
- Ensure the branch is up to date, run required checks, and push:
Monitor checks until green.
- Use
gh pr checks --watchorgh run watch <run-id>. - If checks fail, fix, push, and re-watch.
- Use
Squash-merge the PR.
- Prefer
gh pr merge --squash --delete-branchunless repo policy dictates otherwise. - If approvals are missing, request them before merging.
- Prefer
Clean up local state.
- Fetch the updated mainline, switch to it, and delete the merged branch.
Guardrails
- Do not merge if required checks or approvals are missing.
- Keep the merge method aligned with repo policy.
- If any step is blocked, state the blocker and required next action.