Build Px4 macOS
PX4/PX4-Autopilot
Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.
Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove).
Install Worktree
$ npx skills add shibing624/agentica --skill worktree -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install shibing624/agentica 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/shibing624/agentica.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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 shibing624/agentica --skill worktree -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install shibing624/agentica worktree --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shibing624/agentica.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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 shibing624/agentica --skill worktree -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install shibing624/agentica worktree --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shibing624/agentica.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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/shibing624/agentica.git --path agentica/skills/bundled/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 shibing624/agentica --skill worktree -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install shibing624/agentica worktree --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shibing624/agentica.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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 shibing624/agentica 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 shibing624/agentica --skill worktree -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/shibing624/agentica.git skills-src && mkdir -p .github/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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 shibing624/agentica --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 shibing624/agentica worktree --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shibing624/agentica.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agentica/skills/bundled/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/shibing624/agentica/tree/main/agentica/skills/bundled/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
- 352
- Token cost
- ~614 tokens
- SKILL.md length
- 314 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove).
- Another live session is dirty in the same directory (listagents)
- SKILL.md covers When and How
- Calls git
- Two agents would fight over index.lock
What it does
Worktree is an agent skill from shibing624/agentica. Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove). Use when another live session is dirty in the same directory (listagents), when two agents would fight over index.lock, or when starting a parallel task checkout.
Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Git worktrees. It works with Git. The repository describes itself as: One person, a team of agents. Multi-session CLI that collaborates across terminals; /goal keeps long tasks running; WeChat/WeCom/Feishu gateway lets you call them back when you… The licence is Apache-2.0.
When your agent uses it
- Another live session is dirty in the same directory (listagents)
- Two agents would fight over index.lock
- Starting a parallel task checkout
Example prompts
- “/worktree”
What it can do on your machine
Read from SKILL.md and the folder at commit e84fc48. 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 614 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 314 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 passed
The automated check found no risky patterns in SKILL.md.
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
The full file from shibing624/agentica at commit e84fc48, republished under its Apache-2.0 licence (© shibing624). 314 words, ~614 tokens.
Download SKILL.mdSave it as
.claude/skills/worktree/SKILL.md (or your agent's skills folder).- name
- worktree
- description
- Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove). Use when another live session is dirty in the same directory (list_agents), when two agents would fight over index.lock, or when starting a parallel task checkout.
- metadata.version
- 2.1
Isolate work in a worktree
Several sessions in one checkout overwrite each other and contend for git's index. A worktree is one directory + one branch per task, sharing the repository.
This session does not move. worktree(action="new") returns a path.
Pass that path as work_dir on read_file / write_file / apply_patch /
execute. On glob / grep, pass it as path. Omit those arguments and
the call stays in this session's directory.
Do not cd and expect later calls to follow — each call is independent.
Do not execute git worktree add: that only makes a directory, and later
calls still use this session unless you pass work_dir / path. Use
worktree(action="new").
When
list_agentsshows another session in this directory (dirty files, same branch) and you are about to edit.- A change should not land on the shared working tree.
Not this: a read-only task subagent (it does not write). A second CLI
that should start already inside a tree is agentica --worktree <task>.
How
Name the task, not yourself. Reused while the checkout is healthy; gone after merge. A registration that is no longer a checkout is refused — remove it first, or pick another name. The tool does not delete leftover files to make room.
worktree(action="new", name="<task>")— create or reuse; returns the pathworktree(action="status")— every worktree of this repoworktree(action="merge", name="<task>")— land on local main (conflicts stay in that worktree, then fast-forward on main), delete the checkoutworktree(action="remove", name="<task>")— drop awt/*checkout git will allow (dirty is refused; an unmerged branch is left in place)
new(name="main") is refused: main is the repository root, not a task.
For a chunk of work big enough for its own process, delegate(task=..., work_dir=<path>) already takes the same path.
If a directory goes missing, status labels it (directory gone) or
(not a checkout). Say so; do not rebuild it by destroying what sits there.
remove the name, then new if you still want it.
© shibing624, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in agentica/skills/bundled/worktree of shibing624/agentica.
Open the folder on GitHubat commit e84fc48
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 skillshibing624/agentica | 352 | — | ~614 | Automated safety check: Pass | Apache-2.0 | |
| Build Px4 macOSPX4/PX4-Autopilot | 13k | — | ~1.1k | Automated safety check: Pass | BSD-3-Clause | |
| WorktreeAgentsMesh/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 |
Similar skills
Worktree
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.
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.
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.
More from shibing624/agentica
Multi Agent
shibing624/agentica
Run work across more than one agent — choose between the task subagent, the delegate tool, and a second agentica CLI in tmux driven by peer messages (listagents / sendmessage).
Agentica
shibing624/agentica
How to answer questions about the agentica product you are running inside — CLI flags, config.yaml profiles, API keys, models, sessions, resume, workspace, AGENTS.md standing rules, skills, logs…
Cron
shibing624/agentica
Schedule, list, pause, resume, edit, or run the user's agentica cron jobs with the cronjob tool.
Related
Works with
Categories
Questions about Worktree
What does Worktree do?
Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove). Worktree is an agent skill from shibing624/agentica. Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove).
When should I use Worktree?
Worktree fits situations like: another live session is dirty in the same directory (listagents); two agents would fight over index.lock; starting a parallel task checkout.
How do I install Worktree in Claude Code?
Run `npx skills add shibing624/agentica --skill worktree -a claude-code`. Or copy the skill folder (agentica/skills/bundled/worktree in shibing624/agentica) 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 shibing624/agentica --skill worktree -a codex`. Or copy the skill folder (agentica/skills/bundled/worktree in shibing624/agentica) 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 shibing624/agentica --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 no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Worktree use?
Worktree is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Worktree use?
About 614 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Worktree?
Skills that share tags, products or a category with Worktree: Build Px4 macOS (PX4/PX4-Autopilot, 13k stars), Worktree (AgentsMesh/AgentsMesh, 2.4k stars), Git Worktree Isolation (jnMetaCode/superpowers-zh, 8.3k stars) and Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Worktree?
shibing624 (a GitHub user) maintains it in shibing624/agentica, which has 352 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 23, 2026.
Source: shibing624/agentica on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.