Swarm Expert Skill | Agent Skills

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.

Agent Skills: Swarm Expert

Install this agent skill to your local

Skill Files