agent-teams

Orchestrate multiple Claude Code sessions for parallel agent tasks.

3|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/nsheaps/ai-mktpl --skill agent-teams-nsheaps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-teams
Source: https://github.com/nsheaps/ai-mktpl/tree/main/.ai/plugins/agent-teams-skills/skills/agent-teams
Command: npx skills add https://github.com/nsheaps/ai-mktpl --skill agent-teams-nsheaps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Agent teams simplify the complexity of running many coordinated Claude Code instances in parallel by providing spawn, communication, and lifecycle controls so leads can manage multiple independent agents without manual orchestration.

Core Features & Use Cases

  • Teammate spawning and display modes: Launch teammates in in-process or tmux-backed panes and persist or hide sessions as needed.
  • Messaging and task orchestration: Shared mailbox, direct peer messages, task lists with dependency tracking, and automatic unblocking.
  • Hook integrations and safety gates: TeammateIdle and TaskCompleted hooks enable script-based validations before idle transitions or task completions.
  • Use Case: Run parallel code reviews where each teammate independently inspects a different module and reports findings to the lead for consolidation.

Quick Start

Start an agent team to run three parallel reviewers on different modules and require plan approval before merging.

Frequently Asked Questions about agent-teams

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

FAQPage Schema
How do I run multiple Claude Code sessions in parallel for code review?

You orchestrate parallel Claude Code sessions by spawning multiple agents as teammates, where each independently inspects a different module and reports findings to a lead for consolidation. This multi-agent workflow handles concurrent task execution without manual coordination.

What is multi-agent orchestration and how does it manage task lifecycles?

Multi-agent orchestration coordinates independent agents executing separate tasks concurrently. It manages task lifecycles through shared mailboxes, direct peer messaging, dependency tracking, and automatic unblocking to ensure seamless parallel execution across all spawned agents.

Can I use tmux to display and manage parallel Claude Code agents?

Yes, you can launch teammates in tmux-backed panes to display and manage parallel Claude Code agents. You can also run them in-process, allowing you to persist or hide sessions as needed for flexible multi-agent workflow control.

How do hooks handle task completion and idle states in multi-agent workflows?

Hooks handle task completion and idle states by enabling script-based validations through TeammateIdle and TaskCompleted events. These safety gates ensure specific conditions are met before agents transition to idle or complete their assigned tasks.

Do I need environment variable propagation for spawned agents in Claude Code?

Environment variable propagation is automatically handled for spawned agents in Claude Code. This ensures all parallel teammates inherit the necessary configuration and context from the lead to execute their independent tasks concurrently and consistently.

What is the best way to coordinate independent agents executing modular testing?

The best way to coordinate independent agents for modular testing is using multi-agent orchestration with task dependency tracking and shared mailboxes. This ensures parallel test execution across separate modules with automatic unblocking and lead-managed consolidation.