← Back to Skills Marketplace
Spotify Skill
by
cdmichaelb
· GitHub ↗
· v1.1.1
· MIT-0
94
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install spotify-agent
Description
Control Spotify playback, search music, manage playlists, generate discovery playlists, and analyze listening habits via the Spotify Web API. Use when asked...
Usage Guidance
This skill appears to do what it says: it uses the Spotify OAuth flow and the Web API to control playback and manage playlists. Before installing: (1) understand you must create a Spotify developer app and supply the client_id and client_secret; (2) the skill saves OAuth tokens and your client credentials to a local config.json (plaintext) in the skill directory — consider using environment variables and restrict file permissions (chmod 600) or remove the file after use; (3) the OAuth scopes requested are broad (playback, modify playlists, read/save library, etc.) — grant only if you accept that access; (4) run the initial auth on a machine you control (it opens a browser and asks you to paste an authorization code), and revoke the app from your Spotify account if you later want to remove access; (5) if you are not comfortable storing client secrets or tokens locally, review or modify the scripts to change storage behavior before use.
Capability Analysis
Type: OpenClaw Skill
Name: spotify-agent
Version: 1.1.1
The Spotify Agent skill provides standard functionality for controlling Spotify playback, searching music, and managing playlists via the Spotify Web API. The implementation in scripts/auth.py and scripts/spotify.py uses Python's standard library to handle OAuth2 flows and API requests, storing credentials locally in a configuration file. There is no evidence of data exfiltration, unauthorized network calls, or malicious command execution; the logic is entirely consistent with the stated purpose of a music management tool.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (Spotify playback, playlists, recommendations) align with the included scripts and SKILL.md. The code calls accounts.spotify.com and api.spotify.com and implements playback, search, playlists, user-data and recommendation features that match the stated capabilities.
Instruction Scope
SKILL.md instructs creating a Spotify app, placing credentials in config.json (or using env vars), running auth.py to perform OAuth, and running spotify.py commands. These instructions stay within the domain of Spotify integration. Note: the skill saves client credentials and OAuth tokens to a local config.json file and will read/override them from environment variables if present — that's expected for this workflow but is sensitive behavior the user should be aware of.
Install Mechanism
No install spec (instruction-only with included scripts). There is no download-from-URL or third-party package install step; all code is contained in the skill bundle.
Credentials
Registry metadata lists no required env vars but the SKILL.md documents optional SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET, and SPOTIFY_REDIRECT_URI overrides; the scripts use these if present and otherwise read config.json. The requested secrets are proportional to the skill's purpose, but they are sensitive (client secret, refresh/access tokens) and are stored in plaintext config.json in the skill directory.
Persistence & Privilege
always is false and the skill does not request elevated or platform-wide persistence. It only writes/reads its own config.json and does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install spotify-agent - After installation, invoke the skill by name or use
/spotify-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
Added env var declarations to metadata (SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET, SPOTIFY_REDIRECT_URI) — scanner flagged credential omission
v1.1.0
Added claw-list discovery playlists, playlist editing, audio features, Feb 2026 API migration fixes
v1.0.1
Fixed env var mismatch: scripts now read SPOTIFY_CLIENT_ID/SECRET/REDIRECT_URI from env vars as overrides. SKILL.md env block corrected to optional.
v1.0.0
Initial release — control Spotify playback, search, manage playlists, get recommendations, and analyze your listening habits via the Spotify Web API.
- Supports playback commands: play, pause, next, previous, seek, volume, shuffle, repeat, device transfer, and queue operations
- Enables searching for tracks, artists, albums, and playlists; discovery through recommendations and new releases
- Playlist management: create playlists and add tracks
- Analyze user habits: retrieve top tracks/artists, recent plays, audio features
- OAuth2 authentication with simple setup and token auto-refresh
- Requires Python 3.8+ and a Spotify Premium account for full functionality
Metadata
Frequently Asked Questions
What is Spotify Skill?
Control Spotify playback, search music, manage playlists, generate discovery playlists, and analyze listening habits via the Spotify Web API. Use when asked... It is an AI Agent Skill for Claude Code / OpenClaw, with 94 downloads so far.
How do I install Spotify Skill?
Run "/install spotify-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Spotify Skill free?
Yes, Spotify Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Spotify Skill support?
Spotify Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Spotify Skill?
It is built and maintained by cdmichaelb (@cdmichaelb); the current version is v1.1.1.
More Skills