SKILL.md
Recoup Research — Playlist Targets
Catalog-wide playlist strategy from research data (not one audio file).
export RECOUP_API="https://api.recoupable.dev/api" # auth header: x-api-key: $RECOUP_API_KEY
Procedure
/playlists?artist={ARTIST}&status=current for placements; status=past for
re-pitch opportunities.
/similar → /playlists on each peer → playlists hosting 2+ peers you're NOT on
are the warmest targets (the gap analysis).
/track/playlists?id={track_id}&editorial=true (5 credits) for per-track
editorial coverage.
/metrics (playlistseditorialcurrent) to judge editorial vs algorithmic balance.
Answer: target playlists (ranked, warmest first), placement gaps, editorial vs algorithmic, and which catalog tracks to push. Full chains in references/workflows.md (Playlist Pitching Intelligence, Catalog Optimization).
Guardrails
- No invented placements.
followers_total is a formatted string ("34.3M") —
parse it if sorting numerically.
- Credits: surface
checkoutUrl on insufficient_credits.
References
references/workflows.md — playlist pitching + catalog optimization chains.