⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

spotify-manager

justinchuby-bot@justinchuby-bot⭐ 0 stars· last commit 7mo ago· 0 open issues

Control Spotify — search, playlists, playback, library, user data. Use when user asks to play music, create playlists, search for tracks/albums/artists, control playback (play/pause/skip/queue), manage their Spotify library (save/remove), or view listening history (top tracks, recently played). Requires user to complete OAuth setup first.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 0 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

spotify-manager-skill

A Spotify skill for OpenClaw — search, playlists, playback control, library management, and listening history.

Fully compliant with Spotify's February 2026 API changes.

Features

  • Search — tracks, albums, artists
  • Playback — play, pause, skip, queue, now playing, devices
  • Playlists — create, list, add/remove items
  • Library — save/remove any item type (unified endpoint)
  • User data — top tracks/artists, recently played

Install

clawhub install justinchuby-bot/spotify-manager-skill

Or manually copy the spotify-manager/ folder into your OpenClaw skills directory (~/.openclaw/skills/ or <workspace>/skills/).

Setup

  1. Create a Spotify app at developer.spotify.com/dashboard

    • Click Create app
    • App name: anything you like (e.g. "My OpenClaw")
    • App description: anything (e.g. "Personal Spotify control")
    • Redirect URI: http://127.0.0.1:8888/callback — click Add
    • Which API/SDKs are you planning to use? Select Web API
    • Check the ToS box and click Save
    • Go to Settings → copy your Client ID and Client Secret (click "View client secret")
    • Go to Settings → User Management → add your Spotify account email (required for Dev Mode apps to work)
  2. Save credentials:

    cat > ~/.openclaw/.spotify-credentials << 'EOF'
    SPOTIFY_CLIENT_ID=your_client_id
    SPOTIFY_CLIENT_SECRET=your_client_secret
    EOF
    chmod 600 ~/.openclaw/.spotify-credentials
    
  3. Authenticate:

    python3 spotify-manager/scripts/spotify-auth.py --credentials ~/.openclaw/.spotify-credentials
    

    Opens a browser for OAuth. Tokens are saved to ~/.openclaw/.spotify-token.json.

Quick Test

python3 spotify-manager/scripts/spotify_api.py search "Bohemian Rhapsody"
python3 spotify-manager/scripts/spotify_api.py now-playing
python3 spotify-manager/scripts/spotify_api.py playlists
python3 spotify-manager/scripts/spotify_api.py top-tracks
python3 spotify-manager/scripts/spotify_api.py save spotify:track:6rqhFgbbKwnb9MLmUQDhG6

Requirements

  • Python 3.7+ (stdlib only — no pip dependencies)
  • Spotify Premium (required for playback control and Dev Mode apps)
  • Linux or macOS

Feb 2026 API Changes

This skill is fully updated for Spotify's February 2026 breaking changes:

  • Playlist endpoints: /tracks → /items
  • Library endpoints: unified PUT/DELETE /me/library with Spotify URIs
  • Search limit reduced to 10 per request
  • Many batch/browse endpoints removed

See spotify-manager/references/api-changes-2026.md for full details.

License

