skinnyandbald/fish-skills

verify-worktree-plugins

Verify worktree plugin patches are intact after plugin updates. Checks compound-engineering and superpowers skills for Claude Code launch instructions.

First seen Feb 18, 2026

Installation

$ npx skills add skinnyandbald/fish-skills --skill verify-worktree-plugins

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from skinnyandbald/fish-skills · top by installs.

npx skills add skinnyandbald/fish-skills

Browse all from skinnyandbald/fish-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License MIT
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,801 B
  • docs SUMMARY.md 182 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 24 installs

SKILL.md

Verify Worktree Plugin Patches

After plugin updates, the worktree skills (compound-engineering git-worktree, superpowers using-git-worktrees) lose custom patches that tell Claude Code to launch new instances in worktree directories.

What This Checks

Component What's Verified
compound-engineering SKILL.md "Claude Code + Worktree Working Directory" section
compound-engineering worktree-manager.sh "Open a NEW Claude Code instance" banner after create
superpowers SKILL.md "Launch Claude Code" in step 5 report
PreCompact hook getWorktreeContext function for compaction survival

Both marketplace and latest cache versions are checked.

Instructions

1. Run the verification script

bash ~/.claude/scripts/verify-worktree-plugins.sh

2. If any checks fail, re-apply patches

bash ~/.claude/scripts/verify-worktree-plugins.sh --patch

3. If the PreCompact hook is missing worktree detection

The --patch flag cannot auto-fix the TypeScript hook. Regenerate it manually:

The hook at ~/.claude/hooks/context-compression-hook.ts needs a getWorktreeContext() function that:

  1. Runs git rev-parse --git-dir to detect if CWD is a worktree (path contains /worktrees/)
  2. If yes, outputs branch, worktree path, and main repo path
  3. This output gets injected as a <system-reminder> during compaction

Regenerate it with this structure:

import { execSync } from "node:child_process";

function getWorktreeContext(): string | null {
  // Check git-dir for "/worktrees/" to detect worktree
  // Return formatted context string with branch, path, main repo
  // Return null if not in a worktree
}

// In main(): call getWorktreeContext() and console.log if non-null

4. Report results to the user

Show the verification output and note any files that needed patching.

Background

Claude Code's statusline, git context, and system prompt are set at launch time. Running cd in a Bash tool call does NOT change the process CWD. After auto-compact, Claude reverts to the launch directory's context. Each worktree needs its own Claude Code instance launched from that directory (cd /path && claude).

The worktree plugin patches ensure Claude always tells the user to open a new terminal and launch Claude Code from the worktree directory after creation.

When to Run

  • After updating the compound-engineering plugin
  • After updating the superpowers plugin
  • If worktree creation stops showing the "launch Claude Code" instructions
  • Periodically as a sanity check