Skills

Spotify

Acts on the principal's Spotify account via a deterministic CLI (Tools/Spotify.ts)...

Install

npx skills add danielmiessler/LifeOS --skill Spotify -g -a claude-code -y
Repository
danielmiessler/LifeOS19.7k
Category
Media
Updated
8d ago
License
MIT
Context cost
Lightabout 719 tokens
Runs scripts
Yes, review before use

What it does

Acts on the principal's Spotify account via a deterministic CLI (Tools/Spotify.ts): search, playlists, now-playing, library, and playback across devices. USE WHEN spotify, play on spotify, add to my spotify, follow this playlist, save playlist, create a spotify playlist, add tracks, what's playing, my playlists, queue this, skip track, set volume, spotify search, control spotify, my spotify library. NOT FOR music taste or recommendations, generating songs, editing audio (AudioEditor).

Spotify

Acts on the principal's real Spotify account through Tools/Spotify.ts, a deterministic CLI that calls the Spotify Web API directly. No MCP, no server process, no session registration: any session can invoke it via Bash immediately.

bun ~/.claude/skills/Spotify/Tools/Spotify.ts <command> [flags]   # --help for the full list

Ideal State

  • Every requested account change (follow, playlist build, library read, queue, playback) is one Tools/Spotify.ts call keyed by IDs or URIs, and the account state afterwards matches the request.
  • Auth is set up once and never repeated by hand: tokens refresh per invocation, and a dead token or redirect mismatch is traced to its real fix (re-run auth, or fix the dashboard URI).
  • Playback is attempted only on a Premium account with an active device, so a Free account still gets search, playlists and library.

Intent Routing

IntentTriggerFile
Authorize"set up spotify", "authorize spotify", "connect spotify", auth brokenIntents/Authorize.md
Manageplay / search / playlists / queue / library opsIntents/Manage.md
FileRead when
Setup.mdfirst-time install: the developer app, the three .env keys, the proof command
Tools/Spotify.help.md is the full flag reference (same as --help); EnvText.ts is the pure env-file helper Spotify.ts writes tokens with

Data & Config

This skill reads no files under LIFEOS/USER/. Credentials are env-only: SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET and SPOTIFY_REFRESH_TOKEN in ~/.claude/.env (names only here, never values). First-time setup, the Spotify developer app and the proof command are in Setup.md. Tokens auto-refresh per invocation; a missing refresh token means run Intents/Authorize.md. With the credentials missing, the tool exits 1 and points at Setup.md.

Gotchas

Read the whole SKILL.md on GitHub

More in Media