← SpotifyCONTENT HISTORY

Update to Spotify

Snapshot Nov 18, 2026 · 18:11 UTC · version 4.4.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Spotify and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Controls Spotify playback, devices, and the queue. Use for play, pause, resume, skip, seek, shuffle, repeat, volume, queueing, switching devices, and questions about the queue, devices, or shuffle and repeat state. Excludes finding content (search-spotify), identifying the current track (now-playing), and library changes (manage-library).",
  "included_files": [],
  "name": "control-playback",
  "skill_md_contents": "---\nname: control-playback\ndescription: Controls Spotify playback, devices, and the queue. Use for play, pause, resume, skip, seek, shuffle, repeat, volume, queueing, switching devices, and questions about the queue, devices, or shuffle and repeat state. Excludes finding content (search-spotify), identifying the current track (now-playing), and library changes (manage-library).\n---\n\n# Control Spotify playback\n\nExplicit user instructions take priority over this guidance.\n\n## Pick the tool\n\n| Request                                                     | Tool                                                   |\n| ----------------------------------------------------------- | ------------------------------------------------------ |\n| \"Play X\", \"put on some jazz\"                                | `start_playback` with the entity's `playback.play_uri` |\n| \"Pause\", \"stop the music\"                                   | `pause_playback`                                       |\n| \"Resume\", \"keep playing\"                                    | `resume_playback`                                      |\n| \"Next song\", \"skip\"                                         | `skip_to_next`                                         |\n| \"Previous song\", \"go back\"                                  | `skip_to_previous`                                     |\n| \"Jump to 2:30\", \"start this episode from the beginning\"     | `seek_to_position`                                     |\n| \"Shuffle on/off\"                                            | `set_shuffle`                                          |\n| \"Repeat this song\", \"repeat the album\", \"stop repeating\"    | `set_repeat` with `TRACK`, `CONTEXT`, or `OFF`         |\n| \"Turn it up\", \"volume to 40\"                                | `set_volume`                                           |\n| \"Add this song to my queue\"                                 | `add_to_queue` with the item's `playback.play_uri`     |\n| \"Play this on my kitchen speaker\"                           | `get_devices`, then `transfer_playback`                |\n| \"Is shuffle on?\", \"which device is this on?\", \"how far in?\" | `get_playback_state`                                   |\n| \"What's up next?\", \"show my queue\"                          | `get_queue`                                            |\n| \"What devices do I have?\"                                   | `get_devices`                                          |\n\nFor \"what's playing?\" alone, use [now-playing](../now-playing/SKILL.md).\n\nOnly call a command tool when the user asks for that action. Never start, pause, skip, or change playback on your own, for example right after a search or a playlist is created.\n\n## Getting something to play\n\n- If you don't have the item yet, find it first with [search-spotify](../search-spotify/SKILL.md). If you hold a catalog URI but no `play_uri`, call `get_entity` to get one (see [browse-collections](../browse-collections/SKILL.md)).\n- Pass `start_playback` `settings` only if the user asked for shuffle or repeat.\n- To queue a whole album or playlist, get its tracks with `get_collection_items` and call `add_to_queue` once per track, in order. For more than 20 tracks, offer to play the collection instead. If a call fails partway, say which tracks were queued, check `get_queue`, and don't re-queue the ones already added.\n\n## Devices\n\n- Omit `target_device_id` unless the user names a device. Then call `get_devices` in the same turn and match the name.\n- If more than one device could fit, or none does, ask. Never pick another device without telling the user.\n\n## Replying\n\n- Commands only confirm that Spotify sent them. Phrase replies as requests (\"Asked Spotify to pause\"), and check the result as the tool description says only when the user needs it.\n- Before naming what is playing after `start_playback`, call `get_playback_state`; Free accounts may get a related mix instead. Attribute playback to Spotify, with the item's Spotify link when you have it.\n\n## Errors\n\n| Error                                                  | Action                                                                                                                                                |\n| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `COMMAND_OUTCOME_UNKNOWN`                              | Check state before retrying. Never repeat a skip or queue add blindly; it can skip twice or add a duplicate.                                          |\n| `NO_ACTIVE_DEVICE`                                     | Offer the error's `deeplink_url` when present so the user can open Spotify. Don't say playback started.                                               |\n| `DEVICE_UNAVAILABLE`                                   | Ask the user to open Spotify on the device, or call `get_devices` and offer another one.                                                              |\n| `PREMIUM_REQUIRED`                                     | Say the action needs Spotify Premium here. Don't retry.                                                                                               |\n| `COMMAND_NOT_ALLOWED`                                  | Spotify blocks this right now, for example during an ad. Say so and don't repeat the same command.                                                    |\n| `COMMAND_NOT_SUPPORTED`                                | The device can't do this. Offer another device from `get_devices`.                                                                                    |\n| `CONTENT_NOT_AVAILABLE`                                | The item can't be played for this user. Offer alternatives; don't retry.                                                                              |\n| `INVALID_ARGUMENT`                                     | If the argument is fixable (a catalog URI instead of a `play_uri`, a position past the end), fix it and retry once. Otherwise say it isn't supported. |\n| `RATE_LIMITED`                                         | Wait briefly, then retry once.                                                                                                                        |\n| `TEMPORARILY_UNAVAILABLE`, `TIMEOUT`, `INTERNAL_ERROR` | Retry once, then tell the user something went wrong.                                                                                                  |\n"
}

SHA-256 of public snapshot: 4b9b3628c1f53ac46154cd20884d22c38bb689011b385b2455df048f7b982fa8