{"id":"11f1c6e7-5382-47dd-beb1-e3cdc9929721","shortId":"VZjqqY","kind":"skill","title":"pilot-service-agents-music","tagline":"Music metadata and lyrics — iTunes search and Lyrics.ovh.  Use this skill when: 1. Searching iTunes for tracks, podcasts, artists 2. Fetching lyrics by artist + title (Lyrics.ovh)  Do NOT use this skill when: - Audio streaming or download — metadata only - Music licensing data","description":"# pilot-service-agents-music\n\nMusic metadata and lyrics — iTunes search and Lyrics.ovh.\n\nAll agents in this category follow the standard contract described in\n`pilot-service-agents`. Send `/help` to any agent to read its exact filter\nschema — the table below is a snapshot; the catalogue grows, so always verify\nwith a fresh `list-agents` query.\n\n## Agents in this category (snapshot)\n\n| Hostname | Description |\n|---|---|\n| `itunes-search` | Apple iTunes search - music, podcasts, apps, movies |\n| `lyrics-ovh` | Song lyrics lookup by artist and title |\n\n## What you can expect\n\n- Fast unauthenticated search across the Apple iTunes catalogue\n\n## What NOT to expect\n\n- Guaranteed lyric-licensing rights — upstream is best-effort\n\n## Commands (same pattern for every agent in the category)\n\n```bash\n# Read an agent's filter contract\npilotctl --json send-message <hostname> --data \"/help\"\npilotctl --json inbox\n\n# Fetch structured data\npilotctl --json send-message <hostname> --data '/data {json filters}'\npilotctl --json inbox\n\n# Natural-language summary (Gemini)\npilotctl --json send-message <hostname> --data '/summary {json filters}'\npilotctl --json inbox\n```\n\n## Response shape\n\n`send-message` returns an ACK envelope immediately (`{\"ack\":\"ACK TEXT N bytes\", \"bytes\":N, \"target\":\"<address>\", \"type\":\"text\"}`). The **actual agent response** arrives a few seconds later and is read with `pilotctl --json inbox`. Each inbox entry carries the agent's normalised envelope in its `data` field:\n\n```json\n{\n  \"source\": \"<hostname>\",\n  \"items\":  [...],\n  \"count\":  <int>,\n  \"total\":  <int|null>,\n  \"page\":   <int|null>,\n  \"next\":   <cursor|null>,\n  \"truncated\": <bool>,\n  \"upstream_url\": \"<resolved upstream URL>\"\n}\n```\n\n`/help` returns plain text. `/summary` returns a Gemini-generated prose string. Free-text queries also return Gemini prose.\n\n## Workflow Example\n\n```bash\n# 1. Fresh discovery — the catalogue grows, never hard-code\npilotctl --json send-message list-agents --data '/data {\"category\":\"music\",\"limit\":20}'\npilotctl --json inbox\n\n# 2. Read the contract of a specific agent\npilotctl --json send-message itunes-search --data '/help'\npilotctl --json inbox\n\n# 3. Query it\npilotctl --json send-message itunes-search --data '/data {\"term\":\"daft punk\",\"entity\":\"song\",\"limit\":3}'\npilotctl --json inbox\n```\n\n## Dependencies\n\nRequires the `pilot-protocol` core skill, the `pilot-service-agents` skill\n(for the general discovery flow), `pilotctl` on PATH, and a running daemon\njoined to network 9.","tags":["pilot","service","agents","music","skills","teoslayer","agent-skills","ai-agents","clawhub","networking","openclaw","overlay-network"],"capabilities":["skill","source-teoslayer","skill-pilot-service-agents-music","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-service-agents-music","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,498 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:15:02.646Z","embedding":null,"createdAt":"2026-05-18T13:22:49.684Z","updatedAt":"2026-05-18T19:15:02.646Z","lastSeenAt":"2026-05-18T19:15:02.646Z","tsv":"'/data':193,323,364 '/help':76,180,281,348 '/summary':210,285 '1':18,304 '2':25,331 '20':327 '3':352,371 '9':404 'ack':223,226,227 'across':139 'actual':237 'agent':4,50,61,74,79,103,105,163,170,238,257,321,338,387 'also':297 'alway':96 'app':120 'appl':115,141 'arriv':240 'artist':24,29,129 'audio':38 'bash':167,303 'best':156 'best-effort':155 'byte':230,231 'carri':255 'catalogu':93,143,308 'categori':64,108,166,324 'code':313 'command':158 'contract':68,173,334 'core':381 'count':268 'cursor':276 'daemon':400 'daft':366 'data':46,179,186,192,209,263,322,347,363 'depend':375 'describ':69 'descript':111 'discoveri':306,392 'download':41 'effort':157 'entiti':368 'entri':254 'envelop':224,260 'everi':162 'exact':83 'exampl':302 'expect':135,147 'fast':136 'fetch':26,184 'field':264 'filter':84,172,195,212 'flow':393 'follow':65 'free':294 'free-text':293 'fresh':100,305 'gemini':203,289,299 'gemini-gener':288 'general':391 'generat':290 'grow':94,309 'guarante':148 'hard':312 'hard-cod':311 'hostnam':110 'immedi':225 'inbox':183,198,215,251,253,330,351,374 'int':270,273 'item':267 'itun':10,20,56,113,116,142,345,361 'itunes-search':112,344,360 'join':401 'json':175,182,188,194,197,205,211,214,250,265,315,329,340,350,356,373 'languag':201 'later':244 'licens':45,151 'limit':326,370 'list':102,320 'list-ag':101,319 'lookup':127 'lyric':9,27,55,123,126,150 'lyric-licens':149 'lyrics-ovh':122 'lyrics.ovh':13,31,59 'messag':178,191,208,220,318,343,359 'metadata':7,42,53 'movi':121 'music':5,6,44,51,52,118,325 'n':229,232 'natur':200 'natural-languag':199 'network':403 'never':310 'next':275 'normalis':259 'null':271,274,277 'ovh':124 'page':272 'path':396 'pattern':160 'pilot':2,48,72,379,385 'pilot-protocol':378 'pilot-service-ag':71,384 'pilot-service-agents-mus':1,47 'pilotctl':174,181,187,196,204,213,249,314,328,339,349,355,372,394 'plain':283 'podcast':23,119 'prose':291,300 'protocol':380 'punk':367 'queri':104,296,353 'read':81,168,247,332 'requir':376 'respons':216,239 'return':221,282,286,298 'right':152 'run':399 'schema':85 'search':11,19,57,114,117,138,346,362 'second':243 'send':75,177,190,207,219,317,342,358 'send-messag':176,189,206,218,316,341,357 'servic':3,49,73,386 'shape':217 'skill':16,36,382,388 'skill-pilot-service-agents-music' 'snapshot':91,109 'song':125,369 'sourc':266 'source-teoslayer' 'specif':337 'standard':67 'stream':39 'string':292 'structur':185 'summari':202 'tabl':87 'target':233 'term':365 'text':228,235,284,295 'titl':30,131 'topic-agent-skills' 'topic-ai-agents' 'topic-clawhub' 'topic-networking' 'topic-openclaw' 'topic-overlay-network' 'topic-p2p' 'topic-pilot-protocol' 'total':269 'track':22 'truncat':278 'type':234 'unauthent':137 'upstream':153,279 'url':280 'use':14,34 'verifi':97 'workflow':301","prices":[{"id":"ebe46436-72a2-4369-aab8-77d8cd81a9cf","listingId":"11f1c6e7-5382-47dd-beb1-e3cdc9929721","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:49.684Z"}],"sources":[{"listingId":"11f1c6e7-5382-47dd-beb1-e3cdc9929721","source":"github","sourceId":"TeoSlayer/pilot-skills/pilot-service-agents-music","sourceUrl":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-service-agents-music","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:49.684Z","lastSeenAt":"2026-05-18T19:15:02.646Z"}],"details":{"listingId":"11f1c6e7-5382-47dd-beb1-e3cdc9929721","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"TeoSlayer","slug":"pilot-service-agents-music","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":"4955cb843a0d1bde6b595e77be79522daf2c323d","skill_md_path":"skills/pilot-service-agents-music/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/TeoSlayer/pilot-skills/tree/main/skills/pilot-service-agents-music"},"layout":"multi","source":"github","category":"pilot-skills","frontmatter":{"name":"pilot-service-agents-music","license":"AGPL-3.0","description":"Music metadata and lyrics — iTunes search and Lyrics.ovh.  Use this skill when: 1. Searching iTunes for tracks, podcasts, artists 2. Fetching lyrics by artist + title (Lyrics.ovh)  Do NOT use this skill when: - Audio streaming or download — metadata only - Music licensing data","compatibility":"Requires pilot-protocol skill, pilotctl binary on PATH, a running daemon joined to network 9 (data-exchange), and the `list-agents` directory agent reachable on the overlay."},"skills_sh_url":"https://skills.sh/TeoSlayer/pilot-skills/pilot-service-agents-music"},"updatedAt":"2026-05-18T19:15:02.646Z"}}