agent-team-prompting
Installation
SKILL.md
Agent Team Prompting
Overview
Use this skill to write launch prompts for AI agent teams. A good agent-team prompt does more than split work: it defines why a team is needed, how teammates coordinate through shared tasks and messages, what each teammate owns, where collaboration is required, and when the team lead should wait, summarize, approve, or clean up. Keep platform-specific setup separate from the core prompt so the same workflow can be adapted to different agent runtimes, orchestration tools, and interfaces.
Agent Teams vs Subagents
Use this decision before writing the prompt.
| Use this | When | Prompt implication |
|---|---|---|
| Agent team | The work needs debate, coordination, shared task ownership, direct teammate communication, or long-running independent agent sessions | Ask the orchestrator to create an agent team with teammates, a shared task list, direct communication, and a lead summary |
| Subagents | Only the final result matters and workers do not need to talk to each other | Ask for subagents or parallel agents instead; do not force agent teams |
| Single agent | The task is small, sequential, or file-conflict-prone | Keep the prompt focused on one agent session |
Agent teams cost more tokens and coordination overhead because each teammate is an independent agent session. State that tradeoff briefly when the user is choosing between approaches.