agent-team-prompting
Agent Team Prompting
Overview
Use this skill to write launch prompts for Claude Code 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.
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 Claude Code sessions | Ask Claude Code to create an agent team with teammates, task list, mailbox-style 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 Claude Code session |
Agent teams cost more tokens because each teammate is an independent Claude instance. State that tradeoff briefly when the user is choosing between approaches.
Prompt Assembly Checklist
More from l-yifan/skills
scientific-figure-pro
Generate publication-ready scientific figures in Python/matplotlib with a consistent figures4papers house style. Use when creating or refining academic bar/trend/heatmap/scatter/multi-panel figures, enforcing visual consistency, or exporting paper-ready PNG/PDF/SVG outputs.
39figures4papers-playbook
Locate and adapt real plotting examples from the figures4papers repository. Use when users ask for a figure in the style of specific papers/projects, want the closest existing script template, or need fast script selection by chart type/domain before customization.
33deep-wiki
Access AI-generated documentation and insights for GitHub repositories via DeepWiki. This skill should be used when exploring unfamiliar codebases, understanding repository architecture, finding implementation patterns, or asking questions about how a GitHub project works. Supports any public GitHub repository.
25gkg
Global Knowledge Graph for codebase analysis. This skill should be used when searching for code definitions (functions, classes, methods), finding references to symbols, understanding code structure, analyzing import usage, generating repository maps, or performing impact analysis before refactoring. Supports TypeScript, JavaScript, Python, Java, and more.
21gh-grep
Search real-world code examples across millions of GitHub repositories using grep.app. This skill should be used when looking for implementation patterns, API usage examples, library integration patterns, or production code references. Supports literal code search, regex patterns, and filtering by language/repo/path.
18github
Interact with GitHub repositories, issues, pull requests, and code via the GitHub MCP server. This skill should be used when managing repositories, creating/updating files, working with issues and PRs, searching code/repos/users, creating branches, and performing code reviews. Supports all major GitHub API operations.
16