{"id":"fdb18e12-0b96-48b5-a08e-8d01eb58caae","shortId":"aVHMZK","kind":"skill","title":"pilot-formation","tagline":"Deploy predefined network topologies (star, ring, mesh, tree) for structured swarms.  Use this skill when: 1. You need specific communication patterns (star coordinator, ring consensus) 2. You want to minimize connection overhead with structured topologies 3. You need hierarchica","description":"# pilot-formation\n\nDeploy structured network topologies with automatic peer handshaking and trust establishment. Supports star (hub-and-spoke), ring (circular), mesh (all-to-all), tree (hierarchical), and line (chain) formations.\n\n## Commands\n\n**Deploy star (hub connects to all spokes):**\n```bash\nWORKERS=$(pilotctl --json peers --search \"role:worker\" | jq -r '.[].hostname')\nfor worker in $WORKERS; do\n  pilotctl --json handshake \"$worker\" \"Forming star topology\"\n  sleep 1\n  NODE_ID=$(pilotctl --json pending | jq -r '.pending[] | select(.hostname == \"'\"$worker\"'\") | .node_id')\n  [ -n \"$NODE_ID\" ] && pilotctl --json approve \"$NODE_ID\"\ndone\n```\n\n**Deploy ring (circular connections):**\n```bash\nAGENTS=$(pilotctl --json peers --search \"swarm:$SWARM_NAME\" | jq -r 'sort_by(.node_id) | .[].address')\n# Connect to next agent in sorted order (implementation in workflow)\n```\n\n**Deploy mesh (all-to-all):**\n```bash\nALL_PEERS=$(pilotctl --json peers --search \"swarm:$SWARM_NAME\" | jq -r '.[].address')\nfor peer in $ALL_PEERS; do\n  pilotctl --json handshake \"$peer\" \"Forming mesh topology\" &\ndone\nwait\n\n# Approve all pending handshakes\nPENDING=$(pilotctl --json pending | jq -r '.[].node_id')\nfor peer in $PENDING; do\n  pilotctl --json approve \"$peer\" &\ndone\nwait\n```\n\n## Workflow Example\n\n```bash\n#!/bin/bash\n# Deploy star topology\n\nSWARM_NAME=\"task-swarm\"\nMY_ADDR=$(pilotctl --json info | jq -r '.address')\nREGISTRY_HOST=\"registry.example.com\"\n\n# Get swarm members\nSWARM_MEMBERS=$(pilotctl --json peers --search \"swarm:$SWARM_NAME\" | jq -r '.[].address')\n\necho \"Deploying star topology (hub: $MY_ADDR)\"\n\n# Hub connects to all spokes\nfor worker in $SWARM_MEMBERS; do\n  if [ \"$worker\" != \"$MY_ADDR\" ]; then\n    echo \"Connecting to spoke: $worker\"\n    pilotctl --json handshake \"$worker\" \"Forming star topology\"\n    sleep 1\n    NODE_ID=$(pilotctl --json pending | jq -r '.pending[] | select(.hostname == \"'\"$worker\"'\") | .node_id')\n    [ -n \"$NODE_ID\" ] && pilotctl --json approve \"$NODE_ID\"\n  fi\ndone\n\n# Publish topology\npilotctl --json publish \"$REGISTRY_HOST\" \"topology:$SWARM_NAME\" \\\n  --data \"{\\\"type\\\":\\\"star\\\",\\\"hub\\\":\\\"$MY_ADDR\\\",\\\"formed_at\\\":\\\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\\\"}\"\n\necho \"Star topology complete\"\n```\n\n## Dependencies\n\nRequires `pilot-protocol` skill, `pilotctl` binary, running daemon, and `jq` for JSON parsing.","tags":["pilot","formation","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p","pilot-protocol"],"capabilities":["skill","source-teoslayer","skill-pilot-formation","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-formation","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 (2,331 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:55.974Z","embedding":null,"createdAt":"2026-05-18T13:22:40.727Z","updatedAt":"2026-05-18T19:14:55.974Z","lastSeenAt":"2026-05-18T19:14:55.974Z","tsv":"'/bin/bash':221 '1':19,108,292 '2':29 '3':39 'addr':231,262,277,331 'address':150,179,237,255 'agent':136,154 'all-to-al':66,163 'approv':127,195,214,311 'automat':51 'bash':84,135,167,220 'binari':353 'chain':74 'circular':64,133 'command':76 'communic':23 'complet':345 'connect':34,80,134,151,264,280 'consensus':28 'coordin':26 'daemon':355 'data':326 'date':334 'depend':346 'deploy':4,46,77,131,161,222,257 'done':130,193,216,315 'dt':338 'echo':256,279,342 'establish':56 'exampl':219 'fi':314 'form':104,190,288,332 'format':3,45,75 'get':241 'h':339 'handshak':53,102,188,198,286 'hierarch':71 'hierarchica':42 'host':239,322 'hostnam':94,118,302 'hub':60,79,260,263,329 'hub-and-spok':59 'id':110,121,124,129,149,206,294,305,308,313 'implement':158 'info':234 'jq':92,114,144,177,203,235,253,298,357 'json':87,101,112,126,138,171,187,201,213,233,247,285,296,310,319,359 'line':73 'm':337,340 'member':243,245,272 'mesh':10,65,162,191 'minim':33 'n':122,306 'name':143,176,226,252,325 'need':21,41 'network':6,48 'next':153 'node':109,120,123,128,148,205,293,304,307,312 'order':157 'overhead':35 'pars':360 'pattern':24 'peer':52,88,139,169,172,181,184,189,208,215,248 'pend':113,116,197,199,202,210,297,300 'pilot':2,44,349 'pilot-form':1,43 'pilot-protocol':348 'pilotctl':86,100,111,125,137,170,186,200,212,232,246,284,295,309,318,352 'predefin':5 'protocol':350 'publish':316,320 'r':93,115,145,178,204,236,254,299 'registri':238,321 'registry.example.com':240 'requir':347 'ring':9,27,63,132 'role':90 'run':354 'search':89,140,173,249 'select':117,301 'skill':17,351 'skill-pilot-formation' 'sleep':107,291 'sort':146,156 'source-teoslayer' 'specif':22 'spoke':62,83,267,282 'star':8,25,58,78,105,223,258,289,328,343 'structur':13,37,47 'support':57 'swarm':14,141,142,174,175,225,229,242,244,250,251,271,324 'sz':341 'task':228 'task-swarm':227 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'topolog':7,38,49,106,192,224,259,290,317,323,344 'tree':11,70 'trust':55 'type':327 'u':335 'use':15 'wait':194,217 'want':31 'worker':85,91,96,98,103,119,269,275,283,287,303 'workflow':160,218 'y':336","prices":[{"id":"ff19546e-09d3-450a-a81d-b17465edc1ba","listingId":"fdb18e12-0b96-48b5-a08e-8d01eb58caae","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:40.727Z"}],"sources":[{"listingId":"fdb18e12-0b96-48b5-a08e-8d01eb58caae","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-formation","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-formation","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:40.727Z","lastSeenAt":"2026-05-18T19:14:55.974Z"}],"details":{"listingId":"fdb18e12-0b96-48b5-a08e-8d01eb58caae","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-formation","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":"c1cf640e9028ce360735e826dbc3d8599cf89c81","skill_md_path":"skills/pilot-formation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-formation"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-formation","license":"AGPL-3.0","description":"Deploy predefined network topologies (star, ring, mesh, tree) for structured swarms.  Use this skill when: 1. You need specific communication patterns (star coordinator, ring consensus) 2. You want to minimize connection overhead with structured topologies 3. You need hierarchical organization (tree) for scaling  Do NOT use this skill when: - Ad-hoc peer discovery is sufficient (use pilot-swarm-join) - Topology changes frequently (use dynamic mesh)","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-formation"},"updatedAt":"2026-05-18T19:14:55.974Z"}}