[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74F5P9NSMEM4A6TYM3JANBZ":3,"skill-same:01M74F5P9NSMEM4A6TYM3JANBZ":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":14,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":53,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M74F5P9NSMEM4A6TYM3JANBZ","spotify",null,"Spotify: play, search, queue, manage playlists and devices.","aniruddhaadak80\u002Fherclew","aniruddhaadak80","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F127435065?v=4","01M74EJ1XW3EF2EYN26PFN1TG8","ANIRUDDHA ADAK","01M74EJ1YFT2GM6APEHR1CTTVF",0,"MIT","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fmedia\u002Fspotify\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: spotify\ndescription: \"Spotify: play, search, queue, manage playlists and devices.\"\nversion: 1.0.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nprerequisites:\n  tools: [spotify_playback, spotify_devices, spotify_queue, spotify_search, spotify_playlists, spotify_albums, spotify_library]\nmetadata:\n  hermes:\n    tags: [spotify, music, playback, playlists, media]\n    related_skills: [gif-search]\n---\n\n# Spotify\n\nControl the user's Spotify account via the Hermes Spotify toolset (7 tools). Setup guide: https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Fspotify\n\n## When to use this skill\n\nThe user says something like \"play X\", \"pause\", \"skip\", \"queue up X\", \"what's playing\", \"search for X\", \"add to my X playlist\", \"make a playlist\", \"save this to my library\", etc.\n\n## The 7 tools\n\n- `spotify_playback` — play, pause, next, previous, seek, set_repeat, set_shuffle, set_volume, get_state, get_currently_playing, recently_played\n- `spotify_devices` — list, transfer\n- `spotify_queue` — get, add\n- `spotify_search` — search the catalog\n- `spotify_playlists` — list, get, create, add_items, remove_items, update_details\n- `spotify_albums` — get, tracks\n- `spotify_library` — list\u002Fsave\u002Fremove with `kind: \"tracks\"|\"albums\"`\n\nPlayback-mutating actions require Spotify Premium; search\u002Flibrary\u002Fplaylist ops work on Free.\n\n## Canonical patterns (minimize tool calls)\n\n### \"Play \u003Cartist\u002Ftrack\u002Falbum>\"\nOne search, then play by URI. Do NOT loop through search results describing them unless the user asked for options.\n\n```\nspotify_search({\"query\": \"miles davis kind of blue\", \"types\": [\"album\"], \"limit\": 1})\n→ got album URI spotify:album:1weenld61qoidwYuZ1GESA\nspotify_playback({\"action\": \"play\", \"context_uri\": \"spotify:album:1weenld61qoidwYuZ1GESA\"})\n```\n\nFor \"play some \u003Cartist>\" (no specific song), prefer `types: [\"artist\"]` and play the artist context URI — Spotify handles smart shuffle. If the user says \"the song\" or \"that track\", search `types: [\"track\"]` and pass `uris: [track_uri]` to play.\n\n### \"What's playing?\" \u002F \"What am I listening to?\"\nSingle call — don't chain get_state after get_currently_playing.\n\n```\nspotify_playback({\"action\": \"get_currently_playing\"})\n```\n\nIf it returns 204\u002Fempty (`is_playing: false`), tell the user nothing is playing. Don't retry.\n\n### \"Pause\" \u002F \"Skip\" \u002F \"Volume 50\"\nDirect action, no preflight inspection needed.\n\n```\nspotify_playback({\"action\": \"pause\"})\nspotify_playback({\"action\": \"next\"})\nspotify_playback({\"action\": \"set_volume\", \"volume_percent\": 50})\n```\n\n### \"Add to my \u003Cplaylist name> playlist\"\n1. `spotify_playlists list` to find the playlist ID by name\n2. Get the track URI (from currently playing, or search)\n3. `spotify_playlists add_items` with the playlist_id and URIs\n\n```\nspotify_playlists({\"action\": \"list\"})\n→ found \"Late Night Jazz\" = 37i9dQZF1DX4wta20PHgwo\nspotify_playback({\"action\": \"get_currently_playing\"})\n→ current track uri = spotify:track:0DiWol3AO6WpXZgp0goxAV\nspotify_playlists({\"action\": \"add_items\",\n                   \"playlist_id\": \"37i9dQZF1DX4wta20PHgwo\",\n                   \"uris\": [\"spotify:track:0DiWol3AO6WpXZgp0goxAV\"]})\n```\n\n### \"Create a playlist called X and add the last 3 songs I played\"\n```\nspotify_playback({\"action\": \"recently_played\", \"limit\": 3})\nspotify_playlists({\"action\": \"create\", \"name\": \"Focus 2026\"})\n→ got playlist_id back in response\nspotify_playlists({\"action\": \"add_items\", \"playlist_id\": \u003Cid>, \"uris\": [\u003C3 uris>]})\n```\n\n### \"Save \u002F unsave \u002F is this saved?\"\nUse `spotify_library` with the right `kind`.\n\n```\nspotify_library({\"kind\": \"tracks\", \"action\": \"save\", \"uris\": [\"spotify:track:...\"]})\nspotify_library({\"kind\": \"albums\", \"action\": \"list\", \"limit\": 50})\n```\n\n### \"Transfer playback to my \u003Cdevice>\"\n```\nspotify_devices({\"action\": \"list\"})\n→ pick the device_id by matching name\u002Ftype\nspotify_devices({\"action\": \"transfer\", \"device_id\": \"\u003Cid>\", \"play\": true})\n```\n\n## Critical failure modes\n\n**`403 Forbidden — No active device found`** on any playback action means Spotify isn't running anywhere. Tell the user: \"Open Spotify on your phone\u002Fdesktop\u002Fweb player first, start any track for a second, then retry.\" Don't retry the tool call blindly — it will fail the same way. You can call `spotify_devices list` to confirm; an empty list means no active device.\n\n**`403 Forbidden — Premium required`** means the user is on Free and tried to mutate playback. Don't retry; tell them this action needs Premium. Reads still work (search, playlists, library, get_state).\n\n**`204 No Content` on `get_currently_playing`** is NOT an error — it means nothing is playing. The tool returns `is_playing: false`. Just report that to the user.\n\n**`429 Too Many Requests`** = rate limit. Wait and retry once. If it keeps happening, you're looping — stop.\n\n**`401 Unauthorized` after a retry** — refresh token revoked. Tell the user to run `hermes auth spotify` again.\n\n## URI and ID formats\n\nSpotify uses three interchangeable ID formats. The tools accept all three and normalize:\n\n- URI: `spotify:track:0DiWol3AO6WpXZgp0goxAV` (preferred)\n- URL: `https:\u002F\u002Fopen.spotify.com\u002Ftrack\u002F0DiWol3AO6WpXZgp0goxAV`\n- Bare ID: `0DiWol3AO6WpXZgp0goxAV`\n\nWhen in doubt, use full URIs. Search results return URIs in the `uri` field — pass those directly.\n\nEntity types: `track`, `album`, `artist`, `playlist`, `show`, `episode`. Use the right type for the action — `spotify_playback.play` with a `context_uri` expects album\u002Fplaylist\u002Fartist; `uris` expects an array of track URIs.\n\n## What NOT to do\n\n- **Don't call `get_state` before every action.** Spotify accepts play\u002Fpause\u002Fskip without preflight. Only inspect state when the user asked \"what's playing\" or you need to reason about device\u002Ftrack.\n- **Don't describe search results unless asked.** If the user said \"play X\", search, grab the top URI, play it. They'll hear it's wrong if it's wrong.\n- **Don't retry on `403 Premium required` or `403 No active device`.** Those are permanent until user action.\n- **Don't use `spotify_search` to find a playlist by name** — that searches the public Spotify catalog. User playlists come from `spotify_playlists list`.\n- **Don't mix `kind: \"tracks\"` with album URIs** in `spotify_library` (or vice versa). The tool normalizes IDs but the API endpoint differs.\n","# Spotify\n\nControl the user's Spotify account via the Hermes Spotify toolset (7 tools). Setup guide: https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Fspotify\n\n## When to use this skill\n\nThe user says something like \"play X\", \"pause\", \"skip\", \"queue up X\", \"what's playing\", \"search for X\", \"add to my X playlist\", \"make a playlist\", \"save this to my library\", etc.\n\n## The 7 tools\n\n- `spotify_playback` — play, pause, next, previous, seek, set_repeat, set_shuffle, set_volume, get_state, get_currently_playing, recently_played\n- `spotify_devices` — list, transfer\n- `spotify_queue` — get, add\n- `spotify_search` — search the catalog\n- `spotify_playlists` — list, get, create, add_items, remove_items, update_details\n- `spotify_albums` — get, tracks\n- `spotify_library` — list\u002Fsave\u002Fremove with `kind: \"tracks\"|\"albums\"`\n\nPlayback-mutating actions require Spotify Premium; search\u002Flibrary\u002Fplaylist ops work on Free.\n\n## Canonical patterns (minimize tool calls)\n\n### \"Play \u003Cartist\u002Ftrack\u002Falbum>\"\nOne search, then play by URI. Do NOT loop through search results describing them unless the user asked for options.\n\n```\nspotify_search({\"query\": \"miles davis kind of blue\", \"types\": [\"album\"], \"limit\": 1})\n→ got album URI spotify:album:1weenld61qoidwYuZ1GESA\nspotify_playback({\"action\": \"play\", \"context_uri\": \"spotify:album:1weenld61qoidwYuZ1GESA\"})\n```\n\nFor \"play some \u003Cartist>\" (no specific song), prefer `types: [\"artist\"]` and play the artist context URI — Spotify handles smart shuffle. If the user says \"the song\" or \"that track\", search `types: [\"track\"]` and pass `uris: [track_uri]` to play.\n\n### \"What's playing?\" \u002F \"What am I listening to?\"\nSingle call — don't chain get_state after get_currently_playing.\n\n```\nspotify_playback({\"action\": \"get_currently_playing\"})\n```\n\nIf it returns 204\u002Fempty (`is_playing: false`), tell the user nothing is playing. Don't retry.\n\n### \"Pause\" \u002F \"Skip\" \u002F \"Volume 50\"\nDirect action, no preflight inspection needed.\n\n```\nspotify_playback({\"action\": \"pause\"})\nspotify_playback({\"action\": \"next\"})\nspotify_playback({\"action\": \"set_volume\", \"volume_percent\": 50})\n```\n\n### \"Add to my \u003Cplaylist name> playlist\"\n1. `spotify_playlists list` to find the playlist ID by name\n2. Get the track URI (from currently playing, or search)\n3. `spotify_playlists add_items` with the playlist_id and URIs\n\n```\nspotify_playlists({\"action\": \"list\"})\n→ found \"Late Night Jazz\" = 37i9dQZF1DX4wta20PHgwo\nspotify_playback({\"action\": \"get_currently_playing\"})\n→ current track uri = spotify:track:0DiWol3AO6WpXZgp0goxAV\nspotify_playlists({\"action\": \"add_items\",\n                   \"playlist_id\": \"37i9dQZF1DX4wta20PHgwo\",\n                   \"uris\": [\"spotify:track:0DiWol3AO6WpXZgp0goxAV\"]})\n```\n\n### \"Create a playlist called X and add the last 3 songs I played\"\n```\nspotify_playback({\"action\": \"recently_played\", \"limit\": 3})\nspotify_playlists({\"action\": \"create\", \"name\": \"Focus 2026\"})\n→ got playlist_id back in response\nspotify_playlists({\"action\": \"add_items\", \"playlist_id\": \u003Cid>, \"uris\": [\u003C3 uris>]})\n```\n\n### \"Save \u002F unsave \u002F is this saved?\"\nUse `spotify_library` with the right `kind`.\n\n```\nspotify_library({\"kind\": \"tracks\", \"action\": \"save\", \"uris\": [\"spotify:track:...\"]})\nspotify_library({\"kind\": \"albums\", \"action\": \"list\", \"limit\": 50})\n```\n\n### \"Transfer playback to my \u003Cdevice>\"\n```\nspotify_devices({\"action\": \"list\"})\n→ pick the device_id by matching name\u002Ftype\nspotify_devices({\"action\": \"transfer\", \"device_id\": \"\u003Cid>\", \"play\": true})\n```\n\n## Critical failure modes\n\n**`403 Forbidden — No active device found`** on any playback action means Spotify isn't running anywhere. Tell the user: \"Open Spotify on your phone\u002Fdesktop\u002Fweb player first, start any track for a second, then retry.\" Don't retry the tool call blindly — it will fail the same way. You can call `spotify_devices list` to confirm; an empty list means no active device.\n\n**`403 Forbidden — Premium required`** means the user is on Free and tried to mutate playback. Don't retry; tell them this action needs Premium. Reads still work (search, playlists, library, get_state).\n\n**`204 No Content` on `get_currently_playing`** is NOT an error — it means nothing is playing. The tool returns `is_playing: false`. Just report that to the user.\n\n**`429 Too Many Requests`** = rate limit. Wait and retry once. If it keeps happening, you're looping — stop.\n\n**`401 Unauthorized` after a retry** — refresh token revoked. Tell the user to run `hermes auth spotify` again.\n\n## URI and ID formats\n\nSpotify uses three interchangeable ID formats. The tools accept all three and normalize:\n\n- URI: `spotify:track:0DiWol3AO6WpXZgp0goxAV` (preferred)\n- URL: `https:\u002F\u002Fopen.spotify.com\u002Ftrack\u002F0DiWol3AO6WpXZgp0goxAV`\n- Bare ID: `0DiWol3AO6WpXZgp0goxAV`\n\nWhen in doubt, use full URIs. Search results return URIs in the `uri` field — pass those directly.\n\nEntity types: `track`, `album`, `artist`, `playlist`, `show`, `episode`. Use the right type for the action — `spotify_playback.play` with a `context_uri` expects album\u002Fplaylist\u002Fartist; `uris` expects an array of track URIs.\n\n## What NOT to do\n\n- **Don't call `get_state` before every action.** Spotify accepts play\u002Fpause\u002Fskip without preflight. Only inspect state when the user asked \"what's playing\" or you need to reason about device\u002Ftrack.\n- **Don't describe search results unless asked.** If the user said \"play X\", search, grab the top URI, play it. They'll hear it's wrong if it's wrong.\n- **Don't retry on `403 Premium required` or `403 No active device`.** Those are permanent until user action.\n- **Don't use `spotify_search` to find a playlist by name** — that searches the public Spotify catalog. User playlists come from `spotify_playlists list`.\n- **Don't mix `kind: \"tracks\"` with album URIs** in `spotify_library` (or vice versa). The tool normalizes IDs but the API endpoint differs.\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":35,"description":7,"prerequisites":39},"Hermes Agent","1.0.0",{"hermes":27},{"tags":28,"related_skills":33},[5,29,30,31,32],"music","playback","playlists","media",[34],"gif-search",[36,37,38],"linux","macos","windows",{"tools":40},[41,42,43,44,45,46,47],"spotify_playback","spotify_devices","spotify_queue","spotify_search","spotify_playlists","spotify_albums","spotify_library","main","ff3476b880e3f7eddb4ffe2b62141766402e972b","core-agent\u002Fskills\u002Fmedia\u002Fspotify","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80","https:\u002F\u002Faniruddha-adak.vercel.app","I build agentic harnesses and production-grade agent skills. \r\n\r\nContributor :) @genspark-ai @CopilotKit @openclaw @NousResearch  @synthetic-sciences @PriorLabs","2026-11-14 20:45:37",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add aniruddhaadak80\u002Fherclew --skill spotify",{"tool":62,"command":63},"bunx","bunx skills add aniruddhaadak80\u002Fherclew --skill spotify",{"tool":65,"command":66},"pnpm","pnpm dlx skills add aniruddhaadak80\u002Fherclew --skill spotify","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fmedia\u002Fspotify\u002FSKILL.md",true,[],[71,80,88,95,102,109],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":75,"licenseFileUrl":76,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M74FJW4M7QZ5KZHYH1W3SYET","skill-creator","Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fgateway-node\u002Fskills\u002Fsoftware-development\u002Fskill-creator\u002Flicense.txt","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fgateway-node\u002Fskills\u002Fsoftware-development\u002Fskill-creator\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":84,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M74FDY7EK673NW905BRFR3ZD","prose","OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fgateway-node\u002Fextensions\u002Fopen-prose\u002Fskills\u002Fprose\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fgateway-node\u002Fextensions\u002Fopen-prose\u002Fskills\u002Fprose\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M74FAMG647DMCPE12FZE3PKF","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fsoftware-development\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M74FAHVK9XY77HSP589QYQYB","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M74FAECYXZ2DQXQSQ44FHZJZ","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M74FABCBB1Z2Y5F67699RPX6","subagent-driven-development","Execute plans via delegate_task subagents (2-stage review).","https:\u002F\u002Fgithub.com\u002Faniruddhaadak80\u002Fherclew\u002Fblob\u002Fmain\u002Fcore-agent\u002Fskills\u002Fsoftware-development\u002Fsubagent-driven-development\u002FSKILL.md",[],[]]