spotify-intelligence - SKILL.md Agent Skill

name: spotify-intelligence description: "Spotify intelligence skill with Python runners for auth, playback control, recommendations, feedback loop, governance, and explainable playlist decisions." metadata: required-env: - SPOTIFY_CLIENT_ID - SPOTIFY_CLIENT_SECRET - SPOTIFY_REDIRECT_URI (optional) primary-credential: SPOTIFY_CLIENT_ID + SPOTIFY_CLIENT_SECRET local-storage: - data/tokens.json - data/spotify-intelligence.sqlite notes: - Uses Spotify API only (api.spotify.com and accounts.spotify.com) - Stores OAuth tokens locally on the host

Spotify Intelligence (ClawHub Edition)

This edition is ClawHub-validator compatible (text + python-focused).
The full local Windows edition may include additional PowerShell wrappers.

Required env

SPOTIFY_CLIENT_ID
SPOTIFY_CLIENT_SECRET
optional SPOTIFY_REDIRECT_URI

Core Python entrypoints

Auth token exchange: scripts/auth/oauth_auth.py
Playback control: scripts/playback/playback_control.py
Recommendations: scripts/recommend/recommend-now.py
Recommendation helper: scripts/recommend/recommend_commands.py
Derived features: scripts/decision/rebuild-derived-features.py

Key capabilities

Playback (play/pause/next/previous/volume/device/queue)
Song search with own-playlist preference + global fallback
Recommendation modes: passend, mood-shift, explore
Feedback-aware scoring (like/dislike/skip/keep)
Governance and decision logging (DB-backed)

References

references/read-layer.md
references/playback-control.md
references/recommendation-layer.md
references/feedback-loop.md
references/governance-cost.md
references/status-handover-2026-02-24.md