flow-next-worktree-kit

Manage git worktrees with create, list, switch, cleanup, and copy-env commands.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/raydocs/inktale --skill flow-next-worktree-kit-raydocs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-next-worktree-kit
Source: https://github.com/raydocs/inktale/tree/main/plugins/flow-next/skills/flow-next-worktree-kit
Command: npx skills add https://github.com/raydocs/inktale --skill flow-next-worktree-kit-raydocs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes scripts (resource) components.

What problem does it solve?

This skill helps teams manage git worktrees to enable parallel feature development and isolated review without disturbing the main workspace.

Core Features & Use Cases

  • Create, list, switch, cleanup, and copy-env for worktrees under a .worktrees directory to keep workflows isolated.
  • Safely manage worktrees with safety checks against symlinks and non-clean worktrees; avoids unintended deletions.
  • Copy environment files into new worktrees to preserve per-workspace configurations during feature development.

Quick Start

Create a new worktree named feature-x using the worktree.sh script.

Frequently Asked Questions about flow-next-worktree-kit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage git worktrees for parallel feature development without disturbing my main workspace?

You can manage git worktrees for parallel development by creating, listing, and switching isolated worktrees stored under a .worktrees directory, keeping your main workspace completely undisturbed during feature work.

What is the safest way to clean up git worktrees and avoid unintended deletions?

Safe git worktree cleanup uses built-in safety checks that prevent dangerous operations on symlink paths and block deletions on non-clean worktrees, ensuring you avoid unintended data loss during workspace removal.

Can I copy environment files into new git worktrees to preserve per-workspace configurations?

Yes, you can copy environment files into new git worktrees. The copy-env functionality preserves per-workspace configurations during feature development, ensuring isolated branches have the necessary local environment setup automatically.

Does git worktree management work with CI pipelines and multiple repository recovery workflows?

Git worktree management supports CI pipelines and multiple repository recovery workflows by enabling isolated review and parallel experimental branches across projects, ensuring safe workspace cleanups in automated environments.

Why should I use a dedicated script for git worktree creation instead of native commands?

Using a dedicated script for git worktree creation ensures worktrees are safely stored under .worktrees with safety checks against symlinks, while automatically copying environment files to preserve per-workspace configurations natively.

What are the limitations when using git worktrees with symlink paths?

When using git worktrees, limitations include safety checks that prevent dangerous operations on symlink paths and block cleanup on non-clean worktrees, protecting against unintended deletions but requiring manual resolution.