watchwise

name	watchwise
description	Get personalized movie and TV show recommendations based on your IMDB ratings. Use when a user asks for movie/TV recommendations, wants to know what to watch, asks "what should I watch", wants movie or show suggestions, or anything related to personalized entertainment recommendations.

WATCHWISE SKILL

Overview

Watchwise is a CLI recommendation engine that analyzes your IMDB rating history to build a taste profile, then uses TMDB, Trakt, and OMDb APIs to find personalized recommendations. It produces 5 tailored picks + 1 "horizon expander" bonus pick from genres outside your comfort zone.

Installation

The binary is located at ~/Downloads/watchwise/watchwise. If it's not built yet:

cd ~/Downloads/watchwise && go build -o watchwise .

Configuration

• API keys: ~/.watchwise/auth.json (TMDB required, Trakt and OMDb optional)
• User profile: ~/.watchwise/profile.json (auto-generated from IMDB CSV on first run)
• Recommendation history: ~/.watchwise/history.json (auto-generated, tracks previously recommended titles to avoid repeats)

How it works

1. On first run, it asks for an IMDB CSV export path and builds a taste profile
2. The profile is saved to ~/.watchwise/profile.json and reused on subsequent runs
3. User picks Movies or TV Shows
4. It queries TMDB (and TVMaze for TV) with randomized pages for variety
5. Candidates are scored on genre match (50%), rating (25%), popularity (15%), recency (10%) + random jitter
6. Returns 5 recommendations + 1 bonus "horizon expander" from unexplored genres
7. Each recommendation includes: title, year, rating, vote count, genres, synopsis, match reason, and IMDB link

Usage with Claude

The tool is interactive (reads stdin), so when the user asks for recommendations:

1. If profile doesn't exist yet, guide the user to export their IMDB ratings:

   • Go to https://www.imdb.com/list/ratings
   • Click the three-dot menu and select "Export"
   • Then run: echo '<csv_path>\n1' | ~/Downloads/watchwise/watchwise (for movies) or echo '<csv_path>\n2' | ~/Downloads/watchwise/watchwise (for TV shows)

2. If profile already exists (check if ~/.watchwise/profile.json exists):

   • For movies: cd ~/Downloads/watchwise && echo '1' | ./watchwise
   • For TV shows: cd ~/Downloads/watchwise && echo '2' | ./watchwise

3. Present the results to the user in a conversational way:

   • Don't just dump the raw output — summarize each recommendation naturally
   • Highlight why each pick fits their taste
   • Call out the bonus "Horizon Expander" as something adventurous to try
   • Include the IMDB links so they can check it out

4. If the user wants to refresh their profile (e.g., after rating more titles):

   • Delete the old profile: rm ~/.watchwise/profile.json
   • Then run again with the CSV path as above

5. If the user wants to reset recommendation history (allow previously suggested titles again):

   • Delete the history: rm ~/.watchwise/history.json

Important notes

• The tool can be run from any directory (config is stored in ~/.watchwise/)
• Results are randomized — running it multiple times gives different recommendations
• The tool exits after showing results (not a persistent process)
• If the user asks for both movies AND TV shows, run the command twice (once with 1, once with 2)
• If the user doesn't specify movies or TV, ask them which they prefer

Example interaction

User: "What should I watch tonight?" → Ask: "Movies or TV shows?" → Run the appropriate command → Present the 5 picks + bonus conversationally

User: "Give me some movie recommendations" → Run: cd ~/Downloads/watchwise && echo '1' | ./watchwise → Present results

User: "I updated my IMDB ratings, refresh my profile" → Run: rm ~/.watchwise/profile.json → Ask for CSV path or guide them to export → Run with CSV path