Skip to content
Skills Library
Programming · Building & coding

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.

Repository
unstract ↗
Licence
AGPL-3.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What to check before installing
  • 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

create a worktreestart a new feature branchwork on a fix in isolation
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

  1. Workflow
  2. Examples
  3. Reference
Original SKILL.md headings · 96 lines, 364 words
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

RepositoryScoreLicence
This page · zipstack/unstract100AGPL-3.0
vanducng/skills100MIT
tony/skills100MIT
zts212653/clowder-ai100MIT
duronext/jig100MIT
guangshinhaha/shinstack100MIT
PranamRDoshi/dotclaude100MIT
kronael/tools100Unlicense
rhesis-ai/rhesis100MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.