uni-spotify

Stars9

Forks1

UpdatedJanuary 6, 2026 at 21:29

Spotify control via uni CLI. Use when user wants to control Spotify playback, search music, view playlists, or check what's playing. Note: Playback control (play/pause/next/prev/queue/volume) requires Spotify Premium. Search and playlists work for all users.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

shockz09

shockz09/uni-cli

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Web DevelopersComputer and Mathematical Occupations·SOC 15-1254

SKILL.md

readonly

name	uni-spotify
description	Spotify control via uni CLI. Use when user wants to control Spotify playback, search music, view playlists, or check what's playing. Note: Playback control (play/pause/next/prev/queue/volume) requires Spotify Premium. Search and playlists work for all users.
allowed-tools	Bash(uni:), Bash(~/.local/bin/uni:)

Spotify (uni)

Control Spotify from the terminal. Uses OAuth PKCE (no setup needed - default app embedded).

Authentication

uni spotify auth                  # Authenticate (opens browser)
uni spotify auth --status         # Check auth status
uni spotify auth --logout         # Log out
uni spotify auth --setup          # Instructions for custom Spotify app

Now Playing

uni spotify now                   # Show currently playing
uni spotify np                    # Alias
uni spotify now --watch           # Live updates (5s refresh)

Search

uni spotify search "Bohemian Rhapsody"        # Search tracks
uni spotify search "Queen" --type artist      # Search artists
uni spotify search "Abbey Road" --type album  # Search albums
uni spotify search "Chill" --type playlist    # Search playlists
uni spotify search "rock" -n 20               # More results

Playback Control (Premium Only)

uni spotify play                              # Resume playback
uni spotify play "Bohemian Rhapsody"          # Search and play
uni spotify play "Abbey Road" --album         # Play album
uni spotify play "Chill Vibes" --playlist     # Play playlist
uni spotify play "spotify:track:..."          # Play by URI
uni spotify pause                             # Pause
uni spotify next                              # Next track
uni spotify prev                              # Previous track

Queue (Premium Only)

uni spotify queue "Stairway to Heaven"        # Add to queue
uni spotify queue "spotify:track:..."         # Add by URI

Volume (Premium Only)

uni spotify volume                # Show current volume
uni spotify volume 50             # Set to 50%
uni spotify vol 75                # Alias

Devices

uni spotify devices                           # List devices
uni spotify devices --transfer <device-id>    # Switch device

Playlists

uni spotify playlists                         # List your playlists
uni spotify playlists -n 50                   # More playlists
uni spotify playlists <playlist-id>           # View playlist tracks

Notes

Premium Required: play, pause, next, prev, queue, volume, device transfer
Free Users: search, now (read-only), playlists, devices (view only)
IDs: All commands show IDs in output [abc123] for use in subsequent commands
URIs: Spotify URIs like spotify:track:... can be used directly

More from this repository

same repository

uni-cli

shockz09/uni-cli

Unified CLI for AI agents. Pattern: uni <service> <command>. Services: WhatsApp, Telegram, Google Suite (Calendar, Gmail, Drive, Sheets, Docs, Slides, Forms, Meet, Tasks, Contacts), Slack, Notion, Linear, Todoist, web search (Exa), research (arXiv, Reddit, HN, Wikipedia), utilities (weather, stocks, currency, QR, URL shortener). Run `uni list` for all services, `uni <service> --help` for commands.

2026-01-189

uni-google

shockz09/uni-cli

Google Suite via uni CLI. Use when user mentions: calendar, events, schedule, meetings, Gmail, email, Drive, files, Sheets, spreadsheet, Docs, documents, Slides, presentations, Forms, surveys, Meet, video call, Tasks, todos, Contacts. Trigger words: calendar, gcal, gmail, email, drive, sheets, docs, slides, forms, meet, tasks, contacts, google. Services: gcal, gmail, gdrive, gsheets, gdocs, gslides, gforms, gmeet, gtasks, gcontacts.

2026-01-129

uni-airtable

shockz09/uni-cli

Airtable bases, tables, and records via uni CLI. Use when user wants to query Airtable data, create/update records, or list bases and tables. Requires AIRTABLE_API_KEY (Personal Access Token).

2026-01-089

uni-sendgrid

shockz09/uni-cli

SendGrid transactional email via uni CLI. Use when user wants to send emails, including HTML emails and dynamic templates. Requires SENDGRID_API_KEY and verified sender email.

2026-01-089

uni-trello

shockz09/uni-cli

Trello boards, lists, and cards via uni CLI. Use when user wants to manage Trello tasks, create boards, move cards between lists. Requires TRELLO_API_KEY and TRELLO_TOKEN.

2026-01-089

uni-twilio

shockz09/uni-cli

Twilio SMS messaging via uni CLI. Use when user wants to send SMS, check message status, or list sent messages. Requires TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and TWILIO_PHONE_NUMBER.

2026-01-089

name	uni-spotify
description	Spotify control via uni CLI. Use when user wants to control Spotify playback, search music, view playlists, or check what's playing. Note: Playback control (play/pause/next/prev/queue/volume) requires Spotify Premium. Search and playlists work for all users.
allowed-tools	Bash(uni:), Bash(~/.local/bin/uni:)

Spotify (uni)

Control Spotify from the terminal. Uses OAuth PKCE (no setup needed - default app embedded).

Authentication

uni spotify auth                  # Authenticate (opens browser)
uni spotify auth --status         # Check auth status
uni spotify auth --logout         # Log out
uni spotify auth --setup          # Instructions for custom Spotify app

Now Playing

uni spotify now                   # Show currently playing
uni spotify np                    # Alias
uni spotify now --watch           # Live updates (5s refresh)

Search

uni spotify search "Bohemian Rhapsody"        # Search tracks
uni spotify search "Queen" --type artist      # Search artists
uni spotify search "Abbey Road" --type album  # Search albums
uni spotify search "Chill" --type playlist    # Search playlists
uni spotify search "rock" -n 20               # More results

Playback Control (Premium Only)

uni spotify play                              # Resume playback
uni spotify play "Bohemian Rhapsody"          # Search and play
uni spotify play "Abbey Road" --album         # Play album
uni spotify play "Chill Vibes" --playlist     # Play playlist
uni spotify play "spotify:track:..."          # Play by URI
uni spotify pause                             # Pause
uni spotify next                              # Next track
uni spotify prev                              # Previous track

Queue (Premium Only)

uni spotify queue "Stairway to Heaven"        # Add to queue
uni spotify queue "spotify:track:..."         # Add by URI

Volume (Premium Only)

uni spotify volume                # Show current volume
uni spotify volume 50             # Set to 50%
uni spotify vol 75                # Alias

Devices

uni spotify devices                           # List devices
uni spotify devices --transfer <device-id>    # Switch device

Playlists

uni spotify playlists                         # List your playlists
uni spotify playlists -n 50                   # More playlists
uni spotify playlists <playlist-id>           # View playlist tracks

Notes

Premium Required: play, pause, next, prev, queue, volume, device transfer
Free Users: search, now (read-only), playlists, devices (view only)
IDs: All commands show IDs in output [abc123] for use in subsequent commands
URIs: Spotify URIs like spotify:track:... can be used directly