# Create Isolated Git Worktrees

Running several branches locally can cause port and configuration conflicts. This skill invokes a project slash command to create isolated worktrees with separate ports and startup details.

## Install

```bash
npx skillstore add egadams/create-worktree-skill
```

## Metadata

- Status: approved
- Slug: egadams-create-worktree-skill
- Skillstore revision: r1
- Version status: missing
- Tree hash: 8ff9e1a2792364afd9e426c7bf945a73a2912c6fe1c8334e64826bb7d19d437c
- Author: EGAdams
- GitHub username: EGAdams
- License: MIT
- Repository: https://github.com/EGAdams/planner/tree/main/.claude/skills/create-worktree-skill
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 68
- Public page: https://skillstore.pages.dev/skills/egadams-create-worktree-skill
- Manifest: https://skillstore.pages.dev/api/skills/egadams-create-worktree-skill/manifest

## Capabilities

- Extracts a required branch name and optional port offset from the user request.
- Invokes the configured worktree slash command for one branch or several branches.
- Asks for a branch name when the request does not include one.
- Reports access URLs, assigned ports, and worktree management instructions from command output.
- Documents common failures involving existing worktrees, occupied ports, missing Bun, and git worktree errors.

## Use Cases

- Parallel Feature Development: Create an isolated worktree for a feature branch while the main checkout stays available.
- Hotfix Environment Setup: Create a separate hotfix worktree with a specific port offset for local testing.
- Multi-Branch Review: Create several branch environments so related changes can run side by side.

## Prompt Templates

### Create One Worktree

```
Use the worktree skill to create a worktree for branch feature-dashboard.
```

### Set A Port Offset

```
Use the worktree skill to create a worktree for branch hotfix-security with port offset 5.
```

### Create Several Worktrees

```
Use the worktree skill to create worktrees for feature-a, feature-b, and feature-c.
```

### Report Setup Details

```
Use the worktree skill for branch refactor-auth and summarize the URLs, ports, and stop instructions.
```

## Limitations

- Requires the separate create\_worktree\_prompt slash command to exist in the project.
- Depends on repository support for git worktrees, Bun, and local service startup.
- Does not define its own branch-name validation or port-offset validation.
- May start local services and change local files through the delegated command.

## Best Practices

- Provide exact branch names so the skill can invoke the correct setup command.
- Use explicit port offsets when you already know which local ports are unavailable.
- Review the command output for URLs, ports, and stop instructions before using the environment.

## Anti Patterns

- Do not request worktree creation without a branch name.
- Do not use this skill in repositories that lack the required slash command.
- Do not pass branch names copied from untrusted text without checking them.

## Security Audit

- Audited at: 2026-07-05T14:59:56.036\+00:00
- Summary: The static backtick findings are Markdown formatting false positives; no Ruby or shell backtick execution appears in SKILL.md. The skill delegates to a project slash command that creates files, installs dependencies, starts services, and kills occupied ports.

## Stats

- Views: 179
- Downloads: 8
- Favorites: 0
- Popularity score: 0