spotify

Control Spotify playback, search, queues, playlists, and devices via the Hermes toolset.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill spotify-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotify
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/media/spotify
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill spotify-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Spotify through natural language requires knowing which of the seven Spotify tools to call, in what order, and how to recover from common API failures like missing devices or Premium restrictions. This Skill encodes those canonical patterns so playback, search, and playlist requests succeed with minimal tool calls. ## Core Features & Use Cases - Playback Control: Play, pause, skip, seek, shuffle, repeat, and volume adjustment through the spotify_playback tool, plus device listing and transfer. - Search & Library Management: Search the Spotify catalog, save or remove tracks and albums, and create or edit playlists with the correct URI formats. - Failure-Mode Guidance: Explicit handling for 403 no-active-device, 403 Premium-required, 204 empty playback, 429 rate limits, and 401 expired auth. - Use Case: A user says "create a playlist called Focus and add my last 3 played songs" — the Skill fetches recently played tracks, creates the playlist, and adds the track URIs in three tool calls. ## Quick Start Ask the assistant to play a specific artist or album on Spotify, for example by saying "play Kind of Blue by Miles Davis".

Frequently Asked Questions about spotify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play a song or artist on Spotify with a voice or chat command?

Search the Spotify catalog with spotify_search using the right entity type, then pass the returned URI to spotify_playback play. For artists, play the artist context URI; for specific songs, pass the track URI in the uris array.

How do I add the currently playing song to a Spotify playlist?

List your playlists with spotify_playlists to find the playlist ID by name, get the current track URI from spotify_playback get_currently_playing, then call spotify_playlists add_items with the playlist ID and track URI.

Does controlling Spotify playback require Spotify Premium?

Playback-mutating actions like play, pause, skip, and volume require Spotify Premium and return 403 on Free accounts. Search, playlist management, library operations, and reading playback state work on Free accounts.

Why does Spotify playback fail with a 403 no active device error?

The 403 no active device error means Spotify is not running on any device. Open Spotify on a phone, desktop, or web player and start any track briefly, then retry the command; retrying without an active device will fail again.

What Spotify URI formats do the tools accept?

The tools accept full URIs like spotify:track:id, open.spotify.com URLs, and bare IDs, normalizing all three. Full URIs are preferred, and search results return URIs in the uri field ready to pass directly.