fabioc-aloha/spotify-skill

---

🎯 Overview

Spotify Skills for Claude is a comprehensive development platform that combines:

• 🎵 Production Spotify API Skill - Fully-featured example with OAuth 2.0 and 40+ methods
• 🛠️ Automated Development Tools - Create, validate, and package skills effortlessly
• 📚 Educational Resources - Complete guides teaching skill creation from first principles
• 📋 Official Specifications - The authoritative Agent Skills Spec v1.0
• 🎨 6 Curated Examples - Real-world skill patterns from Anthropic

Whether you want to use the Spotify skill or create your own skills, this project provides everything you need.

---

🏗️ Architecture

flowchart TB
    subgraph "Claude Desktop"
        CLAUDE[Claude AI Assistant]
    end

    subgraph "Spotify Skill Package"
        SKILL[SKILL.mdMain Documentation]

        subgraph "Scripts (Python Tools)"
            SC[spotify_client.py40+ API Methods]
            PC[playlist_creator.py5 Creation Strategies]
            CG[cover_art_generator.pyImage Generation]
        end

        subgraph "References"
            API_REF[api_reference.mdAPI Documentation]
            AUTH[authentication_guide.mdOAuth 2.0 Setup]
            LLM_GUIDE[COVER_ART_LLM_GUIDE.mdDesign Instructions]
        end
    end

    subgraph "Development Tools"
        INIT[init_skill.pyCreate New Skills]
        VAL[validate_skill.pyStructure Validation]
        PKG[package_skill.pyDistribution Packaging]
    end

    subgraph "Spotify Web API"
        AUTH_API[OAuth 2.0Authentication]

        subgraph "API Endpoints"