Skills

Team Composition Patterns

Design optimal agent team compositions with sizing heuristics, preset configurations...

Install

npx skills add wshobson/agents --skill team-composition-patterns -g -a claude-code -y
Repository
wshobson/agents42.1k
Category
Design
Updated
5d ago
License
MIT
Context cost
Mediumabout 1,882 tokens
Runs scripts
No, instructions only

What it does

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.

Team Composition Patterns

Best practices for composing multi-agent teams, selecting team sizes, choosing agent types, and configuring display modes for Claude Code's Agent Teams feature.

When to Use This Skill

  • Deciding how many teammates to spawn for a task
  • Choosing between preset team configurations
  • Selecting the right agent type (subagent_type) for each role
  • Configuring teammate display modes (tmux, iTerm2, in-process)
  • Building custom team compositions for non-standard workflows

Team Sizing Heuristics

ComplexityTeam SizeWhen to Use
Simple1-2Single-dimension review, isolated bug, small feature
Moderate2-3Multi-file changes, 2-3 concerns, medium features
Complex3-4Cross-cutting concerns, large features, deep debugging
Very Complex4-5Full-stack features, comprehensive reviews, systemic issues

Rule of thumb: Start with the smallest team that covers all required dimensions. Adding teammates increases coordination overhead.

Preset Team Compositions

Review Team

  • Size: 3 reviewers
  • Agents: 3x team-reviewer
  • Default dimensions: security, performance, architecture
  • Use when: Code changes need multi-dimensional quality assessment

Debug Team

  • Size: 3 investigators
  • Agents: 3x team-debugger
  • Default hypotheses: 3 competing hypotheses
  • Use when: Bug has multiple plausible root causes

Feature Team

  • Size: 3 (1 lead + 2 implementers)
  • Agents: 1x team-lead + 2x team-implementer
  • Use when: Feature can be decomposed into parallel work streams

Fullstack Team

Read the whole SKILL.md on GitHub

More in Design