worktree
/worktree
Creates git worktrees for isolated development. Use when user wants to "create a worktree", "start a new feature branch", "work on a fix in isolation", or needs a parallel development environment.
- Author
- zipstack ↗
- Repository
- unstract ↗
- Licence
- AGPL-3.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: worktree-setup.sh
What it does and when to use it
Creates git worktrees for isolated development. Use when user wants to "create a worktree", "start a new feature branch", "work on a fix in isolation", or needs a parallel development environment.
Triggers from the description
Original author description
Creates git worktrees for isolated development. Use when user wants to "create a worktree", "start a new feature branch", "work on a fix in isolation", or needs a parallel development environment.
How it works
- Workflow
- Examples
- Reference
SKILL.md preview
---
name: worktree
description: Creates git worktrees for isolated development. Use when user wants to "create a worktree", "start a new feature branch", "work on a fix in isolation", or needs a parallel development environment.
---
# Git Worktree Skill
Create isolated worktrees for parallel development. Ends by providing commands to continue in the new worktree.
## Workflow
1. **Detect repo info**
```bash
REPO_NAME=$(basename -s .git $(git config --get remote.origin.url) 2>/dev/null || basename $(pwd))
SOURCE_REPO=$(git rev-parse --show-toplevel)
```
2. **Parse user description**
- Type: `fix` (bug, patch, fix) | `feat` (feature, add, implement) | `misc` (default)
- Branch: `{type}/{kebab-description}` (max 30 chars)
- Folder: `{type}-{kebab-description}`
- Path: `{SOURCE_REPO}/../{REPO_NAME}-worktrees/{folder}/`
- Version: `{kebab-description}` (for docker image tag)
3. **Create worktree**
```bash
git fetch origin main
mkdir -p "$(dirname "$WORKTREE_PATH")"
# --no-track: do NOT set the new branch's upstream to origin/main.
# Without it, a later `git push -u origin {branch}` can be reported by
# the server as also fast-forwarding main, landing commits on main.
git worktree add --no-track -b "{branch}" "$WORKTREE_PATH" origin/main
```
4. **Copy config files**
- **unstract repo:** Run `"$SOURCE_REPO/.claude/skills/worktree/worktree-setup.sh" "$WORKTREE_PATH" "$SOURCE_REPO"`
- **Other repos:** Ask user which config files to copy, then copy them
5. **Detect services from request** (unstract only)
Match keywords in user's request to services:
| Keywords | Services |
| ------------------------------ | -------------------------- |
| frontend, UI, react, component | frontend |
| backend, API, django | backend |
| platform, adapter, LLM | platform-service |
| prompt, studio | prompt-service |
| worker, celery, task | backend (includes workers) |
| x2text, extraction | x2text-service |
Default if unclear: `backend frontend`
6. **Print summary with commands**
```text
Worktree created!
Branch: {branch}
Path: {worktree_path}
─────────────────────────────────────────────────────────
Continue in new worktree and paste your prompt:
cd {worktree_path} && claude
{user_request_slightly_made_better_for_new_agent_to_understand}
─────────────────────────────────────────────────────────
Build & run services:
cd {worktree_path}/docker && \
VERSION={version} docker compose -f docker-compose.yaml -f compose.override.yaml build {services} && \
VERSION={version} docker compose -f docker-compose.yaml -f compose.override.yaml watch {services}
─────────────────────────────────────────────────────────
Cleanup later: git worktree remove {worktree_path}
```
IMPORTANT: Escape any quotes in `{user_request}` for shell safety.
## Examples
**User:** "worktree for fixing login validation in frontend"
- Branch: `fix/login-validation`
- Version: `login-validation`
- Services: `frontend`
**User:** "create worktree to add workflow export API"
- Branch: `feat/workflow-export-api`
- Version: `workflow-export-api`
- Services: `backend`
## Reference
```bash
git worktree list # List worktrees
git worktree remove {path} # Remove worktree
git worktree prune # Prune stale entries
```
Files in this package (2)
- SKILL.md 4 KB
- worktree-setup.sh 5 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · zipstack/unstract | 100 | AGPL-3.0 |
| vanducng/skills | 100 | MIT |
| tony/skills | 100 | MIT |
| zts212653/clowder-ai | 100 | MIT |
| duronext/jig | 100 | MIT |
| guangshinhaha/shinstack | 100 | MIT |
| PranamRDoshi/dotclaude | 100 | MIT |
| kronael/tools | 100 | Unlicense |
| rhesis-ai/rhesis | 100 | MIT |
Database snapshot: 13.11.2026 · package version a912f9274799 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95dev_manage_git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification. Triggers: worktree, git worktree, isolated workspace, feature branch… - 100worktree-open
Create or reopen a git worktree for parallel development. Use when user wants to "open a worktree", "spin up a branch", "work on X separately", "work on this in parallel", "start a parallel task", "isolated environment for an agent", "side branch without switching", or mentions… - 100ce-worktree
Set up isolated git worktrees — create a new branch for fresh work, or attach a worktree to an existing branch, PR, or commit. Use when starting isolated work or isolating an existing ref. - 90dev10x:git-worktree
Create git worktrees for clean workspace isolation. Offers two modes: native EnterWorktree (switches CWD in current session) or external worktree (IDE-isolated, requires restarting claude in new dir). TRIGGER when: starting feature work needing isolation, or executing… - 100creating-worktree
Creates isolated git worktrees in .claude/worktrees/ with intelligent branch naming, auto-incrementing, and commit type detection (feat/fix/refactor). Supports manual descriptions and auto-generation from uncommitted git changes. Use when user requests to create worktree, start… - 100worktree-manager
Create and manage Git worktrees for parallel development workflows. Use when multiple self-contained issues should NOT be fixed in a single branch, when human-Copilot iteration requires isolated environments with separate chat history and commits, or when parallel work items…