Skip to content
Skills Library
Other · Research

recommend

/recommend

Personalized movie recommendations tailored to the user's stored taste profile, watch history, and whatever mood/constraint they mention right now. Use when the user asks "what should I watch", "recommend me a movie", "suggest something", "I'm in the mood for [X]", "something like [X]", "help me pick a movie", "got two hours tonight — what should I watch", "anything I'd like that's new", or any other open-ended ask for a personalized pick. This is the flagship skill — invest in making each recommendation feel reasoned, not generic.

Licence
Apache-2.0
Last repository change
30.04.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 30.04.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Personalized movie recommendations tailored to the user's stored taste profile, watch history, and whatever mood/constraint they mention right now. Use when the user asks "what should I watch", "recommend me a movie", "suggest something", "I'm in the mood for [X]", "something like [X]", "help me pick a movie", "got two hours tonight — what should I watch", "anything I'd like that's new", or any other open-ended ask for a personalized pick. This is the flagship skill — invest in making each recommendation feel reasoned, not generic.

Triggers from the description

what should I watchrecommend me a moviesuggest somethingm in the mood for [X]something like [X]help me pick a moviegot two hours tonight — what should I watchanything I
Original author description

Personalized movie recommendations tailored to the user's stored taste profile, watch history, and whatever mood/constraint they mention right now. Use when the user asks "what should I watch", "recommend me a movie", "suggest something", "I'm in the mood for [X]", "something like [X]", "help me pick a movie", "got two hours tonight — what should I watch", "anything I'd like that's new", or any other open-ended ask for a personalized pick. This is the flagship skill — invest in making each recommendation feel reasoned, not generic.

How it works

  1. Before picks: check active state
  2. Gather context (always)
  3. Choose a strategy based on the user's prompt
  4. Present the recommendations
  5. Auto-capture: pickup → active
  6. Quality bar
Original SKILL.md headings · 105 lines, 1,132 words
SKILL.md preview
---
name: recommend
description: Personalized movie recommendations tailored to the user's stored taste profile, watch history, and whatever mood/constraint they mention right now. Use when the user asks "what should I watch", "recommend me a movie", "suggest something", "I'm in the mood for [X]", "something like [X]", "help me pick a movie", "got two hours tonight — what should I watch", "anything I'd like that's new", or any other open-ended ask for a personalized pick. This is the flagship skill — invest in making each recommendation feel reasoned, not generic.
---

# recommend

You are giving the user a short, confident, personalized shortlist of movies — with reasoning tied to what you know about them.

## Before picks: check active state

Call `active_list` first. If any entry has `ageHours > 24` AND (`askedHoursAgo > 24` OR `lastAskedAt` is null), pick the OLDEST such entry and lead with ONE short prompt — not a wall of questions:

> Quick catch-up — you started **[Title](https://www.imdb.com/title/{imdbId}/)** on {short date}. How'd it go?
> - **a)** Finished, loved it
> - **b)** Finished, it was okay
> - **c)** Finished, didn't love it
> - **d)** Still watching
> - **e)** Dropped it

