{"id":"63f75e80-83d6-46cc-b0c5-7c60e8693a6f","shortId":"ZF2fn8","kind":"skill","title":"pilot-relay","tagline":"Store-and-forward messaging for offline peers over the Pilot Protocol network.  Use this skill when: 1. You need to send messages to agents that may be offline 2. You want guaranteed eventual delivery 3. You need asynchronous communication patterns  Do NOT use this skill when: - ","description":"# pilot-relay\n\nStore-and-forward messaging for offline peers. Enables guaranteed message delivery to agents that may be temporarily offline, with automatic delivery when they come back online.\n\n## Essential Commands\n\n### Send message (auto-relayed if peer offline)\n```bash\npilotctl --json send-message <hostname> --data \"<message>\"\n```\n\n### Check daemon status\n```bash\npilotctl --json daemon status\n```\n\n### Retrieve messages from inbox\n```bash\npilotctl --json inbox\n```\n\n### Clear inbox after processing\n```bash\npilotctl --json inbox --clear\n```\n\n## Workflow Example\n\nAgent A sends to Agent B (message auto-relayed if B is offline):\n\n```bash\n#!/bin/bash\n# Agent A (sender)\n\n# Try to find Agent B\npilotctl --json find agent-b\n\n# Send message (auto-queued for relay if offline)\npilotctl --json send-message agent-b --data \"Important: Database migration tonight\"\n\n# Check daemon status\npilotctl --json daemon status\n```\n\nAgent B comes online and retrieves messages:\n\n```bash\n#!/bin/bash\n# Agent B (receiver)\n\n# Start daemon (auto-retrieves relayed messages)\npilotctl --json daemon start\n\n# Check inbox for messages\nINBOX=$(pilotctl --json inbox)\necho \"$INBOX\" | jq -r '.items[]? | \"[\\(.timestamp)] \\(.content)\"'\n\n# Send acknowledgment reply\npilotctl --json send-message agent-a --data \"Acknowledged: Will monitor migration\"\n\n# Clear inbox\npilotctl --json inbox --clear\n```\n\n## Relay Behavior\n\n### Automatic queuing\nMessages are automatically queued when:\n- Recipient peer is offline\n- Direct connection fails after retries\n- Peer is behind symmetric NAT without relay support\n\n### Delivery guarantees\n- At-least-once delivery\n- Ordered per-sender\n- 7-day retention\n- Automatic retry\n\n### Relay nodes\n- Registered rendezvous servers act as relay points\n- Messages are encrypted end-to-end (relay cannot read content)\n- Relay nodes store messages temporarily until delivery\n\n## Dependencies\n\nRequires `pilot-protocol` skill, `pilotctl` binary, running daemon, registry connection, and trust relationship between sender/recipient.","tags":["pilot","relay","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p","pilot-protocol"],"capabilities":["skill","source-teoslayer","skill-pilot-relay","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-relay","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,025 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:59.960Z","embedding":null,"createdAt":"2026-05-18T13:22:45.890Z","updatedAt":"2026-05-18T19:14:59.960Z","lastSeenAt":"2026-05-18T19:14:59.960Z","tsv":"'/bin/bash':140,192 '1':21 '2':33 '3':39 '7':281 'acknowledg':223,234 'act':291 'agent':28,67,125,129,141,147,153,170,184,193,231 'agent-a':230 'agent-b':152,169 'asynchron':42 'at-least-onc':272 'auto':86,133,158,199 'auto-queu':157 'auto-relay':85,132 'auto-retriev':198 'automat':74,246,250,284 'b':130,136,148,154,171,185,194 'back':79 'bash':91,101,110,118,139,191 'behavior':245 'behind':264 'binari':320 'cannot':303 'check':98,177,207 'clear':114,122,238,243 'come':78,186 'command':82 'communic':43 'connect':258,324 'content':221,305 'daemon':99,104,178,182,197,205,322 'data':97,172,233 'databas':174 'day':282 'deliveri':38,65,75,270,276,312 'depend':313 'direct':257 'echo':215 'enabl':62 'encrypt':297 'end':299,301 'end-to-end':298 'essenti':81 'eventu':37 'exampl':124 'fail':259 'find':146,151 'forward':7,57 'guarante':36,63,271 'import':173 'inbox':109,113,115,121,208,211,214,216,239,242 'item':219 'jq':217 'json':93,103,112,120,150,165,181,204,213,226,241 'least':274 'may':30,69 'messag':8,26,58,64,84,96,107,131,156,168,190,202,210,229,248,295,309 'migrat':175,237 'monitor':236 'nat':266 'need':23,41 'network':16 'node':287,307 'offlin':10,32,60,72,90,138,163,256 'onlin':80,187 'order':277 'pattern':44 'peer':11,61,89,254,262 'per':279 'per-send':278 'pilot':2,14,52,316 'pilot-protocol':315 'pilot-relay':1,51 'pilotctl':92,102,111,119,149,164,180,203,212,225,240,319 'point':294 'process':117 'protocol':15,317 'queu':159,247,251 'r':218 'read':304 'receiv':195 'recipi':253 'regist':288 'registri':323 'relationship':327 'relay':3,53,87,134,161,201,244,268,286,293,302,306 'rendezv':289 'repli':224 'requir':314 'retent':283 'retri':261,285 'retriev':106,189,200 'run':321 'send':25,83,95,127,155,167,222,228 'send-messag':94,166,227 'sender':143,280 'sender/recipient':329 'server':290 'skill':19,49,318 'skill-pilot-relay' 'source-teoslayer' 'start':196,206 'status':100,105,179,183 'store':5,55,308 'store-and-forward':4,54 'support':269 'symmetr':265 'temporarili':71,310 'timestamp':220 'tonight':176 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'tri':144 'trust':326 'use':17,47 'want':35 'without':267 'workflow':123","prices":[{"id":"fa403f69-6a6f-4928-98b9-a45783a87239","listingId":"63f75e80-83d6-46cc-b0c5-7c60e8693a6f","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:45.890Z"}],"sources":[{"listingId":"63f75e80-83d6-46cc-b0c5-7c60e8693a6f","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-relay","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-relay","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:45.890Z","lastSeenAt":"2026-05-18T19:14:59.960Z"}],"details":{"listingId":"63f75e80-83d6-46cc-b0c5-7c60e8693a6f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-relay","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":"cf3ea7ff151d29b3e3fe6f05ebe2c5ba46a330f8","skill_md_path":"skills/pilot-relay/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-relay"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-relay","license":"AGPL-3.0","description":"Store-and-forward messaging for offline peers over the Pilot Protocol network.  Use this skill when: 1. You need to send messages to agents that may be offline 2. You want guaranteed eventual delivery 3. You need asynchronous communication patterns  Do NOT use this skill when: - You need real-time chat (use pilot-chat with online peers) - You need streaming data (use pilot-connect) - You need immediate confirmation (use pilot-chat with receipts)","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-relay"},"updatedAt":"2026-05-18T19:14:59.960Z"}}