Skip to content
cccskills
FreePublished on GitHubEnglish overview

Spotify

Search Spotify, check what is playing, manage playlists and library items, and control playback on available devices. The skill acts on the connected Spotify account through a command-line tool; playback requires a Premium account and an active device.

OriginalShow the original 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).

danielmiessler/LifeOS19,635 stars(GitHub 19,635 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Finding a track on Spotify
  • Creating a playlist and adding tracks
  • Following or saving a playlist
  • Checking playback or skipping a track

Overview

What it does

Searches Spotify for tracks and manages playlists and library items through a command-line tool connected to Spotify’s Web API. You can create playlists, add tracks, follow playlists, and check your library. It can also tell you what is playing, queue a track, skip to the next track, or adjust the volume on a supported device.

When it helps

Use it when you find music in Spotify and want to collect it in a playlist, add a playlist you like to your account, or check and control playback on a device. Track search is available even before account authorization; other account actions require credentials.

Example requests

  • “Add this playlist to my Spotify.”
  • “Create a focus playlist and add some tracks.”
  • “What’s playing right now?”
  • “Skip to the next track and set the volume to 30%.”

Notes

First-time use requires a Spotify developer app and credential setup. Playback controls require a Premium account and an active device. The skill does not provide music recommendations, generate songs, or edit audio.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
BPartly lackingThe CLI changes account and playback state; confirmation steps are not described.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt requires a developer app and three named environment variables for credentials.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 28, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (7)

  • SKILL.md3.8 KB
  • Intents/Authorize.md2.3 KB
  • Intents/Manage.md2.2 KB
  • Setup.md2.7 KB
  • Tools/EnvText.ts661 B
  • Tools/Spotify.help.md1.4 KB
  • Tools/Spotify.ts15.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  • 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

AnnualReports

FreeSummary

Find and fetch vendor cybersecurity reports, then compare their findings on topics such as ransomware, breaches, cloud security, and AI. Analyses identify the reports consulted and cite each figure by vendor, year, and report, including where sources disagree.

  • Find reports in a cybersecurity topic area
  • Fetch a specific vendor report
  • Compare ransomware findings across reports
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

Compare a component's own design needs with the goals of the larger system through three structured passes. The result identifies conflicts, recommends an appropriate scope, and assesses whether the proposed design fits the whole.

  • Choosing between a service, a library, and inline code
  • Comparing feature requests with product goals
  • Checking how new components fit an existing system
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

Aphorisms

FreeSummary

Find quotes that fit a text’s themes, with attribution and a short reason for each suggestion. Add sourced quotes, research thinkers, and organize a quote collection by theme and usage history to avoid repetition.

  • Finding a fitting quote for a newsletter
  • Saving sourced quotes without duplicates
  • Researching a thinker’s quotes by theme
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

Art

FreeSummary

Create blog illustrations, technical diagrams, comparisons, comics, and icons through workflows tailored to each format. The skill guides composition, color, and model selection, then stages generated images for review before they are used in a project.

  • Creating blog header illustrations
  • Explaining a system with a technical diagram
  • Visualizing comparisons and timelines
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

ArtDirection

FreeSummary

Assess the visual quality of images, films, slides, and site captures against a brief and craft criteria. Two vision judges score the work and rank defects, guiding bounded revision; delivery is gated on a passing critique, with human calibration labels recorded separately.

  • Reviewing a render and listing the most important visual defects
  • Iterating on a film or slide deck until it meets a defined bar
  • Checking whether an image reads as professional
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

ArXiv

FreeSummary

Find arXiv papers by topic, research category, or paper ID. Retrieve titles, authors, abstracts, and links, check new submissions, and add AlphaXiv's AI-generated overviews when available to help decide which papers to read.

  • Checking new AI and machine learning papers
  • Finding papers on a specific research topic
  • Looking up a paper by its ID or arXiv URL
danielmiessler/LifeOS19.6KUpdated Oct 28, 2026

See all skills by danielmiessler

Report a problem with this skill