spotify-api

Manage Spotify playlists, search tracks, control playback, and generate SVG cover art.

16|3|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/fabioc-aloha/spotify-skill --skill spotify-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotify-api
Source: https://github.com/fabioc-aloha/spotify-skill/tree/main/spotify-api
Command: npx skills add https://github.com/fabioc-aloha/spotify-skill --skill spotify-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, cairosvg, pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of managing your Spotify experience, from curating playlists to controlling playback. It uniquely solves Claude's native image generation limitation by creating custom, visually appealing cover art for your playlists, saving you time and adding a personal touch to your music library.

Core Features & Use Cases

  • Intelligent Playlist Creation: Effortlessly create playlists by artist, theme, lyrical content, or a list of specific songs.
  • Custom Cover Art Generation: Generate unique, thumbnail-readable SVG-based cover art images for your playlists, bypassing Claude's inability to generate images natively.
  • Comprehensive Music Management: Search for tracks, artists, albums, add/remove tracks from playlists, and control music playback (play, pause, skip).
  • Use Case: Ask Claude to "Create a high-energy workout playlist with a custom, intense red-and-black cover art, featuring tracks by Metallica and Linkin Park." The Skill will create the playlist, add relevant songs, and design and upload a fitting cover image, all automatically.

Quick Start

Use the spotify-api skill to create a new public playlist called 'My Chill Indie Evening' with tracks from artists like Bon Iver and The xx, and generate a custom cover art with a 'chill' theme.

Frequently Asked Questions about spotify-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create Spotify playlists programmatically with custom cover art?

Create Spotify playlists programmatically by using OAuth2 authentication to access the Spotify Web API, then generate SVG-based cover art and upload it to your playlist. The Skill handles credential validation, playlist creation by artist or theme, track addition, and cover image generation in one workflow.

Can I automate Spotify playback control and track management with an API?

Yes, automate playback control—play, pause, skip—and manage tracks by searching, adding, or removing songs from playlists via the Spotify Web API. The Skill wraps these endpoints with error handling, pagination support, and graceful fallback when the API is unavailable.

What authentication and setup do I need to access the Spotify Web API?

Set up OAuth2 authentication with required scopes, load credentials from environment variables using python-dotenv, and validate your credentials before making requests. The Skill automates scope validation and environment-based credential loading for secure, repeatable access.

How do I generate custom cover art for playlists if Claude can't create images natively?

Generate custom SVG-based cover art using cairosvg and pillow libraries to create thumbnail-readable images that bypass Claude's native image generation limitation. Upload the generated cover directly to your Spotify playlist to add a personal visual touch.

Does this work if Spotify API is temporarily unavailable?

The Skill includes fallback data workflows and graceful degradation logic, so your application continues functioning with static or cached data when the live API is unavailable. This ensures reliable performance even during API outages.

Can I export playlist data for static app deployments?

Export Spotify playlist data for static-app deployments, enabling you to build applications that work offline or without direct API access. The Skill handles data formatting and export workflows to support decoupled application architectures.