rewind: Skill for Claude Code

Add Physical Media

Add physical media items to the Rewind collection. Supports two domains:

• Movies (Blu-ray, 4K UHD, DVD) -- resolved via TMDb, synced to Trakt, stored locally
• Music (Vinyl, CD, Cassette) -- resolved via Discogs, added to Discogs collection, stored locally

Treat a user request that names the items to add as authorization for those exact additions. Otherwise, preview the parsed items and formats and obtain approval before sending any production POST request. Never expose keys from .dev.vars in output.

Setup

Read the admin API key from .dev.vars (the REWIND_ADMIN_KEY line). Read the TMDB_API_KEY line as well for fallback movie searches. All API calls go to https://api.rewind.rest/v1.

Parsing Input

Extract items from freeform input -- pasted order receipts, comma-separated lists, or single items. Strip prices, quantities, and other noise. Identify each item's domain:

• Movie indicators: Blu-ray, 4K, UHD, DVD, HD-DVD, digital, or obviously a film title
• Music indicators: vinyl, LP, CD, cassette, record, or obviously an album/artist
• Ask the user if the domain is unclear

Determine the default format from context. If most items share a format, apply it as the default and only note exceptions.

Adding Movies

Endpoint: POST /admin/collecting/media

curl -s -X POST https://api.rewind.rest/v1/admin/collecting/media \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"title":"<title>","year":<year>,"media_type":"<format>"}'

Required field: media_type -- one of: bluray, uhd_bluray, dvd, hddvd, digital

Identification (at least one required): tmdb_id, imdb_id, or title (with optional year)

Optional fields: resolution, hdr, audio, audio_channels

Format mapping:

• "4K UHD", "4K UHD+Blu-ray Combo", "UHD" -> uhd_bluray
• "Blu-ray" -> bluray
• "DVD" -> dvd

Handling Ambiguous Matches

When the response returns status: "ambiguous", show the candidates to the user and re-call with tmdb_id. When the matched title looks wrong (different film entirely), fall back to a direct TMDb search. See references/disambiguation.md for the TMDb search pattern.