New: Software for Agents, always up-to-date, delivered via MCP or web. Browse

    Guides
    claude-code
    agent-teams
    multi-agent

    Claude Code Agent Teams and Skills: Multi-Agent Workflows (2026)

    Agent Teams let you run multiple Claude Code agents in parallel. Skills make each one an expert.

    June 23, 20265 min read
    Share:

    Agent Teams is Claude Code's multi-agent feature. Instead of one agent doing everything, you spawn specialized sub-agents that work in parallel with shared task lists and direct messaging between them. Each agent gets its own context window, which means it doesn't get polluted by unrelated work.

    Skills make this powerful. Without skills, every sub-agent is a generalist. With skills, you can give the testing agent a testing skill, the security agent a security audit skill, and the documentation agent a documentation skill. Each one becomes a specialist.

    Quick Answer: Claude Code Agent Teams let you run parallel sub-agents with shared coordination. Install specialized SKILL.md skills to give each agent domain expertise. The claude agents command (v2.1.139+) provides a dashboard for managing all running agents.

    How Agent Teams work

    When you give Claude Code a complex task, it can decompose it into subtasks and spawn agents for each one. A manager agent coordinates. Worker agents execute. Each worker gets its own dedicated context window so it doesn't share context with unrelated tasks.

    The claude agents command shows a dashboard of all running, blocked, and completed sessions. You can see what each agent is doing and intervene if needed.

    Recommended skills

    Adding skills to Agent Teams

    Skills apply at the project or global level. Every sub-agent in your team inherits the skills you've installed. There's no way to assign specific skills to specific sub-agents (yet). But skill activation is keyword-based, so the testing agent naturally activates testing skills while the security agent naturally activates security skills.

    The practical setup:

    1. Install domain-specific skills in your project's .claude/skills/ directory
    2. Start a complex task that Claude Code will decompose
    3. Each sub-agent picks up relevant skills based on its assigned subtask
    4. The manager agent coordinates results

    Best skill combinations for Agent Teams

    Code generation + Code review. One agent writes, another reviews. The code review skill ensures the reviewer catches real issues, not just style nits.

    Implementation + Testing. One agent implements features, another writes tests. Each has a skill that matches its role.

    Coding + Security audit. The security agent runs after the coding agent finishes. A security skill ensures thorough vulnerability scanning.

    Frontend + Documentation. Build the feature and document it in parallel. Both agents finish faster than one agent doing both sequentially.

    Skills that work best in multi-agent setups

    Skills that define clear procedures are most effective because sub-agents work independently. Vague skills that say "write good code" don't help. Specific skills that say "always check for SQL injection in database queries, verify input sanitization, test with malformed input" give each agent concrete instructions.

    Browse multi-agent compatible skills at agensi.io/skills.


    Related: Claude Code Subagents Guide and Best Claude Code Skills 2026.

    Keep reading

    Frequently Asked Questions