Branch finishing
Git-versioned agent memory: agents that never make the same mistake twice. Anthropic-Skill folder standard, multi-runtime (Claude Code, Cursor, Gemini CLI, OpenCode).
npx -y skills add sordi-ai/skill-everything --skill branch-finishingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Apply when closing out a feature branch — pre-merge checklist, rebase, CI verification, cleanup, and post-merge steps.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.2 KB, as published. Nobody here has run it
Sub-Skill: Branch Finishing
Purpose: Ensures every feature branch is cleanly rebased, reviewed, and merged without introducing regressions or leaving stale local state behind.
Rules
Pre-Merge Preparation
- Rebase before merge. Always rebase onto the target branch immediately before requesting merge to catch regressions introduced since the branch was cut. Reference: ERR-2026-024
- Resolve conflicts locally. Before pushing a rebase, resolve every conflict locally and run the full test suite; never push a branch with unresolved markers.
- CI green before review. Ensure all CI checks pass on the latest push before requesting a human review; do not ask reviewers to look at a red branch.
- Self-review diff. Before opening a PR, run
git diff main...HEADand read every changed line; catch debug prints, commented-out code, and accidental file inclusions yourself first.
Commit Hygiene
- Squash fixup commits. Before merge, squash or fixup any
wip:,fixup!, ortmp:commits so the branch history is clean; usegit rebase -ito consolidate. - Issue closing keywords. Use
Closes #NNNorFixes #NNNin the PR body so the linked issue auto-closes on merge; never leave issues open manually after a successful merge. - Changelog update. After any user-visible change, add an entry to
CHANGELOG.md(or the project's equivalent) before marking the PR ready for review. - Version bump. If the project uses semantic versioning, bump the version in the appropriate manifest file as part of the branch before merge, not as a follow-up commit.
Draft → Ready Transition
- Draft until CI passes. Keep the PR in draft state until all CI checks are green and the self-review is complete; convert to ready-for-review only when the branch is genuinely merge-ready.
- Remove draft status explicitly. Use
gh pr ready <number>to convert from draft; do not rely on reviewers noticing a draft PR that was silently updated.
Post-Merge Cleanup
- Delete remote branch after merge. After a successful merge, delete the remote branch with
git push origin --delete <branch>or enable auto-delete in repository settings; stale remote branches pollute the branch list. - Delete local branch after merge. After confirming the remote merge, delete the local tracking branch with
git branch -d <branch>to keep the local workspace clean. - Post-merge verification. After merge, pull
mainlocally and run the test suite once to confirm the integrated state is green; do not assume CI on the PR branch is sufficient.
Conflict Resolution
- Prefer rebase over merge commits. Avoid merge commits on feature branches; use
git rebaseto maintain a linear history unless the team explicitly requires merge commits.
See also
skills/git-conventions/SKILL.mdskills/review-deployment/SKILL.md