{"id":"8ac15a13-c215-4e5a-858e-01cbabd4d12e","shortId":"fyaBMe","kind":"skill","title":"pilot-metrics","tagline":"Collect and aggregate agent metrics from connections, peers, and custom events.  Use this skill when: 1. You need to monitor agent health and performance 2. You need to aggregate metrics across a fleet of agents 3. You need to track connection counts, RTT, throughput 4. You need ","description":"# Pilot Metrics\n\nCollect and aggregate metrics from Pilot Protocol agents.\n\n## Commands\n\n### Get agent info\n```bash\npilotctl --json info\n```\nReturns node ID, address, hostname, uptime, polo score.\n\n### Get peer list\n```bash\npilotctl --json peers\n```\nLists connected peers with connection time.\n\n### Get connections\n```bash\npilotctl --json connections\n```\nLists active connections with state, ports, bytes sent/received.\n\n### Subscribe to custom metrics\n```bash\npilotctl --json subscribe <source-hostname> \"metrics.*\" [--timeout <seconds>]\n```\n\n## Workflow Example\n\nFleet health dashboard:\n\n```bash\n#!/bin/bash\nOUTPUT_FILE=\"/tmp/fleet-metrics-$(date +%Y%m%d-%H%M%S).json\"\n\necho '{\"timestamp\":\"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'\",\"agents\":[]}' > \"$OUTPUT_FILE\"\n\nagents=$(pilotctl --json trust 2>/dev/null | jq -r '.data.trusted[].hostname')\n\nfor agent in $agents; do\n  ping_result=$(pilotctl --json ping \"$agent\" 2>/dev/null)\n  rtt_ms=$(echo \"$ping_result\" | jq -r '.data.results[0].rtt_ms // null')\n\n  agent_data=$(jq -n --arg hostname \"$agent\" --arg rtt \"$rtt_ms\" \\\n    '{hostname: $hostname, rtt_ms: ($rtt | tonumber), status: \"online\"}')\n\n  jq --argjson agent \"$agent_data\" '.agents += [$agent]' \"$OUTPUT_FILE\" > \"${OUTPUT_FILE}.tmp\"\n  mv \"${OUTPUT_FILE}.tmp\" \"$OUTPUT_FILE\"\ndone\n```\n\n## Dependencies\n\nRequires pilot-protocol skill, jq, and a running daemon.","tags":["pilot","metrics","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network","p2p","pilot-protocol"],"capabilities":["skill","source-teoslayer","skill-pilot-metrics","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-metrics","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,358 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:58.383Z","embedding":null,"createdAt":"2026-05-18T13:22:43.982Z","updatedAt":"2026-05-18T19:14:58.383Z","lastSeenAt":"2026-05-18T19:14:58.383Z","tsv":"'/bin/bash':120 '/dev/null':150,167 '/tmp/fleet-metrics-':123 '0':176 '1':19 '2':28,149,166 '3':39 '4':48 'across':34 'activ':97 'address':72 'agent':7,24,38,60,63,142,145,156,158,165,180,186,201,202,204,205 'aggreg':6,32,55 'arg':184,187 'argjson':200 'bash':65,80,92,108,119 'byte':102 'collect':4,53 'command':61 'connect':10,44,85,88,91,95,98 'count':45 'custom':13,106 'd':127 'daemon':228 'dashboard':118 'data':181,203 'data.results':175 'data.trusted':153 'date':124,134 'depend':218 'done':217 'dt':138 'echo':132,170 'event':14 'exampl':115 'file':122,144,207,209,213,216 'fleet':36,116 'get':62,77,90 'h':128,139 'health':25,117 'hostnam':73,154,185,191,192 'id':71 'info':64,68 'jq':151,173,182,199,224 'json':67,82,94,110,131,147,163 'list':79,84,96 'm':126,129,137,140 'metric':3,8,33,52,56,107,112 'monitor':23 'ms':169,178,190,194 'mv':211 'n':183 'need':21,30,41,50 'node':70 'null':179 'onlin':198 'output':121,143,206,208,212,215 'peer':11,78,83,86 'perform':27 'pilot':2,51,58,221 'pilot-metr':1 'pilot-protocol':220 'pilotctl':66,81,93,109,146,162 'ping':160,164,171 'polo':75 'port':101 'protocol':59,222 'r':152,174 'requir':219 'result':161,172 'return':69 'rtt':46,168,177,188,189,193,195 'run':227 'score':76 'sent/received':103 'skill':17,223 'skill-pilot-metrics' 'source-teoslayer' 'state':100 'status':197 'subscrib':104,111 'sz':141 'throughput':47 'time':89 'timeout':113 'timestamp':133 'tmp':210,214 'tonumb':196 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'track':43 'trust':148 'u':135 'uptim':74 'use':15 'workflow':114 'y':125,136","prices":[{"id":"78d920b3-13cf-4fd6-9ef6-964ced97f785","listingId":"8ac15a13-c215-4e5a-858e-01cbabd4d12e","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.982Z"}],"sources":[{"listingId":"8ac15a13-c215-4e5a-858e-01cbabd4d12e","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-metrics","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-metrics","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:43.982Z","lastSeenAt":"2026-05-18T19:14:58.383Z"}],"details":{"listingId":"8ac15a13-c215-4e5a-858e-01cbabd4d12e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-metrics","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":"5a47f14cf4ad520653eafed4c97bba65193b570a","skill_md_path":"skills/pilot-metrics/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-metrics"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-metrics","license":"AGPL-3.0","description":"Collect and aggregate agent metrics from connections, peers, and custom events.  Use this skill when: 1. You need to monitor agent health and performance 2. You need to aggregate metrics across a fleet of agents 3. You need to track connection counts, RTT, throughput 4. You need to export metrics to monitoring systems  Do NOT use this skill when: - You need application-level metrics (publish custom events instead) - You need persistent storage (use pilot-event-log for raw data) - You need real-time alerting (use pilot-alert instead)","compatibility":"Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start). Requires jq for JSON processing."},"skills_sh_url":"https://skills.sh/TeoSlayer/pilot-skills/pilot-metrics"},"updatedAt":"2026-05-18T19:14:58.383Z"}}