agentleFS
Sign inStart free
codewhale-hqcodewhale-hq/codewhale-plugin-marketplace/skills/spotify/SKILL.md

spotify

Skill5 starsChanged 17 days agoMITView on GitHub

Control Spotify playback and search the library and playlists. Use when: spotify, music, playlist, play, pause, or what's playing.

19 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use sonos, heartmula and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • emanueleieloSkill

    sonos

    Control Sonos speakers: discover, play/pause, volume, grouping, favorites, and queue management via sonos CLI.

    Also in 4 projects that use this

  • math-incSkill

    heartmula

    Set up and run HeartMuLa, the open-source music generation model family (Suno-like). Generates full songs from lyrics + tags with multilingual support.

    Also in 3 projects that use this

  • emanueleieloSkill

    imessage

    Send and read iMessage/SMS via Messages.app using the imsg CLI. List chats, view history, send messages to phone numbers or Apple IDs.

    Also in 5 projects that use this

  • HyaxiaSkill

    blogwatcher

    Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

    Also in 5 projects that use this

  • refly-aiSkill

    instagram

    Integrate with Instagram for social media. Use when you need to: (1) post content to Instagram, (2) manage media and insights, or (3) automate Instagram publishing workflows.

    Also in 3 projects that use this

  • jiulingyunSkill

    1Password

    设置并使用1Password CLI (op)。在安装CLI、启用桌面应用集成、登录（单账户或多账户）或通过op读取/注入/运行密钥时使用。

    Also in 4 projects that use this

  • +1 more from emanueleielo

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 3 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 19 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Prefer local control for transport (play/pause/next/previous/current track).

    line 25
  2. Very specific:

    Use the requested play or pause verb.

    line 26
  3. Distinctive:

    Use available Web API endpoints for search and playlist contents.

    line 28
  4. Very specific:

    Do not change playlists (add/remove/reorder) unless asked.

    line 34
  5. Distinctive:

    Do not download or rip audio.

    line 35
  6. Distinctive:

    Do not handle the user's Spotify password.

    line 36

“Common” is measured: kept by at least 6 in 10 of the 19 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Spotify

When to use

Playing, pausing, skipping, identifying the current track, searching for music, and reading playlists.

Setup

Two paths:

  1. Local control (macOS, no setup). The Spotify desktop app must be running, or say so: osascript -e 'tell application "Spotify" to playpause'
  2. Web API (search, playlists, other platforms). Requires an authorized Spotify connection with suitable scopes; report missing access without asking the user to paste a token into chat: GET api.spotify.com/v1/search, /v1/me/playlists, /v1/playlists/{id}.

Workflow

  1. Prefer local control for transport (play/pause/next/previous/current track). Use the requested play or pause verb; playpause is a toggle and cannot safely be retried after an uncertain result. Verify player state afterward.
  2. Use available Web API endpoints for search and playlist contents. Check current app-access restrictions; do not promise the restricted Recommendations API. Handle 403/429 responses without bypassing access or rate limits.
  3. Report artist, track, album, and playlist names verbatim.

Non-goals

  • Do not change playlists (add/remove/reorder) unless asked.
  • Do not download or rip audio.
  • Do not handle the user's Spotify password.

Reference: Spotify API changes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free