[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75GG9V296PRRQ7QW3MTSX41":3,"skill-same:01M75GG9V296PRRQ7QW3MTSX41":55},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75GG9V296PRRQ7QW3MTSX41","team-composition-patterns",null,"Design optimal agent team compositions with sizing heuristics, preset configurations, and agent type selection. Use this skill when deciding how many agents to spawn for a task, when choosing between a review team versus a feature team versus a debug team, when selecting the correct subagent_type for each role to ensure agents have the tools they need, when configuring display modes (tmux, iTerm2, in-process) for a CI or local environment, or when building a custom team composition for a non-standard workflow such as a migration or security audit.","RudyCity\u002Fsuperagent","RudyCity","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F82188919?v=4","01M75FP5X8AW8ACBH0SH34WS7M","01M75FP5YAHJK8M1Q52BWXB82K",70,"MIT","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fteam-composition-patterns\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: team-composition-patterns\ndescription: Design optimal agent team compositions with sizing heuristics, preset configurations, and agent type selection. Use this skill when deciding how many agents to spawn for a task, when choosing between a review team versus a feature team versus a debug team, when selecting the correct subagent_type for each role to ensure agents have the tools they need, when configuring display modes (tmux, iTerm2, in-process) for a CI or local environment, or when building a custom team composition for a non-standard workflow such as a migration or security audit.\nversion: 1.0.2\n---\n\n# Team Composition Patterns\n\nBest practices for composing multi-agent teams, selecting team sizes, choosing agent types, and configuring display modes for Claude Code's Agent Teams feature.\n\n## When to Use This Skill\n\n- Deciding how many teammates to spawn for a task\n- Choosing between preset team configurations\n- Selecting the right agent type (subagent_type) for each role\n- Configuring teammate display modes (tmux, iTerm2, in-process)\n- Building custom team compositions for non-standard workflows\n\n## Team Sizing Heuristics\n\n| Complexity   | Team Size | When to Use                                                 |\n| ------------ | --------- | ----------------------------------------------------------- |\n| Simple       | 1-2       | Single-dimension review, isolated bug, small feature        |\n| Moderate     | 2-3       | Multi-file changes, 2-3 concerns, medium features           |\n| Complex      | 3-4       | Cross-cutting concerns, large features, deep debugging      |\n| Very Complex | 4-5       | Full-stack features, comprehensive reviews, systemic issues |\n\n**Rule of thumb**: Start with the smallest team that covers all required dimensions. Adding teammates increases coordination overhead.\n\n## Preset Team Compositions\n\n### Review Team\n\n- **Size**: 3 reviewers\n- **Agents**: 3x `team-reviewer`\n- **Default dimensions**: security, performance, architecture\n- **Use when**: Code changes need multi-dimensional quality assessment\n\n### Debug Team\n\n- **Size**: 3 investigators\n- **Agents**: 3x `team-debugger`\n- **Default hypotheses**: 3 competing hypotheses\n- **Use when**: Bug has multiple plausible root causes\n\n### Feature Team\n\n- **Size**: 3 (1 lead + 2 implementers)\n- **Agents**: 1x `team-lead` + 2x `team-implementer`\n- **Use when**: Feature can be decomposed into parallel work streams\n\n### Fullstack Team\n\n- **Size**: 4 (1 lead + 3 implementers)\n- **Agents**: 1x `team-lead` + 1x frontend `team-implementer` + 1x backend `team-implementer` + 1x test `team-implementer`\n- **Use when**: Feature spans frontend, backend, and test layers\n\n### Research Team\n\n- **Size**: 3 researchers\n- **Agents**: 3x `general-purpose`\n- **Default areas**: Each assigned a different research question, module, or topic\n- **Capabilities**: Codebase search (Grep, Glob, Read), web search (WebSearch, WebFetch)\n- **Use when**: Need to understand a codebase, research libraries, compare approaches, or gather information from code and web sources in parallel\n\n### Security Team\n\n- **Size**: 4 reviewers\n- **Agents**: 4x `team-reviewer`\n- **Default dimensions**: OWASP\u002Fvulnerabilities, auth\u002Faccess control, dependencies\u002Fsupply chain, secrets\u002Fconfiguration\n- **Use when**: Comprehensive security audit covering multiple attack surfaces\n\n### Migration Team\n\n- **Size**: 4 (1 lead + 2 implementers + 1 reviewer)\n- **Agents**: 1x `team-lead` + 2x `team-implementer` + 1x `team-reviewer`\n- **Use when**: Large codebase migration (framework upgrade, language port, API version bump) requiring parallel work with correctness verification\n\n## Agent Type Selection\n\nWhen spawning teammates with the `Agent` tool, choose `subagent_type` based on what tools the teammate needs:\n\n| Agent Type                     | Tools Available                                      | Use For                                                    |\n| ------------------------------ | ---------------------------------------------------- | ---------------------------------------------------------- |\n| `general-purpose`              | All tools (Read, Write, Edit, Bash, etc.)            | Implementation, debugging, any task requiring file changes |\n| `Explore`                      | Read-only tools (Read, Grep, Glob)                   | Research, code exploration, analysis                       |\n| `Plan`                         | Read-only tools                                      | Architecture planning, task decomposition                  |\n| `agent-teams:team-reviewer`    | Read\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Code review with structured findings               |\n| `agent-teams:team-debugger`    | Read\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Hypothesis-driven investigation                    |\n| `agent-teams:team-implementer` | Read\u002FWrite\u002FEdit\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Building features within file ownership boundaries |\n| `agent-teams:team-lead`        | Read\u002Fsearch\u002FBash plus Agent Teams coordination tools | Team orchestration and coordination                        |\n\n**Key distinction**: Read-only agents (Explore, Plan) cannot modify files. Never assign implementation tasks to read-only agents.\n\n## Display Mode Configuration\n\nConfigure in `~\u002F.claude\u002Fsettings.json`:\n\n```json\n{\n  \"teammateMode\": \"tmux\"\n}\n```\n\n| Mode           | Behavior                       | Best For                                          |\n| -------------- | ------------------------------ | ------------------------------------------------- |\n| `\"tmux\"`       | Each teammate in a tmux pane   | Development workflows, monitoring multiple agents |\n| `\"iterm2\"`     | Each teammate in an iTerm2 tab | macOS users who prefer iTerm2                     |\n| `\"in-process\"` | All teammates in same process  | Simple tasks, CI\u002FCD environments                  |\n\n## Custom Team Guidelines\n\nWhen building custom teams:\n\n1. **Every team needs a coordinator** — Either designate a `team-lead` or have the user coordinate directly\n2. **Match roles to agent types** — Use specialized agents (reviewer, debugger, implementer) when available\n3. **Avoid duplicate roles** — Two agents doing the same thing wastes resources\n4. **Define boundaries upfront** — Each teammate needs clear ownership of files or responsibilities\n5. **Keep it small** — 2-4 teammates is the sweet spot; 5+ requires significant coordination overhead\n\n## Troubleshooting\n\n**A teammate was spawned as `Explore` but needs to write files.**\n`Explore` and `Plan` are read-only agents. Change the `subagent_type` to `general-purpose` or an appropriate specialized agent type. Never assign implementation tasks to read-only agents.\n\n**The team is growing too large and coordination is slowing everything down.**\nEach additional teammate adds communication overhead. Consolidate roles: can one agent cover two dimensions? A 4-person team doing 6 independent tasks is usually better served by 3 agents covering 2 tasks each.\n\n**tmux mode is not showing panes.**\nEnsure tmux is installed and a session is already running before spawning teammates. The `in-process` mode works without tmux and is suitable for CI or scripted environments.\n\n**Two reviewers are flagging the same issues.**\nThe review dimensions overlap. Redefine each reviewer's focus area: one on correctness\u002Flogic, one on security, one on performance\u002Fscalability. Overlapping coverage wastes tokens and produces duplicate findings.\n\n**A `team-lead` is spawning teammates but they are not receiving tasks.**\nVerify that the lead is using the `Agent` tool to spawn teammates and passing complete context in the prompt. Teammates start fresh with no prior conversation history — they need all relevant information in their initial prompt.\n\n## Related Skills\n\n- [parallel-feature-development](..\u002Fparallel-feature-development\u002FSKILL.md) — Decompose work streams and assign file ownership once the team is composed\n- [team-communication-protocols](..\u002Fteam-communication-protocols\u002FSKILL.md) — Establish messaging norms and shutdown procedures for the assembled team\n","# Team Composition Patterns\n\nBest practices for composing multi-agent teams, selecting team sizes, choosing agent types, and configuring display modes for Claude Code's Agent Teams feature.\n\n## When to Use This Skill\n\n- Deciding how many teammates to spawn for a task\n- Choosing between preset team configurations\n- Selecting the right agent type (subagent_type) for each role\n- Configuring teammate display modes (tmux, iTerm2, in-process)\n- Building custom team compositions for non-standard workflows\n\n## Team Sizing Heuristics\n\n| Complexity   | Team Size | When to Use                                                 |\n| ------------ | --------- | ----------------------------------------------------------- |\n| Simple       | 1-2       | Single-dimension review, isolated bug, small feature        |\n| Moderate     | 2-3       | Multi-file changes, 2-3 concerns, medium features           |\n| Complex      | 3-4       | Cross-cutting concerns, large features, deep debugging      |\n| Very Complex | 4-5       | Full-stack features, comprehensive reviews, systemic issues |\n\n**Rule of thumb**: Start with the smallest team that covers all required dimensions. Adding teammates increases coordination overhead.\n\n## Preset Team Compositions\n\n### Review Team\n\n- **Size**: 3 reviewers\n- **Agents**: 3x `team-reviewer`\n- **Default dimensions**: security, performance, architecture\n- **Use when**: Code changes need multi-dimensional quality assessment\n\n### Debug Team\n\n- **Size**: 3 investigators\n- **Agents**: 3x `team-debugger`\n- **Default hypotheses**: 3 competing hypotheses\n- **Use when**: Bug has multiple plausible root causes\n\n### Feature Team\n\n- **Size**: 3 (1 lead + 2 implementers)\n- **Agents**: 1x `team-lead` + 2x `team-implementer`\n- **Use when**: Feature can be decomposed into parallel work streams\n\n### Fullstack Team\n\n- **Size**: 4 (1 lead + 3 implementers)\n- **Agents**: 1x `team-lead` + 1x frontend `team-implementer` + 1x backend `team-implementer` + 1x test `team-implementer`\n- **Use when**: Feature spans frontend, backend, and test layers\n\n### Research Team\n\n- **Size**: 3 researchers\n- **Agents**: 3x `general-purpose`\n- **Default areas**: Each assigned a different research question, module, or topic\n- **Capabilities**: Codebase search (Grep, Glob, Read), web search (WebSearch, WebFetch)\n- **Use when**: Need to understand a codebase, research libraries, compare approaches, or gather information from code and web sources in parallel\n\n### Security Team\n\n- **Size**: 4 reviewers\n- **Agents**: 4x `team-reviewer`\n- **Default dimensions**: OWASP\u002Fvulnerabilities, auth\u002Faccess control, dependencies\u002Fsupply chain, secrets\u002Fconfiguration\n- **Use when**: Comprehensive security audit covering multiple attack surfaces\n\n### Migration Team\n\n- **Size**: 4 (1 lead + 2 implementers + 1 reviewer)\n- **Agents**: 1x `team-lead` + 2x `team-implementer` + 1x `team-reviewer`\n- **Use when**: Large codebase migration (framework upgrade, language port, API version bump) requiring parallel work with correctness verification\n\n## Agent Type Selection\n\nWhen spawning teammates with the `Agent` tool, choose `subagent_type` based on what tools the teammate needs:\n\n| Agent Type                     | Tools Available                                      | Use For                                                    |\n| ------------------------------ | ---------------------------------------------------- | ---------------------------------------------------------- |\n| `general-purpose`              | All tools (Read, Write, Edit, Bash, etc.)            | Implementation, debugging, any task requiring file changes |\n| `Explore`                      | Read-only tools (Read, Grep, Glob)                   | Research, code exploration, analysis                       |\n| `Plan`                         | Read-only tools                                      | Architecture planning, task decomposition                  |\n| `agent-teams:team-reviewer`    | Read\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Code review with structured findings               |\n| `agent-teams:team-debugger`    | Read\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Hypothesis-driven investigation                    |\n| `agent-teams:team-implementer` | Read\u002FWrite\u002FEdit\u002Fsearch\u002FBash plus TaskList\u002FTaskGet\u002FTaskUpdate\u002FSendMessage | Building features within file ownership boundaries |\n| `agent-teams:team-lead`        | Read\u002Fsearch\u002FBash plus Agent Teams coordination tools | Team orchestration and coordination                        |\n\n**Key distinction**: Read-only agents (Explore, Plan) cannot modify files. Never assign implementation tasks to read-only agents.\n\n## Display Mode Configuration\n\nConfigure in `~\u002F.claude\u002Fsettings.json`:\n\n```json\n{\n  \"teammateMode\": \"tmux\"\n}\n```\n\n| Mode           | Behavior                       | Best For                                          |\n| -------------- | ------------------------------ | ------------------------------------------------- |\n| `\"tmux\"`       | Each teammate in a tmux pane   | Development workflows, monitoring multiple agents |\n| `\"iterm2\"`     | Each teammate in an iTerm2 tab | macOS users who prefer iTerm2                     |\n| `\"in-process\"` | All teammates in same process  | Simple tasks, CI\u002FCD environments                  |\n\n## Custom Team Guidelines\n\nWhen building custom teams:\n\n1. **Every team needs a coordinator** — Either designate a `team-lead` or have the user coordinate directly\n2. **Match roles to agent types** — Use specialized agents (reviewer, debugger, implementer) when available\n3. **Avoid duplicate roles** — Two agents doing the same thing wastes resources\n4. **Define boundaries upfront** — Each teammate needs clear ownership of files or responsibilities\n5. **Keep it small** — 2-4 teammates is the sweet spot; 5+ requires significant coordination overhead\n\n## Troubleshooting\n\n**A teammate was spawned as `Explore` but needs to write files.**\n`Explore` and `Plan` are read-only agents. Change the `subagent_type` to `general-purpose` or an appropriate specialized agent type. Never assign implementation tasks to read-only agents.\n\n**The team is growing too large and coordination is slowing everything down.**\nEach additional teammate adds communication overhead. Consolidate roles: can one agent cover two dimensions? A 4-person team doing 6 independent tasks is usually better served by 3 agents covering 2 tasks each.\n\n**tmux mode is not showing panes.**\nEnsure tmux is installed and a session is already running before spawning teammates. The `in-process` mode works without tmux and is suitable for CI or scripted environments.\n\n**Two reviewers are flagging the same issues.**\nThe review dimensions overlap. Redefine each reviewer's focus area: one on correctness\u002Flogic, one on security, one on performance\u002Fscalability. Overlapping coverage wastes tokens and produces duplicate findings.\n\n**A `team-lead` is spawning teammates but they are not receiving tasks.**\nVerify that the lead is using the `Agent` tool to spawn teammates and passing complete context in the prompt. Teammates start fresh with no prior conversation history — they need all relevant information in their initial prompt.\n\n## Related Skills\n\n- [parallel-feature-development](..\u002Fparallel-feature-development\u002FSKILL.md) — Decompose work streams and assign file ownership once the team is composed\n- [team-communication-protocols](..\u002Fteam-communication-protocols\u002FSKILL.md) — Establish messaging norms and shutdown procedures for the assembled team\n",{"name":5,"version":23,"description":7},"1.0.2","main","62c7af5ced2c21355d148c243edb6d5921cca1a6",".agents\u002Fskills\u002Fteam-composition-patterns",8,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent","https:\u002F\u002Fgithub.com\u002FRudyCity","2026-11-14 22:58:49",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add RudyCity\u002Fsuperagent --skill team-composition-patterns",{"tool":37,"command":38},"bunx","bunx skills add RudyCity\u002Fsuperagent --skill team-composition-patterns",{"tool":40,"command":41},"pnpm","pnpm dlx skills add RudyCity\u002Fsuperagent --skill team-composition-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fteam-composition-patterns\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fagent-type-selection.md","REFERENCE","参考文档",3546,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fteam-composition-patterns\u002Freferences\u002Fagent-type-selection.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fpreset-teams.md",9116,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fteam-composition-patterns\u002Freferences\u002Fpreset-teams.md",[56,63,70,77,84,91],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M75GP28CM6QCSXSHKFF3NNKS","telegram_bot","Use Telegram Bot when the user asks for Telegram Bot or this provider's API.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Ftelegram-bot\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75GNZGZYM7NWDV6MBP3HS14","superagent-bridge","Operate the Muse\u003C->superagent Telegram bridge: poll the private group for task_request\u002Ftask_result envelopes, validate senders, and reply with task_batch\u002Ftask_done as Muse (the remote brain).","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Fsuperagent-bridge\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M75GNHN19HJWZ7NAPM5E5JCV","Writing Skills","TDD for process documentation - test with subagents before writing, iterate until bulletproof","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M75GNCQEKVRA4FH161NZPZNB","writing-shape","Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-shape\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M75GNAF9NAYCSTBDZDGMK0DZ","Writing Plans","Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":18},"01M75GN72EV0V5NQAW9CSPFRFH","writing-guidelines","Review docs\u002Fprose for Writing Guidelines compliance. Use when asked to \"review my docs\", \"check writing style\", \"audit prose\", \"review docs voice and tone\", or \"check this page against the writing handbook\".","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-guidelines\u002FSKILL.md",[],[]]