New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Spotify

by codewhale-hq in codewhale-hq/Codewhale

Control Spotify playback and search the library and playlists.

MITAuto-check passed

Install Spotify

skills CLI
$ npx skills add codewhale-hq/Codewhale --skill spotify -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install codewhale-hq/Codewhale spotify --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/codewhale-hq/Codewhale.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/tui/assets/skills/spotify .claude/skills/spotify && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spotify
GitHub stars
41k
Token cost
~393 tokens
SKILL.md length
173 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
MIT

At a glance

Control Spotify playback and search the library and playlists.

  • Works in 2 steps: Local control (macOS, no setup). The… → Web API (search, playlists, other…
  • SKILL.md covers When to use, Setup, Workflow and Non-goals
  • Calls osascript

What it does

Spotify is an agent skill from codewhale-hq/Codewhale. Control Spotify playback and search the library and playlists. Use when: spotify, music, playlist, play, pause, or what's playing.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `SKILL.generation-13.md`).

It works with Spotify. The repository describes itself as: Open-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome. The licence is MIT.

Example prompts

  • “/spotify”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Local control (macOS, no setup). The Spotify desktop app must be
  2. Web API (search, playlists, other platforms). Requires an authorized Spotify

What it can do on your machine

Read from SKILL.md and the folder at commit ad333fd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • osascript

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • developer.spotify.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spotify loads about 393 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 173 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~393

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from codewhale-hq/Codewhale at commit ad333fd, republished under its MIT licence (© codewhale-hq). 173 words, ~393 tokens.

Download SKILL.mdSave it as .claude/skills/spotify/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
spotify
description
Control Spotify playback and search the library and playlists. Use when: spotify, music, playlist, play, pause, or what's playing.
invocation
model+user

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.

© codewhale-hq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in crates/tui/assets/skills/spotify of codewhale-hq/Codewhale.

  • SKILL.md
  • SKILL.generation-13.md

Open the folder on GitHubat commit ad333fd

Compare with similar skills

Spotify next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spotify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spotify this skillcodewhale-hq/Codewhale41k—~393Automated safety check: PassMIT
Code Reviewhifiberry/hifiberry-os1.2k—~576Automated safety check: PassNone
UI DesignerAFK-surf/OpenBridge430—~4.6kAutomated safety check: PassMIT
Computer Usebam-bam-2/solo-skills3671 repos~915Automated safety check: PassMIT
HTML Anythingclockless-org/html-anything152—~6.4kAutomated safety check: PassMIT
Deploy To Maven Centralspotify/android-auth151—~717Automated safety check: NotesApache-2.0

Similar skills

  • Code Review

    hifiberry/hifiberry-os

    Repo-specific guidance for reviewing pull requests on hifiberry-os.

    1.2k GitHub stars~576 tokensUpdated 28 days ago
    DevelopmentAuto-check passed

  • UI Designer

    AFK-surf/OpenBridge

    Design or restyle user interfaces using vendored DESIGN.md references from popular product and brand-inspired visual systems.

    430 GitHub stars~4.6k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed

  • Computer Use

    bam-bam-2/solo-skills

    Use Orca's computer-use CLI to inspect and operate local desktop app windows through accessibility trees, screenshots, and safe UI actions.

    367 GitHub starsUsed in 1 repo~915 tokens
    Productivity & AutomationAuto-check passed

  • HTML Anything

    clockless-org/html-anything

    Turn rich agent answers and any file, folder, URL, or export into a polished single-file HTML page.

    152 GitHub stars~6.4k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed

  • Deploy To Maven Central

    spotify/android-auth

    Deploys the library to OSSRH staging and creates a pre-release, but publishing must be done manually via the Sonatype web UI.

    151 GitHub stars~717 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes

  • Android UI Automation

    OpenMinis/MinisSkills

    Automate Android apps that have no public API or web version by driving the UI layer through the Accessibility Service.

    440 GitHub stars~1.6k tokensUpdated yesterday
    MobileAuto-check passed

More from codewhale-hq/Codewhale

All 63 skills in this repo

  • Codewhale Dogfood Install

    codewhale-hq/Codewhale

    Proves a Codewhale change in the real product: a stamped release build, an atomic local install, fresh-shell verification and manual QA that automated gates cannot cover.

    41k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Codewhale Session Handoff

    codewhale-hq/Codewhale

    Writes a paste-ready handoff for the next agent session, opening with a state-check command block and separating done, suspected and blocked work.

    41k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Codewhale Landing Workflow

    codewhale-hq/Codewhale

    Decides how verified work should reach main, directly, in a worktree or on an integration branch, while keeping contributor credit and respecting merge gates.

    41k GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Sub-Agent Delegation

    codewhale-hq/Codewhale

    Guides when and how to split multi-step coding, research or verification work into focused sub-agent runs while the parent keeps integration and final checks.

    41k GitHub stars~790 tokensUpdated today
    Auto-check passed

  • Codewhale Fleet Manager

    codewhale-hq/Codewhale

    Triages and manages Codewhale fleet runs and workers with typed commands, classifying failures and choosing a safe restart, resume or escalation.

    41k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • GitHub Issue Bulk Assigner

    codewhale-hq/Codewhale

    Moves a list of GitHub issues into a milestone or assigns them to owners with the gh CLI, checking each one before and after the change.

    41k GitHub stars~953 tokensUpdated today
    Auto-check passed

Works with

Questions about Spotify

What does Spotify do?

Control Spotify playback and search the library and playlists. Spotify is an agent skill from codewhale-hq/Codewhale. Control Spotify playback and search the library and playlists.

How do I install Spotify in Claude Code?

Run `npx skills add codewhale-hq/Codewhale --skill spotify -a claude-code`. Or copy the skill folder (crates/tui/assets/skills/spotify in codewhale-hq/Codewhale) into .claude/skills/spotify in your project. Claude Code loads it when a task matches its description.

How do I install Spotify in Codex?

Run `npx skills add codewhale-hq/Codewhale --skill spotify -a codex`. Or copy the skill folder (crates/tui/assets/skills/spotify in codewhale-hq/Codewhale) into .agents/skills/spotify in your project. Codex loads it when a task matches its description.

Can I use Spotify in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add codewhale-hq/Codewhale --skill spotify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spotify, .gemini/skills/spotify, .github/skills/spotify and .opencode/skills/spotify in your project.

What does Spotify need to run?

Going by SKILL.md and its folder, Spotify needs the command-line tools its instructions call (osascript).

Does Spotify access the network?

SKILL.md names 1 domain. As links in the text: developer.spotify.com. This is read from the text; nothing was executed.

Is Spotify safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spotify use?

Spotify is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spotify use?

About 393 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spotify?

Skills that share tags, products or a category with Spotify: Code Review (hifiberry/hifiberry-os, 1.2k stars), UI Designer (AFK-surf/OpenBridge, 430 stars), Computer Use (bam-bam-2/solo-skills, 367 stars) and HTML Anything (clockless-org/html-anything, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spotify?

codewhale-hq (a GitHub organization) maintains it in codewhale-hq/Codewhale, which has 41,067 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 7, 2026.

Source: codewhale-hq/Codewhale on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.