npx skills add smithery/treytucker05 --skill agent-worktrees
tjcages/agent-worktrees-skill · Archived
agent-worktrees
>- Isolate parallel AI agents on one git repo via branch+worktree, shared env symlinks, auto-ported previews, status lines, claims, and a land-from-main ritual. Use when ≥2 agents will touch this or any repo, the user asks to set up worktrees / parallel agents / agent isolation, or an agent is about to share a working tree with another. NOT for ordinary single-agent work on main.
Installation
npx skills add tjcages/agent-worktrees-skill --skill agent-worktrees
Stronger alternatives
This repository is archived — consider an actively maintained alternative.
Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…
810.4K installsProvision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agen…
288.9K installsAutonomous multi-page extraction into structured JSON. Use when the user wants website data mat…
79K installsBuild, debug, or review Cloudflare Agents SDK applications using the agents package.
63.9K installsSimilar popular skills
Related neighbors and high-traction skills in the same topics — useful to compare before installing.
Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…
3.3M installsReview UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…
617.3K installsBuild, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …
576.5K installsPrepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…
568.3K installsConfigure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…
566.3K installsMore details
Agent compatibility
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Also listed on
Alternate registries and mirrors of this skill.
Repository health
main
Skill metadata
Parsed from SKILL.md frontmatter.
More metadata
- internal
- 1
Package contents
Files included with this skill beyond the listing page.
-
skill md
SKILL.md2,086 B -
docs
SUMMARY.md404 B
History
- First seen on skills.sh
- First recorded snapshot · 1 installs
SKILL.md
Agent worktrees
Chat: [RESPONSE.md](./RESPONSE.md). Full method: [METHODOLOGY.md](./METHODOLOGY.md).
Operating order
1. Should we isolate? (§1)
≥2 agents on this repo → yes. User/product says share → obey. Overlapping structural files → serialize even with worktrees.
2. Already isolated?
If you're already in a worktree (common dir ≠ toplevel of a single checkout) and a branch exists for this task → skip create; run setup if share links missing.
3. Create branch + worktree (§2.1)
Off main. Prefer Linear branch name when tracked. Don't double-create Claude Code's claude/<name> trees.
4. Share env (§2.2)
bash scripts/worktree.sh setup
Symlink, never copy. Configure share list for this stack (see METHODOLOGY §2.2 table).
5. Preview + claim + status (§2.3–2.5)
Own auto-ported server. Declare <branch> · <task>. End every message with:
🔌 <branch> · <one-line task> · <preview URL>
6. Land + teardown (§2.6–2.7)
bash scripts/worktree.sh land <branch>
git push origin main
bash scripts/worktree.sh teardown ../<repo>-<slug> <branch>
Clear the claim. Stop the preview before teardown.
7. Done check (§6)
Rubric ≥10/12, no zeros.
Install into a repo
See METHODOLOGY §4. Prefer existing repo scripts/worktree.sh; else copy from this pack. Optional worktree.share. Write the six-step protocol into agent instructions; smoke-test once.
Out of scope
Single-agent main-tree work. Schema-migration strategy beyond "serialize on shared DB." Idle-time autopull (sibling concern).