One-click install
npx skills add https://github.com/saw4405/splat-replay2 --skill worktree-setup-saw4405
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/saw4405/splat-replay2/tree/main/.codex/skills/worktree-setup
Command: npx skills add https://github.com/saw4405/splat-replay2 --skill worktree-setup-saw4405

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Proposes a branch name and creates a dedicated Git worktree for isolated development, ensuring separate contexts for new work without polluting the main branch.

Core Features & Use Cases

  • Branch name proposal and automatic worktree creation tailored for features, fixes, or investigations.
  • Base reference handling to derive or verify the starting point for the new worktree.
  • Optional initial setup script execution within the new worktree to bootstrap the environment.

Quick Start

Describe the task and I will propose a branch, create a dedicated worktree, and run the initial setup.

Frequently Asked Questions about worktree-setup

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

FAQPage Schema
How do I create a Git worktree for isolated feature development?

To create a Git worktree, this Skill proposes a branch name and sets up a dedicated worktree for isolated feature development, bug fixes, or investigations without polluting your main repository context.

What's the best way to manage separate Git workspaces for bug fixes and features?

Managing separate Git workspaces is best handled by creating dedicated worktrees, allowing you to isolate feature development or bug fixes from the main branch while verifying the base reference point.

When do I need an ephemeral Git workspace for my development workflow?

You need an ephemeral Git workspace when starting feature development, bug fixes, or investigative tasks that require strict separation from the main repository to avoid polluting your working directory.

Can I run an initial setup script automatically when creating a new Git worktree?

Yes, you can run an initial setup script automatically. The Skill optionally executes an initial setup script within the new worktree to bootstrap your development environment immediately after creation.

Does Git worktree creation handle base ref resolution if the branch does not exist?

Git worktree creation handles base ref resolution by ensuring the target branch exists or resolving the base reference before proceeding with the worktree setup using supported Git flags.