agentsclimarketplace

Move branch here

Skill patinaproject/skills/skills/move-branch-here

Attach a branch another worktree holds to the current worktree, carrying its polish review state. Use when a checkout is refused because the branch is already used by another worktree, or when the user asks to move a branch here.From its SKILL.md

Install
npx -y skills add patinaproject/skills --skill move-branch-here

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 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.

SKILL.md

5.8 KB, as published. Nobody here has run it

Move Branch Here

Quick Start

Invoke from the worktree that should end up on the branch:

/move-branch-here 350-add-a-move-branch-here-skill
/move-branch-here 350-add-a-move-branch-here-skill --from /tmp/other-session

--from names the temporary root of the session that reviewed the branch elsewhere, and reaches only Step 3.

The move releases the branch from the worktree holding it and attaches it here. The released worktree keeps its files on a detached HEAD at the same commit. Leave committing, pushing, and worktree removal to the operator.

Scope is the worktrees of one repository, which git worktree list enumerates. A branch that lives in a separate clone is a fetch rather than a move: report that and stop.

Step 1 — Resolve the Holder

Resolve <skill-directory> to the directory containing this SKILL.md, then run the bundled helper:

<skill-directory>/scripts/worktree-context.sh resolve <branch>

The tab-separated result carries mode, branch name, branch head, the count of untracked files in the holder, holder path, and holder head. The two holder fields are empty in free mode. Step 2 consumes those fields.

ModeMeaningNext action
hereThis worktree already has the branchReport the no-op and continue at Step 3
freeNo worktree holds the branchAttach it in Step 2
heldAnother worktree holds the branchRelease and attach it in Step 2

The helper exits non-zero rather than moving a branch out from under work in progress. Both worktrees qualify: this one and the holder must each be free of uncommitted tracked changes and of a merge, rebase, cherry-pick, revert, bisect, or patch application, and the holder must be unlocked and still on disk. A rebase or a bisect detaches the worktree running it, so no worktree record claims the branch and it reads as free; the helper reads those operations' own state to catch that and refuse.

That state read reaches every worktree, and only in free mode — the mode whose whole claim is that nothing holds the branch. A worktree there whose directory was deleted mid-operation strands no live work, so the move proceeds and git worktree prune clears its metadata; one the helper cannot read is refused, because an unreadable worktree hides whatever it is running. The holder itself is never skipped in any mode: a holder that is gone or unreadable stops the move on its own message.

Every message names the blocker and the command that clears it. Report that message and stop; committing, stashing, finishing, aborting, unlocking, or pruning is the operator's call.

Step 2 — Move the Branch

<skill-directory>/scripts/worktree-context.sh move <branch> <branch-head> [holder-path]

Pass the holder path in held mode and omit it in free mode. The helper revalidates the resolved context before touching either worktree, releases the holder, attaches the branch here, and restores the holder to the branch when attaching fails. A failed move leaves the branch where it started.

Untracked files stay in the released worktree. When the resolved count is above zero, name it in the final report so the operator knows work remains at that path.

Step 3 — Carry the polish Review State

A polish review record follows its branch between the worktrees of one repository, and a session that resolves a different temporary root sees none of it — paying a full re-review of an already reviewed branch. Read polish/review-record.md for the record's identity and commands, resolving <polish-skill-directory> to the installed polish directory beside this skill. A missing <polish-skill-directory>/scripts/review-state.mjs means polish is not installed: report that the review state was left alone and finish, because the move itself still succeeded.

  1. Resolve the target branch from origin/HEAD and read what this session sees:

    node <polish-skill-directory>/scripts/review-state.mjs scope --target <target-branch>
    

    A valid state carried with the branch. Report its mode and outstanding findings, and finish. An unavailable or corrupt state leaves nothing usable here, so treat it as missing and continue below.

    The command also refuses a worktree holding uncommitted or untracked files, which the move itself permits. Report the review state as unread and name that polish needs a clean worktree to see it, then finish: the move already succeeded.

  2. A missing state with a --from root copies the record in, then re-reads the scope above:

    node <polish-skill-directory>/scripts/review-state.mjs relocate \
      --from <other-temporary-root> --branch <branch>
    

    An empty relocated list, or a root holding no review state at all (which exits non-zero), means the branch has no record to carry. Both are an absent record rather than a failed move: report absent and finish.

  3. A missing state with no --from root finishes on the report: this session sees no review state for the branch, and the relocate command above takes the other session's temporary root whenever the operator has it.

Final Report

Always include:

  • The branch, its head commit, and the worktree it now lives in.
  • The released worktree path and its detached HEAD, or the no-op that needed no release.
  • Untracked files left behind in the released worktree, when there are any.
  • The review state outcome: carried, relocated, absent, unread because the worktree is not clean, or unhandled because polish is not installed.
  • The blocker that stopped the move, when one did.

Keep looking

Skills are one crate of 608,666. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.