team-builder

Discovers agent markdown files and dispatches selected agents in parallel for a task.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill team-builder-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-builder
Source: https://github.com/ibytechaos/claude/tree/main/plugins/everything-claude-code/skills/team-builder
Command: npx skills add https://github.com/ibytechaos/claude --skill team-builder-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you maintain a library of agent personas (markdown files with identity, rules, and workflows), choosing the right ones for a task and running them together is manual and repetitive. This Skill automates discovery, selection, and parallel dispatch of agent teams. ## Core Features & Use Cases - Dynamic Agent Discovery: Scans project-local and global agent directories, supporting both flat and domain-subdirectory layouts, with automatic name and summary extraction. - Interactive Team Composition: Presents a domain-grouped menu, accepts flexible selection (numbers, fuzzy names, or whole domains), and enforces a maximum of 5 agents per team. - Parallel Execution & Synthesis: Spawns all selected agents simultaneously via the Agent tool and merges their outputs into a unified report highlighting agreements, conflicts, and next steps. - Use Case: Before launching a Next.js e-commerce site, select the Security Engineer and SEO Specialist agents, have both review the codebase in parallel, and receive a synthesized report reconciling their recommendations. ## Quick Start Ask the assistant to run team builder and pick agents to review your project, for example: use team builder to have the security engineer and SEO specialist review my site before launch.

Frequently Asked Questions about team-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple AI agents in parallel on one task?

Select up to five agents from the discovered menu, provide a task description, and the skill spawns all of them simultaneously using parallel Agent tool calls. Each agent runs independently and results are merged into one report.

What format do agent persona files need to be in?

Agent files must be markdown containing a persona prompt with identity, rules, workflow, and deliverables. The first # Heading becomes the agent name and the first paragraph becomes its description.

Does team-builder support nested agent directories by domain?

Yes, both flat and subdirectory layouts are supported. In subdirectories the domain comes from the folder name; in flat layouts a shared filename prefix appearing in two or more files defines the domain.

Where does team-builder look for agent files?

It probes ./agents and ~/.claude/agents at both depths, merges results, and deduplicates by agent name. Project-local agents take precedence over global ones with the same name, and a custom path can be specified.

What is the maximum number of agents per team?

The limit is five agents per team, enforced at selection time. If you select more, the skill lists them alphabetically and asks you to narrow down or keep the first five.

When should I use TeamCreate instead of parallel agent dispatch?

Use parallel Agent calls when agents work independently on the same task. TeamCreate is only needed when agents must debate, respond to each other, or engage in multi-agent dialogue.