agent-teams-doc

Coordinate Claude Code sessions into managed agent teams for parallel work and shared tasks.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/hlibkoval/claudemd --skill agent-teams-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-teams-doc
Source: https://github.com/hlibkoval/claudemd/tree/main/skills/agent-teams-doc
Command: npx skills add https://github.com/hlibkoval/claudemd --skill agent-teams-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Coordinating multiple Claude Code sessions to work together on a project is complex without built-in orchestration. This Skill provides official documentation for agent teams, enabling parallel exploration, shared task management, secure inter-agent communication, and lifecycle controls.

Core Features & Use Cases

  • Official guidance on enabling agent teams, starting and structuring teams, and choosing display modes.
  • Best practices for task assignment, inter-teammate communication, and hooks to enforce quality gates.
  • Coverage of architecture, storage, subagent references, and permissions to manage complex collaborations.

Quick Start

Spawn a team with three teammates and a lead to tackle a complex debugging task in parallel.

Frequently Asked Questions about agent-teams-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple Claude Code sessions to work in parallel?

To coordinate parallel Claude Code sessions, you can use a managed agent team with a lead to spawn teammates, a shared task list, and a mailbox for secure inter-agent communication. This enables parallel code reviews and cross-layer coordination.

What is an agent team in Claude Code used for?

An agent team in Claude Code is used to parallelize work across multiple sessions. It is best suited for tasks that benefit from collaboration, such as architecture planning, debugging with competing hypotheses, and cross-layer coordination.

Do I need a specific Claude Code version to run agent teams?

Yes, running agent teams requires Claude Code v2.1.32 or later. You also need a running lead to spawn teammates, a shared task list, and local storage allocated under ~/.claude/teams and ~/.claude/tasks.

How do I manage task assignment and communication between Claude Code teammates?

You manage Claude Code teammates using a shared task list and mailbox for inter-agent communication. Best practices include using hooks to enforce quality gates and configuring permissions to manage complex collaborations securely.

What are the display modes for Claude Code agent teams?

Claude Code agent teams support in-process and split-pane display modes. These modes allow you to visually monitor parallel work and shared results across multiple teammates within your development environment.

When should I avoid using agent teams for parallel work?

You should avoid using agent teams for tasks that do not benefit from collaboration or parallel execution. If your task does not require cross-layer coordination or competing hypotheses, the overhead of managing a shared task list and multiple sessions may be unnecessary.