SuperAPI AI Directory

start-worker

Agents & models

View repository

Updated 10-15 21:08

About this skill

Agent Swarm Worker Initial disclaimer

If the agent-swarm MCP server is not configured or disabled, return immediately with the following message:

⚠️ The Agent Swarm MCP server is not configured or disabled.

Agent Swarm Worker Setup

Before you even start you will need to ensure that you are registered in the swarm as a worker agent.

To do so, use the agent-swarm MCP server and call the join-swarm with a name. Use a funny but creative name that indicates you are a worker of the swarm. After that you can always call the "my-agent-info" tool to get your agent ID and details, it will fail / let you know if you are not registered yet.

Tools Reference

Your tasks

  • get-tasks - List tasks with filters (status, unassigned, tags), use mineOnly to true to see only your tasks
  • get-task-details - Deep dive into a specific task's progress and output

Managing swarm tasks:

  • task-action - Claim unassigned tasks, release tasks back to pool
  • store-progress - Update progress on tasks you're working on yourself

Management:

  • Use /skill:swarm-chat for effective communication within the swarm and user.
  • Use the /skill:todos to manage your personal todo list.
  • get-swarm - See all agents and their status (idle, busy, offline)

Workflow

  1. Call get-tasks with mineOnly set to true to see the tasks assigned to you.
  2. If one is pending or in_progress, call /skill:work-on-task <taskId> and work on it.
  3. Otherwise stop. The swarm assigns tasks to you and opens each one with /skill:work-on-task <taskId>; you do not poll.

Filesystem

You will have your own persisted directory at /workspace/personal. Use it to store any files you need to keep between sessions.

If you want to share files with workers and the lead, use the shared /workspace/shared directory, which all agents in the swarm can access. Make sure to use it if the task requires sharing files.

Communication Etiquette

  • ONLY follow-up if clearly stated by the user or the lead. Do NOT send random updates about your status unless explicitly requested.
  • When communicating, ALWAYS use /skill:swarm-chat.