Guide · Agent skill

How to use the Spotify Player Control agent skill

Updated 2026-10-29 · written with AI from the project's own documentation and checked against our catalogue data

The spotify-player skill teaches your agent to control Spotify through command-line tools on your computer. It is written for Spotify Premium users who want to type music requests to their agent, and for terminal users who already work with spogo or spotify_player. After following this guide you will know what the skill does, how to install it, how to set up its login, and how to ask for music in plain language.

Spotify Player Controlspinabot/brigade · MIT Download the skill

Quick start

1Install spogo or spotify_player. Install spogo from the steipete/tap tap with Homebrew, or install spotify_player with Homebrew. Installing spogo is preferred.
2Unzip the skill into your skills folder. Place the unzipped spotify-player folder in ~/.claude/skills/ for all projects, or in a project's .claude/skills/ folder.
3Import your browser cookies. Run spogo auth import --browser chrome while logged in to Spotify in Chrome.
4Check your playback device. Ask the agent to list devices, or run spogo device list, then set the one you want.
5Make a request. Ask the agent in plain language, for example to play a song or check what is playing.

What does the spotify-player skill make the agent do?

An agent skill is a folder of instructions that an AI agent loads when a task matches it. This skill, from the spinabot/brigade collection, tells the agent to control Spotify through the terminal. Once installed, the agent can search for songs, start or pause playback, skip tracks, list and switch playback devices, and check what is currently playing.

The skill prefers the spogo tool. If spogo is not available, it falls back to spotify_player.

Search for tracks
Play, pause, skip to next, or go to previous track
List playback devices and switch to one
Check what is currently playing
Like a track (spotify_player fallback)

What do you need before installing?

The skill lists four requirements. You need a Spotify Premium account, and either spogo or spotify_player installed. The install steps are written for Homebrew, so you need brew available on your system. For login, spogo needs browser cookies imported into it.

A Spotify Premium account
spogo or spotify_player command-line tool, installed via Homebrew (spogo uses the steipete/tap tap)
Browser cookies imported into spogo for login
Optional: a user client_id in the spotify_player config, for Spotify Connect

How do you install the skill?

Download the ZIP from the skill page and unzip it. The skill folder contains a single file, SKILL.md. Put the unzipped folder in one of these locations:

For all your projects, place it in ~/.claude/skills/. For one project only, place it in that project's .claude/skills/ folder.

You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills.

Personal: ~/.claude/skills/
Single project: .claude/skills/ inside the project folder
Claude apps: Settings → Capabilities → Skills, then upload the ZIP

How do you install spogo or spotify_player?

The skill's metadata lists Homebrew install entries for both tools. spogo is installed from the steipete/tap tap, and spotify_player is installed from its standard Homebrew formula. Install at least one of them. spogo is the preferred tool, so install it first if you can.

spogo: formula spogo, tap steipete/tap
spotify_player: formula spotify_player

spogo auth import --browser chrome

How do you log spogo in with your browser?

spogo logs in by importing cookies from your web browser. The skill's setup command imports them from Chrome. Make sure you are logged in to Spotify in that browser first. The source does not explain how these cookies are stored or protected, so read the Safety section below before running this step.

spogo auth import --browser chrome

Which commands does the agent use?

You do not need to type these yourself, but knowing them helps you check what the agent is doing. For spogo, the skill uses commands for search, playback, devices and status. spotify_player has equivalents for the fallback path.

Search: spogo search track "query"
Playback: spogo play, spogo pause, spogo next, spogo prev
Devices: spogo device list, and spogo device set "<name|id>"
Status: spogo status
Fallback search: spotify_player search "query"
Fallback playback: spotify_player playback play|pause|next|previous
Fallback devices: spotify_player connect
Fallback like: spotify_player like

spogo search track "query"
spogo device list
spogo device set "<name|id>"
spogo status

What people use it for

Asking the agent to play a specific song or artist while you write code in the terminal
Pausing or skipping tracks without leaving your current task
Moving playback to another device listed by spogo device list
Checking the title of the song that is currently playing

Frequently asked questions

Is the spotify-player skill free?

The skill is published under the MIT licence. Spotify itself requires a Premium account for this skill, as listed in its requirements. The source does not state any prices for the tools.

Do I need Spotify Premium to use it?

Yes. The skill's requirements list a Spotify Premium account. Users without Premium are not a good fit for this skill.

How do I install spogo?

Install it with Homebrew from the steipete/tap tap, using the spogo formula. Then run spogo auth import --browser chrome to log in with your Chrome cookies.

What if spogo is not available?

The skill falls back to spotify_player. Install it with Homebrew using the spotify_player formula, and the agent will use its search, playback, connect and like commands.

Is it safe to import browser cookies?

The setup step copies login cookies from your browser into a local tool. The source does not explain how they are stored or protected, so only continue if you are comfortable with that.

Does it work on Windows or Linux without Homebrew?

The install steps are written for brew. If Homebrew is unavailable on your system, the source does not give alternative install steps, so you would need to install spogo or spotify_player another way.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits Spotify Premium users who work in a terminal and want to control music by asking their agent. It is a weaker choice if you do not have Premium, cannot use Homebrew, or are not comfortable importing browser cookies into a local tool.

Download the skill