ReddRadar
Agent skill
swarm-expert
Multi-agent coordination expert for agent-swarm MCP. Use when the user asks about swarm coordination, delegating tasks to agents, checking swarm status, agent messaging, or managing multi-agent workflows.
Install this agent skill to your Project
npx add-skill https://github.com/desplega-ai/ai-toolbox/tree/main/cc-plugin/swarm/skills/swarm-expert
SKILL.md
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-swarmMCP 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
desplega-ai/ai-toolbox
wts-expert
Git worktree management expert for @desplega.ai/wts. Use when the user asks about git worktrees, wts commands, worktree workflows, or wants help managing multiple branches simultaneously.
desplega-ai/ai-toolbox
oapi-expert
OpenAPI CLI expert for @desplega.ai/oapi. Use when users want to register OpenAPI specs, execute API requests, manage auth profiles, explore API endpoints, or work with REST APIs from the terminal.
desplega-ai/ai-toolbox
brainstorming
Interactive exploration of ideas through Socratic Q&A. Produces progressive documents that serve as lightweight pre-PRDs feeding into research.
desplega-ai/ai-toolbox
tdd-planning
TDD-focused implementation planning. Creates plans with strict Red-Green-Commit/Rollback cycles for each step.
desplega-ai/ai-toolbox
planning
Implementation planning skill. Creates detailed technical plans through interactive research and iteration.
desplega-ai/ai-toolbox
phase-running
Execute individual plan phases as background sub-agents for context-efficient implementation.
Didn't find tool you were looking for?