Agent skill

worktree-kit

Manage git worktrees (create/list/switch/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees.

View SKILL.md on GitHub Repository
Stars 2
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/Gitmaxd/flowfactory/tree/main/templates/skills/worktree-kit

SKILL.md

Worktree kit

Use the manager script for all worktree actions.

bash
bash .factory/skills/worktree-kit/scripts/worktree.sh <command> [args]

Commands:

  • create <name> [base]
  • list
  • switch <name> (prints path)
  • cleanup
  • copy-env <name>

Safety notes:

  • create does not change the current branch
  • cleanup does not force-remove worktrees and does not delete branches
  • cleanup deletes the worktree directory (including ignored files); removal fails if the worktree is not clean
  • .env* is copied with no overwrite (symlinks skipped)
  • refuses to operate if .worktrees/ or any worktree path component is a symlink
  • copy-env only targets registered worktrees
  • origin fetch is optional; local base refs are allowed
  • fetch from origin only when base looks like a branch
  • Worktrees live under .worktrees/

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Gitmaxd/flowfactory

flow-work

Execute a plan file or Beads epic systematically with git setup, task tracking, quality checks, and commit workflow. Use when implementing a plan, working through a spec, following documented steps, or executing a Beads issue ID (e.g., bd-123, gno-45, app-12).

2 0
Explore
Gitmaxd/flowfactory

flow-plan-review

Carmack-level plan review via rp-cli context builder + chat. Use when reviewing implementation plans, architecture docs, or design specs. Triggers on mentions of plan review, design review, or architecture review.

2 0
Explore
Gitmaxd/flowfactory

flow-resume

Resume interrupted flow:work session from last checkpoint. Reads flow-progress.txt to restore context and continue work.

2 0
Explore
Gitmaxd/flowfactory

rp-explorer

Token-efficient codebase exploration using RepoPrompt CLI. Use when user says "use rp to..." or "use repoprompt to..." followed by explore, find, understand, search, or similar actions.

2 0
Explore
Gitmaxd/flowfactory

flow-impl-review

John Carmack-level implementation review via rp-cli for current branch changes. Use when reviewing code changes, PRs, or implementations. Triggers on mentions of code review, implementation review, or PR review.

2 0
Explore
Gitmaxd/flowfactory

flow-plan

Create structured build plans from feature requests, bug reports, or Beads issue IDs. Use when planning features, designing implementation, preparing work breakdown, or when given a bead/issue ID to plan. Triggers on /flow:plan with text descriptions or issue IDs (e.g., bd-123, gno-45, app-12).

2 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results