Przejdź do treści
Biblioteka skilli
Produktywność osobista · Integracja z narzędziem

Spotify

/Spotify

Steruje kontem Spotify przez CLI: wyszukuje utwory, zarządza playlistami, biblioteką i odtwarzaniem na urządzeniach.

Repozytorium
LifeOS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Ideal State
  2. Intent Routing
  3. Data & Config
  4. Gotchas
  5. Examples
Sekcje z nagłówków SKILL.md, w oryginale · 44 linii, 434 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.