Update deploy workflow and add site prompt

- deploy-pages.yml now triggers after site generation workflow
- Add site-prompt.md with complete design specifications

Author: jamiew

.github/workflows/deploy-pages.yml

@@ -3,7 +3,13 @@ name: Deploy GitHub Pages
 on:
   push:
     branches: [ main ]
+    paths:
+      - 'docs/index.html'
   workflow_dispatch:
+  workflow_run:
+    workflows: ["Generate GitHub Pages Site"]
+    types:
+      - completed
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:

docs/site-prompt.md

@@ -0,0 +1,93 @@
+# GitHub Pages Site Generation Prompt
+
+Generate a beautiful, self-descriptive website for the Spotify MCP server following these requirements:
+
+## Design Requirements
+
+### Theme & Colors (Spotify-inspired)
+- **Primary Background**: Black/dark (#191414) with subtle gradient to #2a1a1f
+- **Accent Color**: Spotify Green (#1DB954, #1ed760 for hover states)
+- **Card Backgrounds**: Dark gray (#282828)
+- **Text Colors**:
+  - Primary: White (#FFFFFF)
+  - Secondary: Light gray (#B3B3B3)
+- **Overall aesthetic**: Clean, modern, minimalist - inspired by https://open.spotify.com/
+
+### Typography
+- Modern system fonts: `-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif`
+- Bold, large headings with clamp() for responsive sizing
+- Good line-height for readability (1.6-1.7)
+
+### Layout & Responsiveness
+- Mobile-friendly, responsive design
+- Max-width: 1200px container
+- Grid layouts that stack on mobile
+- Smooth transitions and hover effects
+- Card-based design with subtle borders and shadows
+
+## Content to Include
+
+### Header Section
+- Spotify logo (use SVG)
+- Project title: "Spotify MCP"
+- Subtitle describing the project
+- Badges linking to:
+  - GitHub repository: https://github.com/jamiew/spotify-mcp
+  - Smithery: https://smithery.ai/server/@jamiew/spotify-mcp
+- Primary CTA buttons for installation and examples
+
+### Features Section
+Highlight these key capabilities:
+1. **Playback Control** - Complete playback management through Claude
+2. **Smart Search** - Intelligent search with pagination support
+3. **Playlist Management** - Create, modify, manage playlists with batch operations (1000+ tracks)
+4. **Optimized API Usage** - Smart batching reduces API calls 60-80%
+5. **Type-Safe Design** - Built with FastMCP, Pydantic validation, MyPy compliance
+6. **Real-time State** - Live user profile and playback status
+
+### Tools Section
+List all 13 MCP tools with brief descriptions:
+
+1. **playback_control** - Control playback (get state, start, pause, skip tracks)
+2. **search_tracks** - Search for tracks, albums, artists, or playlists with pagination
+3. **add_to_queue** - Add tracks to playback queue
+4. **get_queue** - View current playback queue
+5. **get_track_info** - Get detailed metadata for any track
+6. **get_artist_info** - Get artist details and top tracks
+7. **create_playlist** - Create new playlists with custom settings
+8. **get_playlist_info** - Get playlist metadata and details
+9. **get_playlist_tracks** - Retrieve tracks from playlists with full pagination (handles 10k+ tracks)
+10. **get_user_playlists** - List all user playlists with pagination
+11. **add_tracks_to_playlist** - Batch add up to 100 tracks at once
+12. **remove_tracks_from_playlist** - Batch remove tracks from playlists
+13. **modify_playlist_details** - Update playlist name, description, and privacy
+
+### Installation Section
+- Quick install command: `npx -y @smithery/cli install @jamiew/spotify-mcp --client claude`
+- Requirements: Spotify Premium account, `uv` >= 0.54
+- Link to full installation guide in README
+
+### Usage Examples
+Include these example use cases:
+- "Create a chill study playlist with 20 tracks" → Search + playlist creation + bulk track addition
+- "Show me the first 50 tracks from my Liked Songs" → Pagination for large playlists
+- "Find similar artists to Radiohead and add their top tracks to my queue" → Search + artist info + queue management
+
+### Footer Section
+- **Attribution**: Created by [@jamiew](https://github.com/jamiew)
+- **Original Repository**: Forked from [varunneal/spotify-mcp](https://github.com/varunneal/spotify-mcp) with enhanced playlist features and API optimizations
+- **Technology Credits**: Built with [FastMCP](https://github.com/jlowin/fastmcp) • Powered by [Spotify Web API](https://developer.spotify.com/)
+- **License**: MIT License link
+
+## Technical Requirements
+
+- Single-file HTML with embedded CSS (no external dependencies)
+- Semantic HTML5
+- Accessible (proper headings, alt text, ARIA where needed)
+- Fast loading (no heavy assets)
+- SEO meta tags (title, description)
+- Proper viewport meta tag for mobile
+
+## Output Format
+
+Generate a complete, production-ready `index.html` file that can be deployed directly to GitHub Pages.