Spotify
/Spotify
Steruje kontem Spotify przez CLI: wyszukuje utwory, zarządza playlistami, biblioteką i odtwarzaniem na urządzeniach.
- Autor
- danielmiessler ↗
- Repozytorium
- LifeOS ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 05.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 7
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: Tools/EnvText.ts, Tools/Spotify.ts
Co robi i kiedy
Steruje kontem Spotify przez CLI: wyszukuje utwory, zarządza playlistami, biblioteką i odtwarzaniem na urządzeniach.
Oryginalny opis (EN)
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).
Jak działa
- Ideal State
- Intent Routing
- Data & Config
- Gotchas
- Examples
Podgląd SKILL.md
---
metadata:
short-description: "Search Spotify, manage playlists and library, queue tracks, and control playback. Use a music-taste skill for recommendations and a song-generation skill to create songs."
name: Spotify
evals:
manual:
reason: "Spotify actions change the principal's account and playback state, so live writes are not a routine verifier"
falsifier: "the provider state after an approved action differs from the requested playlist, library, queue, device, or playback change"
version: 1.0.8
description: 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.
```bash
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
| Intent | Trigger | File |
|--------|---------|------|
| **Authorize** | "set up spotify", "authorize spotify", "connect spotify", auth broken | `Intents/Authorize.md` |
| **Manage** | play / search / playlists / queue / library ops | `Intents/Manage.md` |
| File | Read when |
|------|-----------|
| `Setup.md` | first-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](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
- **`search` works before user auth** (client-credentials fallback); every other command needs the refresh token.
- **401 on every call** → the refresh token died (password change, revoked access); re-run `auth` (`Intents/Authorize.md`). The tool persists rotated refresh tokens automatically.
- **`/me/playlists` returns `tracks: null` on playlist rows (observed)** — never assume `tracks.total` exists; the CLI omits the count when absent.
## Examples
- "Add this playlist link to my Spotify" → Manage → the playlist is followed with `follow-playlist --id <ID>` (ID from the URL) and shows in `playlists`.
- "Make me a focus-music playlist and fill it" → Manage → a new playlist from `create-playlist`, holding the tracks `search` resolved, added with `add-tracks`.
- "What's playing?" → Manage → the `now-playing` result.
- "Skip this / turn it down" → Manage → `next` / `volume --percent 30` on the active Premium device.
Pliki w paczce (7)
- SKILL.md 4 KB
- Setup.md 3 KB
- Intents/Authorize.md 2 KB
- Intents/Manage.md 2 KB
- Tools/EnvText.ts 1 KB
- Tools/Spotify.help.md 1 KB
- Tools/Spotify.ts 15 KB
Wersje
W bazie nie ma innych skilli o nazwie Spotify.
Migawka bazy z 13.11.2026 · wersja paczki 5bbd2c3e002a (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100controlling-spotify
Steruje odtwarzaniem Spotify i zarządza playlistami przez serwer MCP: puszcza muzykę, wyszukuje utwory, tworzy playlisty i porządkuje bibliotekę. - 95community-spotify
Steruje Spotify: odtwarza muzykę, szuka utworów, zarządza playlistami i biblioteką oraz sprawdza stan odtwarzania. - 95now-playing
Steruje muzyką w Spotify lub Apple Music: odtwarza, pauzuje, przewija, zmienia głośność i tryb losowania. - 100spotify-hub
Steruje odtwarzaniem Spotify przez Python i spotipy: pauza, pomijanie, głośność, losowość, wyszukiwanie i miksy playlist z haseł. - 95argentos-spotify
Steruje Spotify: odtwarzanie i pauza, wyszukiwanie w katalogu, zarządzanie playlistami i biblioteką oraz podgląd stanu odtwarzania. - 100classical-887
Sprawdza, co gra w stacji WRHV 88.7 FM (Classical WMHT), pobiera ostatnie utwory, tworzy raporty playlist, szuka utworów i zarządza playlistami Spotify z utworów z radia.