Git Worktree Isolation
jnMetaCode/superpowers-zh
Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.
Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.
Install Worktree
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AgentsMesh/AgentsMesh worktree --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/skills/worktree .claude/skills/worktree && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .claude/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktreeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AgentsMesh/AgentsMesh worktree --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agents/skills/worktree .agents/skills/worktree && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .agents/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AgentsMesh/AgentsMesh worktree --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agents/skills/worktree .cursor/skills/worktree && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .cursor/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AgentsMesh/AgentsMesh.git --path agents/skills/worktree--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AgentsMesh/AgentsMesh worktree --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agents/skills/worktree .gemini/skills/worktree && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .gemini/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AgentsMesh/AgentsMesh worktreeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .github/skills && cp -r skills-src/agents/skills/worktree .github/skills/worktree && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .github/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AgentsMesh/AgentsMesh --skill worktree -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AgentsMesh/AgentsMesh worktree --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AgentsMesh/AgentsMesh.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agents/skills/worktree .opencode/skills/worktree && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "worktree" agent skill from https://github.com/AgentsMesh/AgentsMesh/tree/main/agents/skills/worktree into .opencode/skills/worktree/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "worktree", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
worktree- GitHub stars
- 2.4k
- Token cost
- ~553 tokens
- SKILL.md length
- 209 words
- Files
- 2 (incl. references)
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.
- Works in 7 steps: Determine the requested branch name,… → Inspect repository state and identify… → Fetch the selected base → …
- The user asks for a new worktree
- SKILL.md covers Workflow and Result
- Calls git
What it does
Worktree is an agent skill from AgentsMesh/AgentsMesh. Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment. Use when the user asks for a new worktree or isolated work for a feature, fix, investigation, or review.
Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/dev-environment.md`).
It sits in Development, covering Git worktrees. It works with Git. The repository describes itself as: The AI Agent Workforce Platform. Run a hundred AI coding agents across your own machines — schedule, isolate, and steer them all from one console.
When your agent uses it
- The user asks for a new worktree
- Isolated work for a feature
Example prompts
- “Use the worktree skill to create or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and…”
- “/worktree”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Determine the requested branch name, base branch (default main), and
- Inspect repository state and identify the base remote from the user's request,
- Fetch the selected base
- Derive a filesystem-safe directory name by replacing / in the branch with
- Check whether the branch or path already exists. If the branch is new
- In the new worktree, verify
- Start the environment only when runtime verification is needed. Read
What it can do on your machine
Read from SKILL.md and the folder at commit d38e393. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Worktree loads about 553 tokens when it runs, and up to ~864 if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 209 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:59
oad and report the generated `deploy/dev/.env` values.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 209 words (~553 tokens).
“Create worktrees next to the main checkout under AgentsMesh-Worktrees.”
- name
- worktree
Files
SKILL.md and 1 other file (references) in agents/skills/worktree of AgentsMesh/AgentsMesh.
- SKILL.md
- references/dev-environment.md
Open the folder on GitHubat commit d38e393
Compare with similar skills
Worktree next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Worktree this skillAgentsMesh/AgentsMesh | 2.4k | — | ~553 | Automated safety check: Notes | Custom licence | |
| Git Worktree IsolationjnMetaCode/superpowers-zh | 8.3k | 1 repos | ~982 | Automated safety check: Pass | MIT | |
| Cursor Composer Task DelegateChachamaru127/claude-code-harness | 3.2k | — | ~4.4k | Automated safety check: Notes | MIT | |
| Git Worktree Setupk8zdev/k8z | 155 | — | ~930 | Automated safety check: Pass | None | |
| New Featuremichaelshimeles/skills | 1.3k | 1 repos | ~699 | Automated safety check: Pass | None | |
| Mori Agent Bridgevaayne/mori | 303 | — | ~1.7k | Automated safety check: Pass | MIT |
Similar skills
Cursor Composer Task Delegate
Chachamaru127/claude-code-harness
Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.
Git Worktree Setup
k8zdev/k8z
Automate git worktree creation and copy private files (not tracked in git) to new workdirs.
New Feature
michaelshimeles/skills
Start a new task in an isolated Git worktree branched from origin/main so multiple agents can work on the same repo in parallel without conflicts.
Mori Agent Bridge
vaayne/mori
Use Mori CLI to enable agent-to-agent communication and coordination across Mori-managed panes.
Git Worktrees
heyitsnoah/claudesidian
Work with git worktrees for isolated parallel development. An agent skill from heyitsnoah/claudesidian.
More from AgentsMesh/AgentsMesh
E2E
AgentsMesh/AgentsMesh
Selects and runs the appropriate AgentsMesh end-to-end suite for Web, Desktop, MCP, or iOS, including worktree-specific environment setup and browser-level verification.
Gh Merge
AgentsMesh/AgentsMesh
Completes the AgentsMesh GitHub pull-request workflow: commits scoped changes, rebases on the authoritative GitHub branch, opens or reuses a PR, monitors required checks, fixes failures, and merges…
GitHub GitLab Mirror
AgentsMesh/AgentsMesh
Audits or synchronizes the authoritative GitHub main branch to the internal GitLab mirror without importing GitLab-only history back into GitHub.
Arch Check
AgentsMesh/AgentsMesh
架构与实现审查 —— 基于「概念建模 → 职责划分 → 机制/策略分离 → 因果与不变量 → 属性建模 → 模块化 → SOLID → GRASP → YAGNI」的全维度审查，带置信度门控与假阳性抑制（对抗"过度工程建议"这类 AI slop）。触发于：要求 review/审查架构、检查目录结构/依赖关系/职责划分、重构前评估、技术债盘点、判断是否过度设计，或问「这个设计合理吗 / 该怎么拆…
Related
Works with
Categories
Questions about Worktree
What does Worktree do?
Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment. Worktree is an agent skill from AgentsMesh/AgentsMesh. Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.
When should I use Worktree?
Worktree fits situations like: the user asks for a new worktree; isolated work for a feature.
How do I install Worktree in Claude Code?
Run `npx skills add AgentsMesh/AgentsMesh --skill worktree -a claude-code`. Or copy the skill folder (agents/skills/worktree in AgentsMesh/AgentsMesh) into .claude/skills/worktree in your project. Claude Code loads it when a task matches its description.
How do I install Worktree in Codex?
Run `npx skills add AgentsMesh/AgentsMesh --skill worktree -a codex`. Or copy the skill folder (agents/skills/worktree in AgentsMesh/AgentsMesh) into .agents/skills/worktree in your project. Codex loads it when a task matches its description.
Can I use Worktree in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgentsMesh/AgentsMesh --skill worktree -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/worktree, .gemini/skills/worktree, .github/skills/worktree and .opencode/skills/worktree in your project.
What does Worktree need to run?
Going by SKILL.md and its folder, Worktree needs the command-line tools its instructions call (git).
Does Worktree access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Worktree safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Worktree use?
Worktree has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Worktree use?
About 553 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 311 tokens, read only when the agent opens those files.
What are the alternatives to Worktree?
Skills that share tags, products or a category with Worktree: Git Worktree Isolation (jnMetaCode/superpowers-zh, 8.3k stars), Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars), Git Worktree Setup (k8zdev/k8z, 155 stars) and New Feature (michaelshimeles/skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Worktree?
AgentsMesh (a GitHub organization) maintains it in AgentsMesh/AgentsMesh, which has 2,362 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 23, 2026.
Source: AgentsMesh/AgentsMesh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.