MIT

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • spotify-manager/SKILL.md4.2 KBupstream ↗
    ---
    name: spotify-manager
    description: Control Spotify — search, playlists, playback, library, user data. Use when user asks to play music, create playlists, search for tracks/albums/artists, control playback (play/pause/skip/queue), manage their Spotify library (save/remove), or view listening history (top tracks, recently played). Requires user to complete OAuth setup first.
    ---
    
    # Spotify
    
    Control Spotify via the Web API. All operations use `scripts/spotify_api.py` (stdlib only, no pip deps).
    
    ## Setup
    
    Before first use, the user must:
    
    1. **Create a Spotify app** at <https://developer.spotify.com/dashboard>
       - Set redirect URI to `http://127.0.0.1:8888/callback`
       - Note the Client ID and Client Secret
       - **Add their Spotify email** in Settings → User Management
    
    2. **Save credentials** to `~/.openclaw/.spotify-credentials`:
       ```
       SPOTIFY_CLIENT_ID=your_client_id
       SPOTIFY_CLIENT_SECRET=your_client_secret
       ```
       Then `chmod 600 ~/.openclaw/.spotify-credentials`.
    
    3. **Run the auth flow** (requires browser access):
       ```bash
       python3 scripts/spotify-auth.py --credentials ~/.openclaw/.spotify-credentials
       ```
       This saves tokens to `~/.openclaw/.spotify-token.json`.
    
    If setup is not done, guide the user through these steps. The auth flow needs a browser — if running headless, print the URL for the user to open manually.
    
    ## Dev Mode Limitations (Feb 2026)
    
    - Premium required for the app owner
    - Max 5 authorized users
    - 1 client ID per developer account
    - Many endpoints removed or renamed — see `references/api-changes-2026.md`
    
    ## CLI Usage
    
    ```bash
    python3 scripts/spotify_api.py search "Bohemian Rhapsody"
    python3 scripts/spotify_api.py now-playing
    python3 scripts/spotify_api.py play | pause | skip | previous
    python3 scripts/spotify_api.py queue "spotify:track:xxx"
    python3 scripts/spotify_api.py devices
    python3 scripts/spotify_api.py playlists
    python3 scripts/spotify_api.py create-playlist "My Playlist" --description "desc"
    python3 scripts/spotify_api.py add-to-playlist PLAYLIST_ID spotify:track:xxx
    python3 scripts/spotify_api.py remove-from-playlist PLAYLIST_ID spotify:track:xxx
    python3 scripts/spotify_api.py top-tracks [--range short_term|medium_term|long_term]
    python3 scripts/spotify_api.py top-artists [--range short_term|medium_term|long_term]
    python3 scripts/spotify_api.py recent
    python3 scripts/spotify_api.py save spotify:track:xxx spotify:album:yyy
    python3 scripts/spotify_api.py unsave spotify:track:xxx
    ```
    
    ## Module Usage
    
    ```python
    import importlib.util, sys, pathlib
    spec = importlib.util.spec_from_file_location("spotify_api", pathlib.Path(__file__).parent / "scripts/spotify_api.py")
    spotify = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(spotify)
    
    results = spotify.search("Daft Punk", types="track", limit=5)
    spotify.play(uris=["spotify:track:xxx"])
    spotify.pause()
    spotify.skip()
    np = spotify.now_playing()
    spotify.create_playlist("Weekend Vibes", description="Chill tracks")
    spotify.add_to_playlist("playlist_id", ["spotify:track:xxx"])
    spotify.remove_from_playlist("playlist_id", ["spotify:track:xxx"])
    spotify.save_to_library(["spotify:track:xxx", "spotify:album:yyy"])
    spotify.remove_from_library(["spotify:track:xxx"])
    spotify.top_tracks(time_range="short_term")
    spotify.recently_played()
    ```
    
    Token refresh is automatic — no manual intervention needed.
    
    ## Common Workflows
    
    ### Play a song by name
    1. `search("song name")` → get URI from results
    2. `play(uris=[uri])` or `queue(uri)`
    
    ### Create a themed playlist
    1. Search for tracks matching the theme
    2. `create_playlist("name")` → get playlist ID
    3. `add_to_playlist(playlist_id, uris)` — max 100 per call
    
    ### Check listening history
    - `top_tracks(time_range="short_term")` — last 4 weeks
    - `top_tracks(time_range="medium_term")` — last 6 months
    - `recently_played()` — last 50 tracks
    
    ## Key API Notes
    
    - Tokens expire every hour; the script auto-refreshes on 401 or near-expiry
    - 429 rate limits are auto-retried with Retry-After
    - Playback control requires an active Spotify session (Premium)
    - Search max limit is **10** per request (paginate with offset for more)
    - **Feb 2026 breaking changes** are fully handled in the scripts. If you encounter 403/404, see `references/api-changes-2026.md`
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/justinchuby-bot-spotify-manager-skill-spotify-manager.md

// REPO STATS

0 stars
0 open issues
Last commit: 7mo ago