team-builder

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

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Femad-6/my-skills --skill team-builder-femad-6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-builder
Source: https://github.com/Femad-6/my-skills/tree/main/.github/skills/team-builder
Command: npx skills add https://github.com/Femad-6/my-skills --skill team-builder-femad-6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you maintain a library of agent persona files across multiple domains, manually choosing and invoking the right specialists for a task is slow and error-prone. 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 menu, accepts flexible selection input (numbers, fuzzy names, or whole domains), and enforces a maximum of 5 agents per team. - Parallel Dispatch & 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 a specific task.

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 agent personas and the skill spawns them simultaneously using parallel Agent tool calls, each receiving the agent file content plus your task description. Results are collected and merged into a single synthesized report.

How do I organize agent persona files for discovery?

Place markdown agent files in ./agents or ~/.claude/agents using either domain subdirectories or a flat layout with shared filename prefixes. The first markdown heading becomes the agent name and the first paragraph becomes its description.

What format must agent persona files use?

Agent files must be markdown containing a persona prompt with identity, rules, workflow, and deliverables. The first # Heading is used as the agent name; if missing, the name is derived from the filename.

Why are no agents found when I run team builder?

Discovery fails when no markdown files exist in the probed paths: ./agents and ~/.claude/agents at both depths. The skill reports which paths were checked so you can place agent files in one of those directories.

Is there a limit on how many agents can work together?

Yes, a maximum of 5 agents per team is 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 parallel agents instead of TeamCreate?

Use parallel Agent calls when agents work independently on the same task without needing to communicate. TeamCreate is only appropriate when agents must debate or respond to each other's outputs.