Agent Team Builder

Составляйте и запускайте параллельные группы агентов с помощью навыка Team Builder для Claude Code. Организуйте персоны по доменам и получайте синтезированную многогентную обратную связь.

Совместная работа ★ 172,008 GitHub (172,008 ★)

Навык Team Builder превращает Claude Code в сложный оркестратор агентов, позволяя пользователям просматривать, выбирать и разворачивать команды специализированных персонажей из локальных или глобальных коллекций. Организуя агентов в доменные группы, такие как Engineering, Marketing или Security, навык дает возможность быстро собирать ad-hoc команды для ревью высокого уровня и решения сложных задач. Навык управляет полным жизненным циклом мультиагентной задачи: обнаруживает доступных агентов через CLI и файловую систему, предоставляет интерактивное меню выбора, запускает до пяти агентов одновременно и синтезирует их разносторонние результаты в единый отчет, выделяя как согласованные выводы, так и противоречивые рекомендации.

Ключевые особенности

01Поддержка гибкой структуры организации, включая поддиректории и префиксы имен файлов.

02Динамическое обнаружение агентов через CLI 'claude agents' и локальные markdown-файлы.

03Интерактивное меню выбора агентов на основе доменов для создания команды по запросу.

04172 008 звезд на GitHub

05Параллельное выполнение подагентов для быстрой многопрофильной обратной связи по одной задаче.

06Автоматический синтез результатов, выявляющий консенсус, противоречия и рекомендуемые дальнейшие шаги.

Варианты использования

01Написание технической документации с одновременной валидацией через агентов TDD и Documentation.

02Ревью PR с новыми функциями через комбинированный подход UX Design, QA Testing и Performance Engineering.

03Выполнение комплексного аудита сайта с участием агентов Security, SEO и Software Architecture.

name	team-builder
description	Interactive agent picker for composing and dispatching parallel teams
origin	community

Team Builder

Interactive menu for browsing and composing agent teams on demand. Works with flat or domain-subdirectory agent collections.

When to Use

You have multiple agent personas (markdown files) and want to pick which ones to use for a task
You want to compose an ad-hoc team from different domains (e.g., Security + SEO + Architecture)
You want to browse what agents are available before deciding

Prerequisites

Agent files must be markdown files containing a persona prompt (identity, rules, workflow, deliverables). The first # Heading is used as the agent name and the first paragraph as the description.

Both flat and subdirectory layouts are supported:

Subdirectory layout — domain is inferred from the folder name:

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

Flat layout — domain inferred from shared filename prefixes. A prefix counts as a domain when 2+ files share it. Files with unique prefixes go to "General". Note: the algorithm splits at the first -, so multi-word domains (e.g., product-management) should use the subdirectory layout instead:

agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md

Configuration

Agents are discovered via two methods, merged and deduplicated by agent name:

