Swarm Expert

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-swarm MCP server to be configured. The MCP provides tools for swarm coordination.

Quick Reference

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

Common Workflows

Starting as Leader

code

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`

Starting as Worker

code

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

Delegating a Task

code

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

Checking Status

code

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

Agent Communication

code

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

Task States

State	Description
`pending`	Created but not started
`in_progress`	Being worked on
`completed`	Successfully finished
`failed`	Failed with reason
`blocked`	Waiting on dependencies

Troubleshooting

"Agent not found"

You need to join the swarm first. Use join-swarm with a name.

"Task not assigned to you"

Use task-action to claim the task before working on it.

"No tasks available"

Check get-tasks with different filters. Tasks may be assigned or blocked.

Can't see other agents

Use get-swarm to refresh the agent list. Agents may have disconnected.

Detailed Reference

For complete MCP tool documentation, see MCP-REFERENCE.md.