[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FS07VTQNTQDQFCPZFMG8H":3,"skill-same:01M74FS07VTQNTQDQFCPZFMG8H":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":13,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":48,"install":49,"resources":62},"01M74FS07VTQNTQDQFCPZFMG8H","spotify",null,"Spotify: play, search, queue, manage playlists and devices.","LyrikNilpferd71\u002FHermes-Backup","LyrikNilpferd71","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F187173780?v=4","01M727S8GPB77P0S9ECRRMZT58","01M727S8HF63B0MD53F496MK1V",0,"MIT","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-05-19T14-00-56+0200\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\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":23,"license":14,"version":24,"metadata":25,"description":7,"prerequisites":34},"Hermes Agent","1.0.0",{"hermes":26},{"tags":27,"related_skills":32},[5,28,29,30,31],"music","playback","playlists","media",[33],"gif-search",{"tools":35},[36,37,38,39,40,41,42],"spotify_playback","spotify_devices","spotify_queue","spotify_search","spotify_playlists","spotify_albums","spotify_library","main","404fd33aabef3b6bc1cc913117ba2160ade62625","snapshots\u002F2026-05-19T14-00-56+0200\u002Fskills\u002Fmedia\u002Fspotify","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71","2026-11-08 20:00:57",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add LyrikNilpferd71\u002FHermes-Backup --skill spotify",{"tool":55,"command":56},"bunx","bunx skills add LyrikNilpferd71\u002FHermes-Backup --skill spotify",{"tool":58,"command":59},"pnpm","pnpm dlx skills add LyrikNilpferd71\u002FHermes-Backup --skill spotify","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-05-19T14-00-56+0200\u002Fskills\u002Fmedia\u002Fspotify\u002FSKILL.md",true,[],[64,72,79,86,93,100],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":71},"01M76BBCCNA7WQ82Q8QNZH8PBK","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fwriting-plans\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":71},"01M76BB8YS41CA3NKW0YMSSB88","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":71},"01M76BB680FPNT998E1GM2QW10","subagent-driven-development","Execute plans via delegate_task subagents (2-stage review).","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fsubagent-driven-development\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":71},"01M76BB3C4ZB9S4RWPMM8MX0YB","plan","Write a markdown plan to .hermes\u002Fplans\u002F; no execution.","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fplan\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":71},"01M76BB0NK28KMP51YDB5R3EXA","hermes-agent-skill-authoring","Author in-repo SKILL.md files: frontmatter and structure.","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fhermes-agent-skill-authoring\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":71},"01M76BAYV58H0CKNSTZE3ZH4NY","debugging-hermes-tui-commands","Debug Hermes TUI slash commands: Python, gateway, Ink UI.","https:\u002F\u002Fgithub.com\u002FLyrikNilpferd71\u002FHermes-Backup\u002Fblob\u002Fmain\u002Fsnapshots\u002F2026-11-08T13-00-51+0100\u002Fskills\u002Fsoftware-development\u002Fdebugging-hermes-tui-commands\u002FSKILL.md",[],[]]