{"id":"2f7a8e23-99eb-4cb7-a387-2e6cbd35ee5f","shortId":"Pyjxyy","kind":"skill","title":"pilot-swarm-task-farm-setup","tagline":"Deploy a self-organizing compute swarm with 5 agents.  Use this skill when: 1. User wants to set up a distributed task farm or compute swarm 2. User is configuring a leader, worker, or monitor agent 3. User asks about leader election, map-reduce, or swarm coordination  Do NOT use","description":"# Swarm Task Farm Setup\n\nDeploy 5 agents: 1 leader, 3 workers, and 1 monitor.\n\n## Roles\n\n| Role | Hostname | Skills | Purpose |\n|------|----------|--------|---------|\n| leader | `<prefix>-leader` | pilot-leader-election, pilot-formation, pilot-task-router, pilot-broadcast | Elected leader, distributes tasks |\n| worker-N | `<prefix>-worker-N` | pilot-swarm-join, pilot-map-reduce, pilot-task-retry, pilot-metrics | Executes tasks, retries on failure |\n| monitor | `<prefix>-monitor` | pilot-task-monitor, pilot-mesh-status, pilot-slack-bridge, pilot-metrics | Tracks swarm health |\n\n## Setup Procedure\n\n**Step 1:** Ask the user which role and prefix. For workers, also ask the worker number (1, 2, or 3).\n\n**Step 2:** Install skills:\n```bash\n# leader:\nclawhub install pilot-leader-election pilot-formation pilot-task-router pilot-broadcast\n# worker (repeat for each):\nclawhub install pilot-swarm-join pilot-map-reduce pilot-task-retry pilot-metrics\n# monitor:\nclawhub install pilot-task-monitor pilot-mesh-status pilot-slack-bridge pilot-metrics\n```\n\n**Step 3:** Set hostname and write manifest to `~/.pilot/setups/swarm-task-farm.json`.\n\n**Step 4:** Handshake — workers trust leader + monitor; leader trusts all workers + monitor.\n\n## Manifest Templates Per Role\n\n### leader\n```json\n{\n  \"setup\": \"swarm-task-farm\", \"role\": \"leader\", \"role_name\": \"Swarm Leader\",\n  \"hostname\": \"<prefix>-leader\",\n  \"skills\": {\n    \"pilot-leader-election\": \"Participate in leader election via consensus.\",\n    \"pilot-formation\": \"Manage swarm membership.\",\n    \"pilot-task-router\": \"Partition and distribute tasks to workers.\",\n    \"pilot-broadcast\": \"Broadcast work units to all workers.\"\n  },\n  \"data_flows\": [\n    { \"direction\": \"send\", \"peer\": \"<prefix>-worker-1\", \"port\": 1002, \"topic\": \"task-assignment\", \"description\": \"Work units\" },\n    { \"direction\": \"send\", \"peer\": \"<prefix>-worker-2\", \"port\": 1002, \"topic\": \"task-assignment\", \"description\": \"Work units\" },\n    { \"direction\": \"send\", \"peer\": \"<prefix>-worker-3\", \"port\": 1002, \"topic\": \"task-assignment\", \"description\": \"Work units\" },\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-1\", \"port\": 1002, \"topic\": \"task-result\", \"description\": \"Completed results\" },\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-2\", \"port\": 1002, \"topic\": \"task-result\", \"description\": \"Completed results\" },\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-3\", \"port\": 1002, \"topic\": \"task-result\", \"description\": \"Completed results\" }\n  ],\n  \"handshakes_needed\": [\"<prefix>-worker-1\", \"<prefix>-worker-2\", \"<prefix>-worker-3\", \"<prefix>-monitor\"]\n}\n```\n\n### worker-N\n```json\n{\n  \"setup\": \"swarm-task-farm\", \"role\": \"worker-N\", \"role_name\": \"Compute Worker\",\n  \"hostname\": \"<prefix>-worker-N\",\n  \"skills\": {\n    \"pilot-swarm-join\": \"Join the swarm and register with leader.\",\n    \"pilot-map-reduce\": \"Execute map-reduce work units.\",\n    \"pilot-task-retry\": \"Retry failed tasks with exponential backoff.\",\n    \"pilot-metrics\": \"Report CPU, memory, task throughput to monitor.\"\n  },\n  \"data_flows\": [\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-leader\", \"port\": 1002, \"topic\": \"task-assignment\", \"description\": \"Work units\" },\n    { \"direction\": \"send\", \"peer\": \"<prefix>-leader\", \"port\": 1002, \"topic\": \"task-result\", \"description\": \"Completed results\" },\n    { \"direction\": \"send\", \"peer\": \"<prefix>-monitor\", \"port\": 1002, \"topic\": \"worker-metrics\", \"description\": \"Health metrics\" }\n  ],\n  \"handshakes_needed\": [\"<prefix>-leader\", \"<prefix>-monitor\"]\n}\n```\n\n### monitor\n```json\n{\n  \"setup\": \"swarm-task-farm\", \"role\": \"monitor\", \"role_name\": \"Swarm Monitor\",\n  \"hostname\": \"<prefix>-monitor\",\n  \"skills\": {\n    \"pilot-task-monitor\": \"Track task completion rates and queue depth.\",\n    \"pilot-mesh-status\": \"Monitor worker connectivity and latency.\",\n    \"pilot-slack-bridge\": \"Alert on worker failures or stalled tasks.\",\n    \"pilot-metrics\": \"Aggregate and display swarm metrics.\"\n  },\n  \"data_flows\": [\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-1\", \"port\": 1002, \"topic\": \"worker-metrics\", \"description\": \"Worker health\" },\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-2\", \"port\": 1002, \"topic\": \"worker-metrics\", \"description\": \"Worker health\" },\n    { \"direction\": \"receive\", \"peer\": \"<prefix>-worker-3\", \"port\": 1002, \"topic\": \"worker-metrics\", \"description\": \"Worker health\" }\n  ],\n  \"handshakes_needed\": [\"<prefix>-leader\", \"<prefix>-worker-1\", \"<prefix>-worker-2\", \"<prefix>-worker-3\"]\n}\n```\n\n## Data Flows\n\n- `leader → worker-*` : task assignments (port 1002)\n- `worker-* → leader` : completed results (port 1002)\n- `worker-* → monitor` : health metrics (port 1002)\n\n## Workflow Example\n\n```bash\n# On leader — distribute:\npilotctl --json publish <prefix>-worker-1 task-assignment '{\"task_id\":\"T-001\",\"type\":\"image_resize\",\"input\":\"batch-a.zip\"}'\n# On worker-1 — complete:\npilotctl --json publish <prefix>-leader task-result '{\"task_id\":\"T-001\",\"status\":\"success\",\"duration_s\":34}'\npilotctl --json publish <prefix>-monitor worker-metrics '{\"worker\":\"worker-1\",\"cpu\":72,\"tasks_done\":15}'\n```\n\n## Dependencies\n\nRequires `pilot-protocol` skill, `pilotctl` binary, `clawhub` binary, and a running daemon.","tags":["pilot","swarm","task","farm","setup","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw"],"capabilities":["skill","source-teoslayer","skill-pilot-swarm-task-farm-setup","topic-agent-skills","topic-ai-agents","topic-clawhub","topic-networking","topic-openclaw","topic-overlay-network","topic-p2p","topic-pilot-protocol"],"categories":["pilot-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/TeoSlayer/pilot-skills/pilot-swarm-task-farm-setup","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add TeoSlayer/pilot-skills","source_repo":"https://github.com/TeoSlayer/pilot-skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (5,189 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:15:04.886Z","embedding":null,"createdAt":"2026-05-18T13:22:53.205Z","updatedAt":"2026-05-18T19:15:04.886Z","lastSeenAt":"2026-05-18T19:15:04.886Z","tsv":"'-001':651,671 '-1':309,351,392,567,609,644,659,686 '-2':323,365,394,581,611 '-3':337,379,396,595,613 '/.pilot/setups/swarm-task-farm.json':235 '1':21,66,71,147,162 '1002':311,325,339,353,367,381,468,481,494,569,583,597,621,627,633 '15':691 '2':34,163,167 '3':44,68,165,228 '34':676 '4':237 '5':15,64 '72':688 'agent':16,43,65 'aggreg':556 'alert':546 'also':157 'ask':46,148,158 'assign':315,329,343,472,619,647 'backoff':450 'bash':170,636 'batch-a.zip':656 'binari':699,701 'bridg':137,223,545 'broadcast':93,187,296,297 'clawhub':172,192,210,700 'complet':359,373,387,487,528,624,660 'comput':12,32,413 'configur':37 'connect':539 'consensus':277 'coordin':55 'cpu':455,687 'daemon':705 'data':303,461,561,614 'depend':692 'deploy':7,63 'depth':532 'descript':316,330,344,358,372,386,473,486,499,574,588,602 'direct':305,319,333,347,361,375,463,476,489,563,577,591 'display':558 'distribut':28,96,290,639 'done':690 'durat':674 'elect':49,83,94,177,271,275 'exampl':635 'execut':119,435 'exponenti':449 'fail':446 'failur':123,549 'farm':5,30,61,258,406,512 'flow':304,462,562,615 'format':86,180,280 'handshak':238,389,502,605 'health':143,500,576,590,604,630 'hostnam':75,230,265,415,519 'id':649,669 'imag':653 'input':655 'instal':168,173,193,211 'join':107,197,423,424 'json':253,401,507,641,662,678 'latenc':541 'leader':39,48,67,78,79,82,95,171,176,241,243,252,260,264,266,270,274,430,466,479,504,607,616,623,638,664 'manag':281 'manifest':233,248 'map':51,110,200,433,437 'map-reduc':50,436 'membership':283 'memori':456 'mesh':132,218,535 'metric':118,140,208,226,453,498,501,555,560,573,587,601,631,683 'monitor':42,72,124,125,129,209,215,242,247,397,460,492,505,506,514,518,520,525,537,629,680 'n':100,103,400,410,418 'name':262,412,516 'need':390,503,606 'number':161 'organ':11 'particip':272 'partit':288 'peer':307,321,335,349,363,377,465,478,491,565,579,593 'per':250 'pilot':2,81,85,88,92,105,109,113,117,127,131,135,139,175,179,182,186,195,199,203,207,213,217,221,225,269,279,285,295,421,432,442,452,523,534,543,554,695 'pilot-broadcast':91,185,294 'pilot-form':84,178,278 'pilot-leader-elect':80,174,268 'pilot-map-reduc':108,198,431 'pilot-mesh-status':130,216,533 'pilot-metr':116,138,206,224,451,553 'pilot-protocol':694 'pilot-slack-bridg':134,220,542 'pilot-swarm-join':104,194,420 'pilot-swarm-task-farm-setup':1 'pilot-task-monitor':126,212,522 'pilot-task-retri':112,202,441 'pilot-task-rout':87,181,284 'pilotctl':640,661,677,698 'port':310,324,338,352,366,380,467,480,493,568,582,596,620,626,632 'prefix':154 'procedur':145 'protocol':696 'publish':642,663,679 'purpos':77 'queue':531 'rate':529 'receiv':348,362,376,464,564,578,592 'reduc':52,111,201,434,438 'regist':428 'repeat':189 'report':454 'requir':693 'resiz':654 'result':357,360,371,374,385,388,485,488,625,667 'retri':115,121,205,444,445 'role':73,74,152,251,259,261,407,411,513,515 'router':90,184,287 'run':704 'self':10 'self-organ':9 'send':306,320,334,477,490 'set':25,229 'setup':6,62,144,254,402,508 'skill':19,76,169,267,419,521,697 'skill-pilot-swarm-task-farm-setup' 'slack':136,222,544 'source-teoslayer' 'stall':551 'status':133,219,536,672 'step':146,166,227,236 'success':673 'swarm':3,13,33,54,59,106,142,196,256,263,282,404,422,426,510,517,559 'swarm-task-farm':255,403,509 'task':4,29,60,89,97,114,120,128,183,204,214,257,286,291,314,328,342,356,370,384,405,443,447,457,471,484,511,524,527,552,618,646,648,666,668,689 'task-assign':313,327,341,470,645 'task-result':355,369,383,483,665 'templat':249 'throughput':458 'topic':312,326,340,354,368,382,469,482,495,570,584,598 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'track':141,526 'trust':240,244 'type':652 'unit':299,318,332,346,440,475 'use':17,58 'user':22,35,45,150 'via':276 'want':23 'work':298,317,331,345,439,474 'worker':40,69,99,102,156,160,188,239,246,293,302,308,322,336,350,364,378,391,393,395,399,409,414,417,497,538,548,566,572,575,580,586,589,594,600,603,608,610,612,617,622,628,643,658,682,684,685 'worker-metr':496,571,585,599,681 'worker-n':98,101,398,408,416 'workflow':634 'write':232","prices":[{"id":"a402d455-7293-497b-bd0f-c79349f66949","listingId":"2f7a8e23-99eb-4cb7-a387-2e6cbd35ee5f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"TeoSlayer","category":"pilot-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:53.205Z"}],"sources":[{"listingId":"2f7a8e23-99eb-4cb7-a387-2e6cbd35ee5f","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-swarm-task-farm-setup","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-swarm-task-farm-setup","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:53.205Z","lastSeenAt":"2026-05-18T19:15:04.886Z"}],"details":{"listingId":"2f7a8e23-99eb-4cb7-a387-2e6cbd35ee5f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-swarm-task-farm-setup","github":{"repo":"TeoSlayer/pilot-skills","stars":6,"topics":["agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p","pilot-protocol"],"license":"agpl-3.0","html_url":"https://github.com/TeoSlayer/pilot-skills","pushed_at":"2026-05-13T06:08:49Z","description":"80+ agent skills for Pilot Protocol — communication, file transfer, trust, task routing, swarm coordination, and more","skill_md_sha":"fc3c0a34278e19ddaf0f106a9960ef52be22fd08","skill_md_path":"skills/pilot-swarm-task-farm-setup/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-swarm-task-farm-setup"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-swarm-task-farm-setup","license":"AGPL-3.0","description":"Deploy a self-organizing compute swarm with 5 agents.  Use this skill when: 1. User wants to set up a distributed task farm or compute swarm 2. User is configuring a leader, worker, or monitor agent 3. User asks about leader election, map-reduce, or swarm coordination  Do NOT use this skill when: - User wants to submit a single task (use pilot-task-router instead) - User wants leader election only (use pilot-leader-election instead)"},"skills_sh_url":"https://skills.sh/TeoSlayer/pilot-skills/pilot-swarm-task-farm-setup"},"updatedAt":"2026-05-18T19:15:04.886Z"}}