# Spotify Intelligence

> Spotify intelligence skill with Python runners for auth, playback control, recommendations, feedback loop, governance, and explainable playlist decisions.

- Skill: `johnalbertini14-glitch/spotify-intelligence` (Agent Skill, multi-file: 47 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/spotify-intelligence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/spotify-intelligence/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/spotify-intelligence

---


# 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`