agentleFS
uvwtuvwt/agentdock-skills/skills/spotify-web-api/SKILL.md

spotify-web-api

Skill6 starsChanged 2 months agoApache-2.0View on GitHub

Use Spotify Web API with official OAuth PKCE. Use to authorize Spotify safely, search tracks, read current playback, and add tracks to playlists without importing browser cookies.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill for Spotify playlist edits, current playback lookup, track search, queueing, adding tracks to either a specified playlist or …

    line 10

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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 Web API

Integration guide for Spotify's official Web API. It uses Authorization Code with PKCE, stores tokens locally under the private Skill data directory, and never returns access or refresh tokens in action output.

Use this skill for Spotify playlist edits, current playback lookup, track search, queueing, adding tracks to either a specified playlist or the playlist currently being played, and reading taste signals such as top tracks, top artists, recently played tracks, saved tracks, and local taste profiles.

辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时,在 Skill 包根目录使用相对路径执行;运行宿主负责切换到包根目录并把所需变量注入当前子进程。

printf '%s' '{"skill_action":"<动作>"}' | python3 run.py

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

动作用途
statusShow local OAuth/config state without returning secrets. Optionally validate with Spotify.
auth-urlCreate a Spotify OAuth PKCE authorization URL. Add the returned redirect_uri to the Spotify app first.
finish-authExchange a Spotify callback URL or authorization code for local tokens. Tokens are stored locally and not returned.
current-playbackReturn the current Spotify playback context and current track.
search-trackSearch Spotify tracks and return simplified results.
list-playlistsList current user's playlists.
top-tracksReturn the user's top Spotify tracks for short, medium, or long term taste signals.
top-artistsReturn the user's top Spotify artists and genre tags for short, medium, or long term taste signals.
recently-playedReturn recently played tracks, including played_at and playback context.
saved-tracksReturn tracks saved in the user's Spotify library.
taste-profileBuild a local taste profile from top tracks, top artists, recent plays, and saved tracks.
add-track-to-playlistAdd one or more track URIs to a specific playlist ID, URI, URL, or owned playlist name.
add-track-to-current-playlistAdd track URIs to the playlist that is currently the Spotify playback context.
search-and-add-to-current-playlistSearch for a track, choose a result by index, and add it to the currently playing playlist context.
add-to-queueAdd a track URI to the Spotify playback queue. Spotify Premium is usually required.

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.