spotify - SKILL.md Agent Skill

name: spotify description: Control music playback — play/pause, skip, volume, now-playing — on the local Spotify app via playerctl (Linux/MPRIS) or AppleScript (macOS), keyless. Use when asked to "play music", "pause", "skip song", "what's playing", "next track". allowed-tools: ["@coder", "Bash"] triggers: - play music - pause the music - skip song - next track - previous track - what's playing - spotify - tocar música - pausar música - pular música - que música é essa

Spotify / Media Playback (local control)

Control the local Spotify desktop app without any API key or OAuth, using the OS media control layer. (The Web API exists but needs OAuth — prefer local control for play/pause/skip.)

macOS — AppleScript

osascript -e 'tell application "Spotify" to playpause'
osascript -e 'tell application "Spotify" to next track'
osascript -e 'tell application "Spotify" to set sound volume to 60'
osascript -e 'tell application "Spotify" to (name of current track) & " — " & (artist of current track)'
osascript -e 'tell application "Spotify" to play track "spotify:track:TRACKID"'

Linux — playerctl (MPRIS; works with Spotify, and most players)

playerctl -p spotify play-pause
playerctl -p spotify next
playerctl -p spotify metadata --format '{{ artist }} — {{ title }}'
playerctl -p spotify volume 0.6

Detect: command -v playerctl. Install: apt install playerctl.

Windows

The Windows Spotify app exposes media keys via the System Media Transport Controls — simplest is to send media-key virtual inputs from PowerShell, or use spotify-cli. If neither is available, say so rather than improvising.

Search / play a specific song (needs Web API)

Playing an arbitrary search result requires the Spotify Web API with the user's OAuth token (SPOTIFY_TOKEN). If the user wants that, explain the one-time auth; otherwise stick to controlling whatever is already queued.

Rules

Detect the OS first; the control mechanism differs entirely.
For "what's playing", read metadata and report artist — title.