swarm-expert

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

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

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

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

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

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.