{"id":"7908e83a-5258-4f49-bdf4-9d3b41920d3d","shortId":"dydqbb","kind":"skill","title":"pilot-load-balancer","tagline":"Distribute tasks across worker pools with health-aware load balancing.  Use this skill when: 1. You need to distribute tasks across multiple worker agents 2. You want round-robin, least-connections, or health-based routing 3. You need to track worker capacity and avoid overload  ","description":"# pilot-load-balancer\n\nImplement load balancing strategies to distribute tasks across worker pools.\n\n## Commands\n\n### Discover available workers\n```bash\nWORKERS=$(pilotctl --json peers --search \"role:worker\" | jq -r '[.[] | {address, node_id, tags}]')\n```\n\n### Assign task using round-robin\n```bash\nROBIN_INDEX=$(cat /tmp/load-balancer-index.txt 2>/dev/null || echo 0)\nNEXT_WORKER=$(echo \"$WORKERS\" | jq -r \".[$ROBIN_INDEX].address\")\n\npilotctl --json send-message \"$NEXT_WORKER\" \\\n  --data \"{\\\"type\\\":\\\"task_assignment\\\",\\\"task_id\\\":\\\"$TASK_ID\\\"}\"\n\necho \"$(( (ROBIN_INDEX + 1) % WORKER_COUNT ))\" > /tmp/load-balancer-index.txt\n```\n\n### Assign task using least-connections\n```bash\nLEAST_LOADED=$(echo \"$WORKER_STATUS\" | jq -r 'sort_by(.active_tasks) | first | .worker')\n\npilotctl --json send-message \"$LEAST_LOADED\" \\\n  --data \"{\\\"type\\\":\\\"task_assignment\\\",\\\"task_id\\\":\\\"$TASK_ID\\\"}\"\n```\n\n## Workflow Example\n\nDistribute 10 tasks across 3 workers:\n\n```bash\n#!/bin/bash\nWORKERS=$(pilotctl --json peers --search \"pool:compute-workers\" | jq -r '.[].address')\nWORKER_ARRAY=($WORKERS)\n\nROBIN_INDEX=0\n\nfor i in {1..10}; do\n  WORKER=${WORKER_ARRAY[$ROBIN_INDEX]}\n  ROBIN_INDEX=$(( (ROBIN_INDEX + 1) % ${#WORKER_ARRAY[@]} ))\n\n  pilotctl --json send-message \"$WORKER\" \\\n    --data \"{\\\"type\\\":\\\"task_assignment\\\",\\\"task_id\\\":\\\"task-$i\\\"}\" &\ndone\nwait\n```\n\n## Dependencies\n\nRequires pilot-protocol skill, jq, and uuidgen.","tags":["pilot","load","balancer","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p"],"capabilities":["skill","source-teoslayer","skill-pilot-load-balancer","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-load-balancer","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 (1,410 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:14:57.587Z","embedding":null,"createdAt":"2026-05-18T13:22:43.054Z","updatedAt":"2026-05-18T19:14:57.587Z","lastSeenAt":"2026-05-18T19:14:57.587Z","tsv":"'/bin/bash':176 '/dev/null':98 '/tmp/load-balancer-index.txt':96,131 '0':100,194 '1':20,128,198,210 '10':170,199 '2':30,97 '3':44,173 'across':7,26,65,172 'activ':148 'address':82,109,188 'agent':29 'array':190,203,212 'assign':86,120,132,162,222 'avail':70 'avoid':52 'awar':13 'balanc':4,15,57,60 'base':42 'bash':72,92,138,175 'capac':50 'cat':95 'command':68 'comput':184 'compute-work':183 'connect':38,137 'count':130 'data':117,159,219 'depend':229 'discov':69 'distribut':5,24,63,169 'done':227 'echo':99,103,125,141 'exampl':168 'first':150 'health':12,41 'health-awar':11 'health-bas':40 'id':84,122,124,164,166,224 'implement':58 'index':94,108,127,193,205,207,209 'jq':80,105,144,186,235 'json':75,111,153,179,214 'least':37,136,139,157 'least-connect':36,135 'load':3,14,56,59,140,158 'messag':114,156,217 'multipl':27 'need':22,46 'next':101,115 'node':83 'overload':53 'peer':76,180 'pilot':2,55,232 'pilot-load-balanc':1,54 'pilot-protocol':231 'pilotctl':74,110,152,178,213 'pool':9,67,182 'protocol':233 'r':81,106,145,187 'requir':230 'robin':35,91,93,107,126,192,204,206,208 'role':78 'round':34,90 'round-robin':33,89 'rout':43 'search':77,181 'send':113,155,216 'send-messag':112,154,215 'skill':18,234 'skill-pilot-load-balancer' 'sort':146 'source-teoslayer' 'status':143 'strategi':61 'tag':85 'task':6,25,64,87,119,121,123,133,149,161,163,165,171,221,223,225 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'track':48 'type':118,160,220 'use':16,88,134 'uuidgen':237 'wait':228 'want':32 'worker':8,28,49,66,71,73,79,102,104,116,129,142,151,174,177,185,189,191,201,202,211,218 'workflow':167","prices":[{"id":"049b909e-89a8-4d3e-b221-81c6d6fd9b0e","listingId":"7908e83a-5258-4f49-bdf4-9d3b41920d3d","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:43.054Z"}],"sources":[{"listingId":"7908e83a-5258-4f49-bdf4-9d3b41920d3d","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-load-balancer","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-load-balancer","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:43.054Z","lastSeenAt":"2026-05-18T19:14:57.587Z"}],"details":{"listingId":"7908e83a-5258-4f49-bdf4-9d3b41920d3d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-load-balancer","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":"92a8ebfa1542853ccf206d408862c80e89a7f67d","skill_md_path":"skills/pilot-load-balancer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-load-balancer"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-load-balancer","license":"AGPL-3.0","description":"Distribute tasks across worker pools with health-aware load balancing.  Use this skill when: 1. You need to distribute tasks across multiple worker agents 2. You want round-robin, least-connections, or health-based routing 3. You need to track worker capacity and avoid overload  Do NOT use this skill when: - You need map-reduce parallelism (use pilot-map-reduce) - Workers should pull tasks themselves (use task queues)","compatibility":"Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start)."},"skills_sh_url":"https://skills.sh/TeoSlayer/pilot-skills/pilot-load-balancer"},"updatedAt":"2026-05-18T19:14:57.587Z"}}