Agent Teams
A playbook for running multiple Claude Code sessions as a lead-plus-teammates team with shared tasks, messaging, and file locks.
Dev & CodingIntermediate★ 2,875⑂ 289AI score 9/10Last updated: Aug 31, 2026
What it does
- Turns several Claude Code sessions into one lead + multiple teammates working the same codebase in parallel.
- Explains the shared task list, mailbox messaging, and file-lock claiming that keep teammates from clobbering each other.
- Gives concrete sizing rules (2, 3–5, >5 teammates), task granularity targets (5–6 tasks per teammate), and good vs. bad decomposition examples.
- Covers display modes (
Shift+Down, tmux/iTerm2 split panes), delegate mode (Shift+Tab), and hooks: TeammateIdle, TaskCreated, TaskCompleted. - Includes a decision table for teams vs. subagents vs. worktrees vs.
/batch, plus an anti-pattern list.
Who it's for
- Developers splitting cross-layer work (API, UI, tests) that touches non-overlapping files.
- Anyone who has juggled several Claude terminals and hit duplicate or conflicting edits.
- Teams that want the lead to review and approve plans rather than write code.
Examples
- Break "add rate limiting" into 4 tasks (middleware, Redis config, tests, API docs) with dependencies and assign across 2 teammates.
- Two teammates need the same file — the lock makes one wait while the lead reassigns work.
- Fire integration tests automatically from a TaskCompleted hook once every task is done, then commit.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/rohitg00/pro-workflow/HEAD/skills/agent-teams/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/agent-teams folder from the GitHub repo rohitg00/pro-workflow into my ~/.claude/skills/agent-teams/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/rohitg00/pro-workflow.git /tmp/pro-workflow && mkdir -p ~/.claude/skills && cp -r /tmp/pro-workflow/skills/agent-teams ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Clone the repo:
git clone https://github.com/rohitg00/pro-workflow.git /tmp/pro-workflow - Make sure the skills directory exists:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r /tmp/pro-workflow/skills/agent-teams ~/.claude/skills/ - Enable the experimental feature:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1(add it to~/.zshrcor~/.bashrcto persist). - Run
claude— the first session becomes the team lead; launchclaudeagain in the same repo to join as a teammate. - Test it by asking: "Use the agent-teams skill to split this work across the team."