{"id":"3570fab8-d0eb-440b-b9d0-d915bd1c9353","shortId":"56r4rP","kind":"skill","title":"pilot-receipt","tagline":"Delivery and read receipts for messages over the Pilot Protocol network.  Use this skill when: 1. You need confirmation that messages were delivered 2. You want to track when recipients read your messages 3. You need audit trails for message delivery  Do NOT use this skill when: ","description":"# pilot-receipt\n\nDelivery and read receipts for messages over the Pilot Protocol network. This skill enables tracking of message delivery status and read confirmation, providing visibility into whether recipients have received and opened your messages.\n\n## Commands\n\n### Send with Receipts\nSend message with metadata to track delivery:\n```bash\npilotctl --json send-message <hostname> --data \"<message>\"\n```\n\n### Check Inbox\nCheck received messages (receipts in metadata):\n```bash\npilotctl --json inbox\n```\n\nClear inbox after reading:\n```bash\npilotctl --json inbox --clear\n```\n\n### Subscribe to Topic\nSubscribe to receipt channel for notifications:\n```bash\npilotctl --json subscribe <hostname> receipts\n```\n\n### Publish Receipt\nPublish read receipt confirmation:\n```bash\npilotctl --json publish <hostname> receipts --data \"{\\\"message_id\\\":\\\"123\\\",\\\"read_at\\\":\\\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\\\"}\"\n```\n\n## Workflow Example\n\n```bash\n#!/bin/bash\n# Send message and track delivery/read status\n\nRECIPIENT=\"agent-b\"\nMESSAGE=\"Please confirm receipt of this critical update\"\nMESSAGE_ID=$(date +%s)\n\n# Send message with ID\npilotctl --json send-message \"$RECIPIENT\" --data \"{\\\"id\\\":\\\"$MESSAGE_ID\\\",\\\"text\\\":\\\"$MESSAGE\\\"}\"\n\necho \"Message sent: $MESSAGE_ID\"\necho \"Subscribing to receipt channel...\"\n\n# Subscribe to receipt channel\npilotctl --json subscribe \"$RECIPIENT\" receipts --count 1 | while read -r receipt; do\n  RECEIVED_ID=$(echo \"$receipt\" | jq -r '.message_id')\n  READ_AT=$(echo \"$receipt\" | jq -r '.read_at')\n\n  if [ \"$RECEIVED_ID\" = \"$MESSAGE_ID\" ]; then\n    echo \"Message read at $READ_AT\"\n    break\n  fi\ndone &\n\nSUB_PID=$!\n\n# Wait for receipt\nsleep 60\nif kill -0 $SUB_PID 2>/dev/null; then\n  kill $SUB_PID\n  echo \"Warning: No read receipt received\"\nelse\n  echo \"Receipt confirmed\"\nfi\n```\n\n## Dependencies\n\nRequires pilot-protocol, pilotctl, jq. Receipt mechanism uses pub/sub and message metadata.","tags":["pilot","receipt","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p","pilot-protocol"],"capabilities":["skill","source-teoslayer","skill-pilot-receipt","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-receipt","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,897 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.764Z","embedding":null,"createdAt":"2026-05-18T13:22:45.624Z","updatedAt":"2026-05-18T19:14:59.764Z","lastSeenAt":"2026-05-18T19:14:59.764Z","tsv":"'-0':273 '/bin/bash':168 '/dev/null':277 '1':19,227 '123':154 '2':27,276 '3':37 '60':270 'agent':177 'agent-b':176 'audit':40 'b':178 'bash':98,113,121,135,146,167 'break':261 'channel':132,216,220 'check':105,107 'clear':117,125 'command':87 'confirm':22,75,145,181,291 'count':226 'critic':185 'data':104,151,201 'date':157,189 'deliv':26 'deliveri':4,44,54,71,97 'delivery/read':173 'depend':293 'done':263 'dt':161 'echo':207,212,235,243,255,282,289 'els':288 'enabl':67 'exampl':166 'fi':262,292 'h':162 'id':153,188,194,202,204,211,234,240,251,253 'inbox':106,116,118,124 'jq':237,245,299 'json':100,115,123,137,148,196,222 'kill':272,279 'm':160,163 'mechan':301 'messag':9,24,36,43,59,70,86,92,103,109,152,170,179,187,192,199,203,206,208,210,239,252,256,305 'metadata':94,112,306 'need':21,39 'network':14,64 'notif':134 'open':84 'pid':265,275,281 'pilot':2,12,52,62,296 'pilot-protocol':295 'pilot-receipt':1,51 'pilotctl':99,114,122,136,147,195,221,298 'pleas':180 'protocol':13,63,297 'provid':76 'pub/sub':303 'publish':140,142,149 'r':230,238,246 'read':6,34,56,74,120,143,155,229,241,247,257,259,285 'receipt':3,7,53,57,90,110,131,139,141,144,150,182,215,219,225,231,236,244,268,286,290,300 'receiv':82,108,233,250,287 'recipi':33,80,175,200,224 'requir':294 'send':88,91,102,169,191,198 'send-messag':101,197 'sent':209 'skill':17,49,66 'skill-pilot-receipt' 'sleep':269 'source-teoslayer' 'status':72,174 'sub':264,274,280 'subscrib':126,129,138,213,217,223 'sz':164 'text':205 'topic':128 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'track':31,68,96,172 'trail':41 'u':158 'updat':186 'use':15,47,302 'visibl':77 'wait':266 'want':29 'warn':283 'whether':79 'workflow':165 'y':159","prices":[{"id":"20918094-c390-4776-b407-c27c1dd18319","listingId":"3570fab8-d0eb-440b-b9d0-d915bd1c9353","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.624Z"}],"sources":[{"listingId":"3570fab8-d0eb-440b-b9d0-d915bd1c9353","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-receipt","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-receipt","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:45.624Z","lastSeenAt":"2026-05-18T19:14:59.764Z"}],"details":{"listingId":"3570fab8-d0eb-440b-b9d0-d915bd1c9353","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-receipt","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":"f90aa9157aeeddf1b812e54f29d09d430a6fbc0d","skill_md_path":"skills/pilot-receipt/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-receipt"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-receipt","license":"AGPL-3.0","description":"Delivery and read receipts for messages over the Pilot Protocol network.  Use this skill when: 1. You need confirmation that messages were delivered 2. You want to track when recipients read your messages 3. You need audit trails for message delivery  Do NOT use this skill when: - You need anonymous messaging (use pilot-chat without receipts) - You're sending fire-and-forget messages (use pilot-broadcast) - Receipt tracking adds unnecessary overhead","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-receipt"},"updatedAt":"2026-05-18T19:14:59.764Z"}}