Route the answer:
- **a** → `watched_add({ movieId, rating: 5 })` + `active_remove({ movieId })`
- **b** → `watched_add({ movieId, rating: 3 })` + `active_remove({ movieId })`
- **c** → `watched_add({ movieId, rating: 2 })` + `active_remove({ movieId })`
- **d** → `active_touch_asked({ movieId })` (no watched entry, prevents re-asking within 24h)
- **e** → `active_remove({ movieId })` (no watched entry — they didn't really see it)

Only ever ask about ONE active entry per turn — the oldest. Then continue with the new picks below.

## Gather context (always)

Call these three MCP tools in parallel before anything else:
1. `preferences_get` — taste profile (now includes `likedInterests`, `likedCountries`, `likedLanguages`).
2. `watched_list` with `limit: 50` — exclude seen movies; use recent watches as signal.
3. `movies_genres` — for name↔id mapping when filtering.

## Choose a strategy based on the user's prompt

### A. "Something like [seed movie]"
1. `movies_search({ query })` → resolve seed to a TMDB ID. Confirm match if ambiguous.
2. `movies_recommendations({ movieId })` — TMDB's ML similar-movies. imdbapi.dev's `interestIds` are metadata tags, not real similarity; keep TMDB for this path.
3. Filter out movies already in `watched_list`. Filter out `dislikedGenres`. Pick the top 3–5.
4. **For each final pick, call `movies_details({ movieId })`** — this hydrates `imdbId`, IMDb rating, vote count, Metascore, and interest tags in one call. The link and rating fields in the output template depend on this. (TMDB's recommendations endpoint does NOT include `imdb_id` in list results — `movies_details` is the only path.)
5. Write a one-sentence "why it fits" per pick, anchored to either the seed or their taste profile.

### B. Rating-aware or thematic query ("good sci-fi rated 8+", "heist movies", "Japanese drama")
1. Route to `movies_imdb_discover`:
   - IMDb threshold → `minAggregateRating`.
   - Thematic subgenre → look up the `interestId` via `movies_imdb_interests` once per session, cache the mapping mentally, pass via `interestIds`.
   - Director/actor → `movies_imdb_find_name` → `nameIds`.
   - Language/country → `languageCodes` / `countryCodes`.
2. Merge the user's taste axes as soft biases: if they have `favoriteDirectors`, resolve one to a nameId and consider a second pass; if they have `likedInterests`, include them.
3. Filter out watched. Pick 3–5 with brief "why it fits" reasoning.

### C. Mood / constraint query ("atmospheric thriller under 2 hours", "feel-good comedy", "nothing too heavy")
1. Translate mood → genre filters. Use `movies_genres` if unsure of IDs.
2. Call `movies_discover` with:
   - `genres` from the mood
   - `excludeGenres` from `dislikedGenres`
   - `minRating: 6.5` and `minVotes: 300` by default (quality floor). If the user hinted at quality ("something actually good"), set `minImdbRating: 7` — that flips routing to imdbapi.dev automatically.
   - Runtime filters when they mention a time budget
   - `sortBy: "popularity.desc"` unless they want something obscure
3. Filter out watched. Pick 3–5.
4. **For each final pick, call `movies_details({ movieId })`** — hydrates `imdbId` + IMDb rating needed for the output template. Skip this and the format below cannot render correctly.
5. Write brief "why it fits" reasoning per pick.

### D. "What should I watch tonight" (no constraint given)
1. Combine signals: mix top 2–3 from `movies_trending` (week) with 1–2 from `movies_discover` using `likedGenres` and `favoriteDirectors`, and 1 from `movies_imdb_discover` using `likedInterests` when present.
2. Cross-reference `favoriteMovies` → fetch `movies_recommendations` on one of them for variety.
3. De-duplicate, filter watched, pick 3–5.
4. **For each final pick, call `movies_details({ movieId })`** — hydrates `imdbId`, IMDb rating, vote count, Metascore, and interest tags. The picks coming from `movies_imdb_discover` already have an `imdbId`, but TMDB-sourced picks do NOT — call `movies_details` on those before rendering. (Note: `movies_imdb_batch_rating` only fetches ratings for known imdbIds; it can't backfill imdbIds from TMDB IDs, so it's not the right tool here.)

## Present the recommendations

Format each pick as:

```
**[Title](https://www.imdb.com/title/{imdbId}/)** (Year[, Country]) — IMDb 8.2 — 128 min
[Genre, Genre] · [Heist, Neo-Noir] (if interest tags present)
One-to-two sentence hook from the overview.
→ Why for you: [specific reason anchored to their profile or the current ask]
```

**Output contract (non-negotiable).**
- **Title format:** `**[Title](https://www.imdb.com/title/{imdbId}/)**` — bold + IMDb link. The `imdbId` comes from `movies_details({ movieId })`, which every strategy above requires per pick. If `movies_details` returned `imdbId: null` after that call, fall back to plain bold `**Title**` with no link.
- **❌ Never use a TMDB URL** (`themoviedb.org/movie/...`, `themoviedb.org/title/...`) anywhere in the output. The TMDB ID is internal plumbing — users don't read it. Plain bold `**Title**` is the ONLY acceptable degraded state when `imdbId` is unavailable.
- **Rating:** IMDb rating only (`IMDb 8.2`). If `movies_details` returned no IMDb rating after hydration, fall back to `TMDB 7.9`. Never dual-list (`IMDb X · TMDB Y`) unless the user explicitly asks to see both scores.

Close with: *"Pick one to start? I'll mark it active so we can check in next time."*

## Auto-capture: pickup → active

When the user replies with **clear intent** — *"I'll watch X tonight"*, *"starting X now"*, *"going with X"*, *"let's do X"* — call `active_add({ movieId, source: "recommend" })` BEFORE acknowledging. Then confirm in one sentence: *"Got it — marked **[X](imdb)** active. I'll ask how it went next time."*

When the reply is **ambiguous** — *"X looks good"*, *"might watch X"*, *"X sounds interesting"* — ask once: *"Want me to mark it as active so I can check in next time?"*

Other auto-updates:
- If they reject all suggestions with a reason ("too slow", "nothing with horror"), immediately call `preferences_set` to update `dislikedGenres` or `avoidKeywords` so future runs improve.
- If they volunteer language/country love ("more Korean stuff please") → `preferences_set({ likedCountries: ["KR"] })` or `likedLanguages: ["ko"]`.
- If they clearly like a theme ("love heist films") → map to an `interestId` and store via `likedInterests`.
- "Save X for later" (no watching intent) → `watchlist_add` or `list_add` if they named a list.

## Quality bar

- Every recommendation must come from TMDB or imdbapi.dev data (never invent titles).
- Keep the shortlist tight: 3 confident picks beats 10 hedged ones.
- "Why for you" must be *specific* to the user, not generic. Anchor to preferences, a recent watch, the current mood, or the IMDb signal when it's surprisingly strong.
- For fresh query patterns, consult `docs/api-reference/imdbapi-dev.md` and `docs/api-reference/tmdb.md`.

Versions

RepositoryScoreLicence
This page · jcodesmore/movies-for-ai-agents100Apache-2.0
AtlasScope/agent-kit100MIT
toss/es-toolkit100MIT

Database snapshot: 13.11.2026 · package version 61279abfee53 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100find-movie
    Search for a specific movie by title, keyword, year, or fuzzy description. Use when the user asks "find that movie…", "what's the name of the movie where…", "search for [title]", "look up [title]", "tell me about [movie]", or wants information about a specific film they already…
  • 100streaming-recommendations
    Recommends movies and TV shows to watch on streaming services. Gives 3-5 curated picks based on genre, mood, format, and streaming platform. Use when the user asks what to watch, wants streaming recommendations, or needs help picking a movie or show.
  • 90movies-journal
    Silently keep the user's watched history and taste profile current as they mention movies in conversation. Use whenever the user says "I watched X", "I saw X last night", "I just finished X", "we watched X", "loved X", "hated X", "didn't like X", "that was great/terrible", "best…
  • 100movie-finder
    Personal film and TV concierge over a local catalogue of 36,933 films and 41,869 TV shows, with crowd data (what MovieLens fans of a title also loved, crowd mood tags, review vocabulary), IMDb ratings and runtimes, meaning-based search, and a taste profile that remembers what…
  • 100minimax-music-playlist
    Generate personalized music playlists by analyzing the user's music taste and generation feedback history. Triggers on any request involving playlist generation, music taste profiling, or personalized music recommendations. Supports multilingual triggers — match equivalent phrases in any language.
  • 90inflight-movie-picker-web
    Recommend what to watch on a flight from the airline's actual in-flight film catalogue for that month, ranked against the person's taste, using the Seatback Cinema connector. Use when someone asks what to watch on their flight or plane, what movies are on Emirates (ice), United,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.