rebase-assistant
Guide a safe git rebase of the current branch onto a target branch, including conflict triage and resolution steps. Use when asked to rebase, update a branch, or resolve rebase conflicts.
When & Why to Use This Skill
The Rebase Assistant is a specialized Claude skill designed to streamline and secure the Git rebase process. It automates pre-flight checks, guides users through complex conflict resolution (including content, binary, and rename conflicts), and ensures a clean commit history while maintaining strict safety protocols to prevent data loss. By providing a guided workflow for branch synchronization, it helps developers maintain a linear project history without the typical risks associated with manual rebasing.
Use Cases
- 1. Streamlining Feature Branch Updates: Automatically sync feature branches with the latest changes from the main branch while ensuring a clean, linear history through guided rebase steps.
- 2. Intelligent Conflict Resolution: Provides step-by-step guidance for triaging and resolving complex merge conflicts, including specific strategies for content, binary, and rename-related conflicts.
- 3. Safe Version Control Operations: Execute rebases with built-in safety checks, such as automatic branch backups and command previews, to prevent accidental code loss or destructive 'git reset' errors.
- 4. Repository Maintenance and Cleanup: Assist in resolving 'delete/modify' or 'rename' conflicts that often stall manual rebase attempts, ensuring the repository remains in a healthy state.
| name | rebase-assistant |
|---|---|
| description | Guide a safe git rebase of the current branch onto a target branch, including conflict triage and resolution steps. Use when asked to rebase, update a branch, or resolve rebase conflicts. |
Rebase assistant
Goal
Rebase the current branch onto a target branch safely, with built-in conflict resolution guidance.
Inputs to confirm (ask if missing)
- Target branch (explicit branch name or "default branch").
- Preferred conflict bias when ambiguous: keep ours, keep theirs, or manual merge.
- Protected paths or file types to avoid touching.
Workflow
- Identify the target branch
- If user says "default branch": discover via
git remote show origin(read "HEAD branch"). - If ambiguous or no remote: ask the user which branch to use.
- If user says "default branch": discover via
- Preflight checks
git status -sb(must be clean before rebase).git fetch --pruneto sync remotes.- Optional safety branch (ask before creating):
git branch backup/<current-branch>.
- Start the rebase
git rebase <target-branch>
- If conflicts occur, resolve (repeat per file)
- Inspect conflict list:
git status -sbgit diff --name-only --diff-filter=U
- Classify and inspect:
- Content conflicts: open file, resolve markers.
- Delete/modify or rename conflicts: decide keep vs delete explicitly.
- Binary conflicts: choose ours/theirs only.
- Show base/ours/theirs when useful:
git show :1:<path>git show :2:<path>git show :3:<path>
- File-level choice when safe:
git checkout --ours <path>git checkout --theirs <path>
- Stage resolved files:
git add <path> - Continue:
git rebase --continue
- Inspect conflict list:
- Finish and verify
- Ensure no conflicts:
git status -sb - Suggest a fast test/build if available.
- Ensure no conflicts:
Safety rules
- Never run
git reset --hard,git clean -fd, orgit rebase --abortunless the user explicitly requests it. - Always show candidate commands before applying destructive changes.
Deliverables
- The exact rebase command used and target branch.
- Conflict list grouped by type with per-file resolution guidance.
- Completion command and a short verification suggestion.