ggprompts/my-plugins/merge

Claude Code and agent skill by ggprompts/my-plugins

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Branch merging and conflict resolution patterns. Use when merging feature branches, handling conflicts, or cleaning up worktrees. Trigger with "merge branch", "resolve conflicts", "cleanup worktree".

Install

npx vskill@latest install ggprompts/my-plugins/merge

SKILL.md

Merge - Branch Management

Patterns for merging worker branches and handling conflicts.

CRITICAL: Always kill the worker terminal BEFORE merging. See @references/terminal-cleanup.md

Standard Merge Flow

bash
ISSUE_ID="ISSUE-ID"
TABZ_API="http://localhost:8129"
TOKEN=$(cat /tmp/tabz-auth-token)
# 1. Kill worker terminal first
AGENT_ID=$(curl -s "$TABZ_API/api/agents" | jq -r --arg id "$ISSUE_ID" \
'.data[] | select(.name == $id) | .id')
[ -n "$AGENT_ID" ] && curl -s -X DELETE "$TABZ_API/api/agents/$AGENT_ID" \
-H "X-Auth-Token: $TOKEN"
# 2. Ensure on main
git checkout main
git pull
# 3. Merge feature branch
git merge "feature/$ISSUE_ID" --no-edit
# 4. Remove worktree and branch
git worktree remove ".worktrees/$ISSUE_ID" --force
git branch -d "feature/$ISSUE_ID"
# 5. Sync and push
bd sync
git push

One-Command Alternative

For full cleanup with checkpoints, capture, and terminal kill:

bash
./plugins/conductor/scripts/finalize-issue.sh "$ISSUE_ID"

Conflict Detection

bash
# Test merge without committing
git merge --no-commit --no-ff "feature/$ISSUE_ID"
git merge --abort

If conflicts exist, git merge will fail with conflict markers.

Conflict Resolution

Don't auto-resolve. Report conflicts for manual resolution:

bash
# Get conflict files
git diff --name-only --diff-filter=U
# Show conflict details
git diff --check
Manual Resolution Steps
  1. Navigate to worktree: cd .worktrees/ISSUE-ID
  2. Open conflicting files
  3. Resolve conflicts (remove markers, choose correct code)
  4. Stage: git add .
  5. Commit: git commit
  6. Re-run cleanup

Merge Strategies

Fast-Forward (Clean history)
bash
git merge --ff-only "feature/$ISSUE_ID"

Only works if main hasn't changed.

No-FF (Always create merge commit)
bash
git merge --no-ff "feature/$ISSUE_ID"

Creates merge commit even if fast-forward possible.

Squash (Single commit)
bash
git merge --squash "feature/$ISSUE_ID"
git commit -m "feat: description (ISSUE-ID)"

Combines all commits into one.

Default: Use --no-edit for automatic merge commit message.

Worktree Cleanup

bash
# Remove worktree (--force ignores uncommitted changes)
git worktree remove ".worktrees/ISSUE-ID" --force
# List remaining worktrees
git worktree list
# Prune stale worktree references
git worktree prune

Branch Cleanup

bash
# Delete local branch (fails if not merged)
git branch -d "feature/ISSUE-ID"
# Force delete (use carefully)
git branch -D "feature/ISSUE-ID"
# Delete remote branch
git push origin --delete "feature/ISSUE-ID"

Batch Operations

bash
# Find all merged feature branches
git branch --merged main | grep "feature/"
# Delete all merged feature branches
git branch --merged main | grep "feature/" | xargs git branch -d
# Find orphaned worktrees
git worktree list | grep -v "$(pwd)$"

Error Handling

ErrorAction
Merge conflictStop, report files, require manual resolution
Branch not foundSkip branch deletion
Worktree not foundSkip worktree removal
Not on mainCheckout main first
Uncommitted changesStash or warn
TabzChrome not runningSkip terminal kill, continue with merge
No auth tokenSkip terminal kill, continue with merge

Safety Checks

Before merging:

  1. Verify issue is closed
  2. Kill worker terminal via TabzChrome API (see @references/terminal-cleanup.md)
  3. Verify branch exists
  4. Check for conflicts first

After merging:

  1. Verify merge succeeded
  2. Run any CI checks
  3. Sync beads
  4. Push to remote

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
7
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ggprompts/my-plugins/merge/badge)](https://verified-skill.com/skills/ggprompts/my-plugins/merge)

Something wrong with this skill or its page? Tell us.