SkillAgentSearch skills...

agent-teams

Coordinate multiple Claude Code sessions as a team β€” lead + teammates with shared task lists, mailbox messaging, and file-lock claiming. Patterns for team sizing, task decomposition, and when to use teams vs sub-agents vs worktrees.

Install / Use

npx skills add rohitg00/pro-workflow --skill agent-teams

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

90/100

Supported Platforms

Claude Code

Tags

Our assessment of agent-teams

agent-teams scores 90/100 on our quality scale, 208th of 394 Communication skills we index.

Its SKILL.md is 5.2 KB long, well organised into 16 sections with 7 code examples: a solid amount of guidance for an agent.

With 2,876 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so agent-teams is actively maintained.
  • Our last check on 2026-10-30 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk β€” read a skill before letting an agent act on it.

agent-teams compared with similar skills

All 4 of these similar skills score higher than agent-teams; compare them before choosing.

SkillScoreStarsUpdatedFormat
agent-teams (this skill)by rohitg00902.9k53d agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install agent-teams?
Run npx skills add rohitg00/pro-workflow --skill agent-teams. The install tabs above show the steps for each supported agent.
Which AI agents does agent-teams work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is agent-teams safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is agent-teams still maintained?
The repository was last updated about 2 months ago, so agent-teams is actively maintained.

name: agent-teams description: Coordinate multiple Claude Code sessions as a team β€” lead + teammates with shared task lists, mailbox messaging, and file-lock claiming. Patterns for team sizing, task decomposition, and when to use teams vs sub-agents vs worktrees. user-invocable: true

Agent Teams

Coordinate multiple Claude Code sessions working on the same codebase simultaneously.

Enable

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude  # starts as team lead

The first session becomes the team lead. Subsequent sessions in the same repo join as teammates.

Architecture

Team Lead (coordinates, delegates, reviews)
  β”œβ”€β”€ Teammate 1 (owns task A, messages lead + peers)
  β”œβ”€β”€ Teammate 2 (owns task B, messages lead + peers)
  └── Teammate 3 (owns task C, messages lead + peers)
      β”‚
      └── Shared: task list + mailbox + file locks

Key difference from subagents: Teammates are full Claude Code sessions. They have their own context window, can use all tools, and message each other directly β€” not just report back to a parent.

Team Sizing

| Team Size | Best For | |-----------|----------| | 2 | One builds, one reviews | | 3-5 | Parallel features across layers (API, UI, tests) | | > 5 | Coordination overhead outweighs parallelism |

3-5 teammates is the productive range. Beyond that, the lead spends more time coordinating than the team saves.

Task granularity: Aim for 5-6 tasks per teammate. Fewer means underutilization; more means excessive context switching.

Display Modes

In-process navigation:

  • Shift+Down β€” cycle through teammates (wraps around)
  • See each teammate's current task and output

Split-pane (recommended for >2 teammates):

  • tmux: tmux split-window -h per teammate
  • iTerm2: Cmd+D for vertical split
  • Each pane runs its own claude session

Task Management

Tasks flow through states:

pending β†’ in-progress β†’ completed
              β”‚
              └── blocked (waiting on dependency)

Task Decomposition

Break work into units that:

  • Touch non-overlapping files
  • Can be verified independently
  • Have clear done criteria

Good decomposition:

Task 1: Add rate limiting middleware (src/middleware/rate-limit.ts)
Task 2: Add rate limit tests (tests/rate-limit.test.ts)
Task 3: Update API docs for rate limit headers (docs/api.md)
Task 4: Add Redis config for rate limit store (src/config/redis.ts)

Bad decomposition:

Task 1: Implement rate limiting
Task 2: Fix rate limiting bugs
Task 3: Improve rate limiting

Dependencies

Tasks can declare dependencies:

Task 3 (API docs) β†’ depends on Task 1 (middleware)
Task 2 (tests) β†’ depends on Task 1 (middleware)
Task 4 (Redis config) β†’ no dependencies

Teammates pick up unblocked tasks automatically.

File-Lock Claiming

Teammates claim files before editing to prevent conflicts:

  1. Teammate checks if file is locked
  2. If free, claims it (file-lock-based)
  3. Edits the file
  4. Releases lock on task completion

If two teammates need the same file, one waits or the lead reassigns.

Plan Approval

Teammates plan before implementing:

  1. Teammate receives task
  2. Writes a brief plan (files to change, approach)
  3. Lead reviews plan
  4. Lead approves or redirects
  5. Teammate implements

This prevents wasted work from misunderstood requirements.

Delegate Mode

Shift+Tab toggles delegate mode for the lead:

  • Lead coordinates only β€” no direct code edits
  • All implementation delegated to teammates
  • Lead reviews, approves plans, manages task flow

Hook Events

| Hook | Fires When | |------|------------| | TeammateIdle | A teammate finishes its task and has no pending work | | TaskCreated | New task added to the shared list | | TaskCompleted | A teammate marks a task done |

Use these to trigger notifications, auto-assign next tasks, or run integration tests when all tasks complete.

When to Use Teams vs Alternatives

| Scenario | Use | |----------|-----| | Parallel work on non-overlapping files | Agent teams | | Quick background exploration | Subagent | | Isolated feature branch work | Worktree (claude -w) | | Competing approaches to same problem | Worktrees (compare results) | | Cross-layer changes (API + UI + tests) | Agent teams | | One-off delegation | Subagent with isolation: worktree | | Large-scale migration (20+ files) | /batch command |

Anti-Patterns

  • More than 5 teammates β€” coordination overhead dominates
  • Tasks that share mutable state or the same files
  • Skipping plan approval β€” leads to rework
  • Lead doing implementation instead of coordinating (use delegate mode)
  • Not setting dependencies β€” teammates race on coupled tasks

Example Session

Lead: "We need rate limiting. Breaking into 4 tasks."

  Task 1: middleware implementation β†’ Teammate 1
  Task 2: Redis config β†’ Teammate 2 (no deps)
  Task 3: tests β†’ Teammate 1 (after Task 1)
  Task 4: API docs β†’ Teammate 2 (after Task 1)

Teammate 1 plans β†’ Lead approves β†’ implements Task 1
Teammate 2 plans β†’ Lead approves β†’ implements Task 2
Task 1 completes β†’ unblocks Tasks 3 and 4
Teammate 1 picks up Task 3, Teammate 2 picks up Task 4
All complete β†’ Lead runs integration tests β†’ commits

Docs

https://code.claude.com/docs/agent-teams

Related Skills

View on GitHub
GitHub Stars2.9k
CategoryCommunication
Updated1mo ago
Forks289

Languages

JavaScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

1 medium
agent-teams β€” Claude Code Skill: Install & Safety Check | SkillAgent