claude agents command (primary) — run claude agents to get all agents known to the CLI, including user agents, plugin agents (e.g. everything-claude-code:architect), and built-in agents. This automatically covers ECC marketplace installs without any path configuration.
File glob (fallback, for reading agent content) — agent markdown files are read from:
- ./agents/**/*.md + ./agents/*.md — project-local agents
- ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — global user agents

Earlier sources take precedence when names collide: user agents > plugin agents > built-in agents. A custom path can be used instead if the user specifies one.

How It Works

Step 1: Discover Available Agents

Run claude agents to get the full agent list. Parse each line:

Plugin agents are prefixed with plugin-name: (e.g., everything-claude-code:security-reviewer). Use the part after : as the agent name and the plugin name as the domain.
User agents have no prefix. Read the corresponding markdown file from ~/.claude/agents/ or ./agents/ to extract the name and description.
Built-in agents (e.g., Explore, Plan) are skipped unless the user explicitly asks to include them.

For user agents loaded from markdown files:

Subdirectory layout: extract the domain from the parent folder name
Flat layout: collect all filename prefixes (text before the first -). A prefix qualifies as a domain only if it appears in 2 or more filenames (e.g., engineering-security-engineer.md and engineering-software-architect.md both start with engineering → Engineering domain). Files with unique prefixes (e.g., code-reviewer.md, tdd-guide.md) are grouped under "General"
Extract the agent name from the first # Heading. If no heading is found, derive the name from the filename (strip .md, replace hyphens with spaces, title-case)
Extract a one-line summary from the first paragraph after the heading

If no agents are found after running claude agents and probing file locations, inform the user: "No agents found. Run claude agents to verify your setup." Then stop.

Step 2: Present Domain Menu

Available agent domains:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Pick domains or name specific agents (e.g., "1,3" or "security + seo"):

Skip domains with zero agents (empty directories)
Show agent count per domain

Step 3: Handle Selection

Accept flexible input:

Numbers: "1,3" selects all agents from Engineering and Sales
Names: "security + seo" fuzzy-matches against discovered agents
"all from engineering" selects every agent in that domain

If more than 5 agents are selected, list them alphabetically and ask the user to narrow down: "You selected N agents (max 5). Pick which to keep, or say 'first 5' to use the first five alphabetically."

Confirm selection:

Selected: Security Engineer + SEO Specialist
What should they work on? (describe the task):

Step 4: Spawn Agents in Parallel

Read each selected agent's markdown file
Prompt for the task description if not already provided
Spawn all agents in parallel using the Agent tool:
- subagent_type: "general-purpose"
- prompt: "{agent file content}\n\nTask: {task description}"
- Each agent runs independently — no inter-agent communication needed
If an agent fails (error, timeout, or empty output), note the failure inline (e.g., "Security Engineer: failed — [reason]") and continue with results from agents that succeeded

Step 5: Synthesize Results

Collect all outputs and present a unified report:

Results grouped by agent
Synthesis section highlighting:
- Agreements across agents
- Conflicts or tensions between recommendations
- Recommended next steps

If only 1 agent was selected, skip synthesis and present the output directly.

Rules

Dynamic discovery only. Never hardcode agent lists. New files in the directory auto-appear in the menu.
Max 5 agents per team. More than 5 produces diminishing returns and excessive token usage. Enforce at selection time.
Parallel dispatch. All agents run simultaneously — use the Agent tool's parallel invocation pattern.
Parallel Agent calls, not TeamCreate. This skill uses parallel Agent tool calls for independent work. TeamCreate (a Claude Code tool for multi-agent dialogue) is only needed when agents must debate or respond to each other.

Examples

User: team builder

Claude:
Available agent domains:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer
4. Support (1) — Executive Summary

Pick domains or name specific agents:

User: security + seo

Claude:
Selected: Security Engineer + SEO Specialist
What should they work on?

User: Review my Next.js e-commerce site before launch

[Both agents spawn in parallel, each applying their specialty to the codebase]

Claude:
## Security Engineer Findings
- [findings...]

## SEO Specialist Findings
- [findings...]

## Synthesis
Both agents agree on: [...]
Tension: Security recommends CSP that blocks inline styles, SEO needs inline schema markup. Resolution: [...]
Next steps: [...]

📋 Что это

Agent Team Builder — это интерактивный навык для Claude Code, который позволяет просматривать доступные агенты-персоны и собирать из них ad-hoc команды для параллельного выполнения задач. Вместо того чтобы выбирать агентов вручную или полагаться на жёстко заданные списки, ты запускаешь меню, выбираешь домены (например, Engineering, Marketing) или конкретных агентов, описываешь задачу, и навык запускает всех выбранных агентов одновременно, а затем собирает их ответы в единый отчёт с синтезом.

Навык подходит для ситуаций, когда у тебя есть несколько файлов-агентов (Markdown с описанием персоны) и ты хочешь применить к одной задаче экспертизу из разных областей — например, одновременно получить рекомендации от Security Engineer, SEO Specialist и Software Architect.

⚙️ Как работает

🧠 Обнаружение агентов

Навык использует два источника, объединённых и дедуплицированных по имени агента:

Команда claude agents — основной способ получить список всех агентов, известных CLI: пользовательские, плагинные (например, everything-claude-code:architect) и встроенные. Это автоматически покрывает установки из ECC marketplace.
Glob файлов — читает Markdown-файлы из ./agents/**/*.md, ./agents/*.md (проектные) и ~/.claude/agents/**/*.md, ~/.claude/agents/*.md (глобальные).

При конфликте имён приоритет: пользовательские агенты > плагинные > встроенные.

🏷️ Извлечение имени и описания из файлов

Из первого # Заголовок берётся имя агента. Если заголовка нет — имя выводится из имени файла (убирается .md, дефисы заменяются пробелами, регистр заголовка). Первый абзац после заголовка становится кратким описанием (одна строка).

📂 Определение домена

Поддерживаются две структуры файлов:

Поддиректории — имя папки становится доменом: agents/engineering/security-engineer.md → Engineering.
Плоская структура — домен определяется по общему префиксу имени файла до первого дефиса (engineering-security-engineer.md, engineering-software-architect.md → Engineering). Префикс считается доменом, если его имеют 2 и более файлов. Уникальные префиксы попадают в группу «General».

Если после всех проверок агенты не найдены, навык сообщает: «No agents found. Run claude agents to verify your setup.» и завершается.

📍 Меню и выбор

Навык показывает домены с количеством агентов и предлагает выбрать:

по номерам: 1,3 — взять всех агентов из Engineering и Sales.
по именам: security + seo — нечёткое сопоставление с известными агентами.
по домену: all from engineering — все агенты указанного домена.

Если выбрано больше 5 агентов, навык просит сократить список (или сказать first 5 для выбора первых пяти по алфавиту).

После подтверждения пользователь описывает задачу, и навык переходит к выполнению.

🚀 Параллельный запуск и сборка отчёта

Для каждого выбранного агента навык:

Читает содержимое его Markdown-файла.
Запрашивает описание задачи, если его ещё нет.
Запускает всех агентов параллельно с помощью инструмента Agent в режиме general-purpose, передавая каждому: prompt: "{содержимое файла агента}\n\nTask: {описание задачи}".

Если какой-то агент завершился ошибкой, таймаутом или пустым выводом, навык отмечает это в отчёте (например, «Security Engineer: failed — [причина]») и продолжает с успешными результатами.

После завершения всех агентов формируется отчёт:

Результаты, сгруппированные по агентам.
Секция «Synthesis» с:
- Согласованными выводами
- Конфликтами / расхождениями
- Рекомендованными следующими шагами

Если был выбран только 1 агент, синтез пропускается.

📜 Пример работы

User: team builder
Claude:
Available agent domains:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer

Pick domains or name specific agents:

User: security + seo
Claude:
Selected: Security Engineer + SEO Specialist
What should they work on?

User: Review my Next.js e-commerce site before launch

[Оба агента запускаются параллельно]

Claude:
## Security Engineer Findings
[...]
## SEO Specialist Findings
[...]
## Synthesis
Both agents agree on: [...]
Tension: Security recommends CSP... SEO needs inline schema...
Next steps: [...]

📌 Важные правила работы навыка

Только динамическое обнаружение — агенты никогда не хардкодятся. Новые файлы в папках автоматически появляются в меню.
Максимум 5 агентов — для предотвращения снижения качества ответов и избыточного потребления токенов.
Параллельный запуск — используется вызов Agent параллельно, а не TeamCreate (инструмент для многоагентного диалога). TeamCreate нужен только когда агентам нужно дискутировать или отвечать друг другу.

🎯 Когда использовать

✅ У тебя есть несколько файлов-агентов (Markdown с персоной) и нужно быстро применить несколько экспертиз к одной задаче.
✅ Ты хочешь просмотреть доступные агенты перед выбором, особенно если их много и они распределены по доменам.
✅ Нужно собрать ad-hoc команду из разных областей (например, безопасность + SEO + архитектура) без ручного копирования контекста.
✅ Ты работаешь с кодом, документацией или продуктом и хочешь получить многоракурсный анализ за один запрос.
❌ Не используй, если нужен диалог между агентами (обсуждение, дебаты) — для этого подходит TeamCreate.
❌ Не используй, если задача тривиальна и не требует привлечения нескольких агентов.

⚠️ Важно знать

Навык не создаёт физическую команду, а только запускает агентов параллельно. Взаимодействия между ними нет.
Файлы агентов должны быть Markdown-файлами с описанием персоны (идентичность, правила, workflow, результаты).
Для правильной работы плоской структуры с многословными доменами (например, product-management) используй поддиректории.
Встроенные агенты Claude (Plan, Explore и т.д.) по умолчанию пропускаются — их можно включить только явным запросом пользователя.
Если ты используешь кастомный путь к папке с агентами, его можно указать в конфигурации навыка.

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code team-builder

Источник: https://mcpmarket.com/tools/skills/agent-team-builder-3