Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Agent Teams

Run several Claude Code sessions as a lead-plus-teammates crew with a shared task list, mailbox messaging, and file locks.

AutomationAdvanced★ 2,767⑂ 269AI score 8/10Last updated: Aug 3, 2026

What it does

A field guide to Claude Code's experimental agent teams mode:

  • How to enable it (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1): first session becomes the lead, later sessions in the same repo join as teammates
  • Shared task list, teammate-to-teammate mailbox messaging, and file-lock claiming to avoid edit conflicts
  • Team sizing table (2 / 3–5 / avoid >5) plus a 5–6 tasks-per-teammate granularity rule
  • Good vs bad task decomposition examples, dependency declaration, and a plan-approval loop before implementation
  • Shift+Tab delegate mode, Shift+Down teammate cycling, tmux/iTerm2 split-pane tips
  • TeammateIdle / TaskCreated / TaskCompleted hooks for notifications or auto integration tests
  • Decision table for teams vs subagents vs worktrees vs /batch, and an anti-pattern list

Who it's for

  • Intermediate-to-advanced Claude Code users who want multiple sessions working at once
  • Teams pushing cross-layer changes (API + UI + tests) in a single pass
  • Developers who hit context limits with subagents and need true parallelism

Examples

  1. Rate limiting feature: split into middleware, Redis config, tests, and API docs; assign to two teammates and set dependencies so tests/docs unblock when the middleware lands.
  2. Two-person loop: one session implements, the other reviews, while the lead stays in delegate mode approving plans.
  3. Routing decisions: use worktrees to compare competing approaches, /batch for 20+ file migrations, and a subagent for quick background exploration.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download 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 && mkdir -p ~/.claude/skills && cp -r pro-workflow/skills/agent-teams ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/rohitg00/pro-workflow.git
  2. Create the skills folder if needed: mkdir -p ~/.claude/skills
  3. Copy the skill in: cp -r pro-workflow/skills/agent-teams ~/.claude/skills/
  4. Turn on the experimental flag and start Claude Code: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 then claude
  5. Open another terminal (or tmux pane) in the same repo and run claude again — it joins as a teammate.
  6. From the lead session, try: "Using the agent-teams skill, break this work into 4 tasks and assign them."

Note: if your Claude Code build doesn't support the experimental flag, update to the latest version first.

View source on GitHub ↗