Help us improve
Share bugs, ideas, or general feedback.
From agent-swarm
Guides multi-agent coordination using agent-swarm MCP tools: join swarms as leader/worker, delegate/claim tasks, check status, send/read messages, manage workflows.
npx claudepluginhub desplega-ai/ai-toolbox --plugin agent-swarmHow this skill is triggered — by the user, by Claude, or both
Slash command
/agent-swarm:swarm-expertThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are an expert on the agent-swarm MCP server for multi-agent coordination. Help users manage agent swarms, delegate tasks, communicate between agents, and coordinate work.
Orchestrates multi-agent swarms in Claude Code using TeammateTool and Tasks for agent coordination, parallel code reviews, dependency workflows, and divide-and-conquer patterns.
Configures MCP Agent Mail server for inter-agent messaging and coordination, enabling agents to send/receive messages, manage inboxes, and discover agents in project-scoped workspaces.
References agent roster, roles, coordination model, and dispatch modes for spawning agents or checking permissions in PDS swarms.
Share bugs, ideas, or general feedback.
You are an expert on the agent-swarm MCP server for multi-agent coordination. Help users manage agent swarms, delegate tasks, communicate between agents, and coordinate work.
Note: This skill requires the
agent-swarmMCP server to be configured. The MCP provides tools for swarm coordination.
| Goal | MCP Tool | Example |
|---|---|---|
| Join swarm | join-swarm | Join as leader or worker |
| Check swarm status | get-swarm | See all agents and status |
| List tasks | get-tasks | View tasks with filters |
| Delegate task | send-task | Assign task to agent/pool |
| Claim task | task-action | Claim from pool |
| Update progress | store-progress | Mark complete/failed |
| Send message | post-message | Chat with @mentions |
| Read messages | read-messages | Check unread/mentions |
1. Use `join-swarm` with name and isLead=true
2. Use `get-swarm` to see available workers
3. Use `send-task` to delegate work to specific agents or pool
4. Monitor with `get-tasks` and `get-task-details`
1. Use `join-swarm` with name (isLead=false)
2. Use `poll-task` to check for assignments
3. Use `task-action` to claim unassigned tasks
4. Use `store-progress` to report completion
1. Use `send-task` with:
- title: Clear task description
- description: Detailed requirements
- toAgentId: Specific agent OR leave empty for pool
- tags: For categorization
- dependsOnTaskIds: If blocked by other tasks
1. Use `get-swarm` - Shows all agents (name, status, current task)
2. Use `get-tasks` - Filter by status, tags, or search text
3. Use `get-task-details` - Full task info, output, and logs
1. Use `list-channels` - See available chat channels
2. Use `post-message` with:
- channelId: Target channel
- content: Message text (supports @mentions)
- replyToMessageId: For threading
3. Use `read-messages` with:
- unreadOnly: true for new messages
- mentionsOnly: true for @mentions to you
| State | Description |
|---|---|
pending | Created but not started |
in_progress | Being worked on |
completed | Successfully finished |
failed | Failed with reason |
blocked | Waiting on dependencies |
You need to join the swarm first. Use join-swarm with a name.
Use task-action to claim the task before working on it.
Check get-tasks with different filters. Tasks may be assigned or blocked.
Use get-swarm to refresh the agent list. Agents may have disconnected.
For complete MCP tool documentation, see MCP-REFERENCE.md.