How do I install the Find Movie skill?

Run npx skillmds@latest add jcodesmore/find-movie in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Find Movie safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Find Movie?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Find Movie free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Find Movie?

JCodesMore (@jcodesmore) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Find Movie by jcodesmore — Agent Skill

Name: Find Movie
Author: JCodesMore

Find 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 have in mind. Not for open-ended recommendations — for that, use the `recommend` skill.

JCodesMore 86881a1 3.5 KB Updated Sep 17, 2026

File contents

find-movie

You are helping the user locate a specific movie. Primary source is TMDB (fuzzy search is better); imdbapi.dev is a fallback for exact-title lookups that need IMDb IDs.

Steps

Parse the query. Extract:
- The best search string (title or distinctive keywords).
- Any year hint (e.g., "the 90s sci-fi one" → yearFrom: 1990, yearTo: 1999 may go to movies_discover).
- Language hints ("Korean film", "French film") — consider passing originalLanguage.
If the user gave a clear title, call movies_search with { query, year? }. For fuzzy descriptions ("that movie where a guy lives inside a simulation") still try movies_search first — TMDB indexes overviews. If TMDB returns nothing and the user gave an exact title, fall back to movies_imdb_search.
Present the top 3–5 results in a compact form:
```
**[Title](https://www.imdb.com/title/{imdbId}/)** (Year[, Country]) — IMDb 8.2 — 128 min
[Genre1, Genre2, Genre3] · [Interest1, Interest2]
One-sentence hook.
```
When imdbId is absent on a search hit, call movies_details({ movieId }) to hydrate it before rendering. If movies_details still returns imdbId: null, fall back to plain **Title** (no link). Show TMDB 7.9 only when IMDb rating is missing after that hydration step. ❌ Never use a TMDB URL as a fallback — plain bold is the only acceptable degraded state.
If a single result is obviously the match, skip the list and go to step 5.
Offer a deeper look. If the user wants more, call movies_details with append: ["credits", "videos"]. The response now includes IMDb signal automatically:
- Tagline, full overview
- IMDb rating and Metascore (when present). Don't also print the TMDB rating — IMDb is the default display. TMDB rating is a fallback only when IMDb is absent, or when the user specifically asks for it.
- IMDb interest tags (genre/theme tags like Heist, Time Travel)
- Runtime, genres, release date
- Director + top 3–4 cast
- Trailer URL if present (videos.results with type: "Trailer" and site: "YouTube" → https://youtu.be/{key})
- If the user asks for awards or box office, pass includeAwards: true or route to movies_imdb_details with include: ["boxOffice","awards"].
Offer next actions. "Add to watchlist?" → watchlist_add. "Add to my [name] list?" → list_add({ listName, movieId }). "Log as watched?" → watched_add (with a rating if they volunteered one).

Tips

Use the bold-IMDb-hyperlink title format above as the default. Only show IMDb 8.7 · TMDB 8.4 when the user explicitly asks for the TMDB score; otherwise fall back to TMDB 8.4 only when IMDb data is missing.
If search returns nothing and the user gave a fuzzy description, try movies_discover with inferred filters (genre, decade) as a fallback.
If results span wildly different movies with the same title, surface that ambiguity and ask.
Never invent a TMDB ID. If you can't find the movie, say so.
Content warnings / parents guide on request → movies_imdb_details({ imdbId, include: ["parentsGuide"] }).

---name: find-moviedescription: 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 have in mind. Not for open-ended recommendations — for that, use the `recommend` skill.---# find-movieYou are helping the user locate a specific movie. Primary source is TMDB (fuzzy search is better); imdbapi.dev is a fallback for exact-title lookups that need IMDb IDs.## Steps1. **Parse the query.** Extract: - The best search string (title or distinctive keywords). - Any year hint (e.g., "the 90s sci-fi one" → `yearFrom: 1990, yearTo: 1999` may go to `movies_discover`). - Language hints ("Korean film", "French film") — consider passing `originalLanguage`.2. **If the user gave a clear title**, call `movies_search` with `{ query, year? }`. For fuzzy descriptions ("that movie where a guy lives inside a simulation") still try `movies_search` first — TMDB indexes overviews. If TMDB returns nothing and the user gave an exact title, fall back to `movies_imdb_search`.3. **Present the top 3–5 results** in a compact form: ``` **[Title](https://www.imdb.com/title/{imdbId}/)** (Year[, Country]) — IMDb 8.2 — 128 min [Genre1, Genre2, Genre3] · [Interest1, Interest2] One-sentence hook. ``` When `imdbId` is absent on a search hit, call `movies_details({ movieId })` to hydrate it before rendering. If `movies_details` still returns `imdbId: null`, fall back to plain `**Title**` (no link). Show `TMDB 7.9` only when IMDb rating is missing after that hydration step. **❌ Never use a TMDB URL** as a fallback — plain bold is the only acceptable degraded state.4. **If a single result is obviously the match**, skip the list and go to step 5.5. **Offer a deeper look.** If the user wants more, call `movies_details` with `append: ["credits", "videos"]`. The response now includes IMDb signal automatically: - Tagline, full overview - **IMDb rating and Metascore** (when present). Don't also print the TMDB rating — IMDb is the default display. TMDB rating is a fallback only when IMDb is absent, or when the user specifically asks for it. - **IMDb interest tags** (genre/theme tags like Heist, Time Travel) - Runtime, genres, release date - Director + top 3–4 cast - Trailer URL if present (`videos.results` with `type: "Trailer"` and `site: "YouTube"` → `https://youtu.be/{key}`) - If the user asks for awards or box office, pass `includeAwards: true` or route to `movies_imdb_details` with `include: ["boxOffice","awards"]`.6. **Offer next actions.** "Add to watchlist?" → `watchlist_add`. "Add to my [name] list?" → `list_add({ listName, movieId })`. "Log as watched?" → `watched_add` (with a rating if they volunteered one).## Tips- Use the bold-IMDb-hyperlink title format above as the default. Only show `IMDb 8.7 · TMDB 8.4` when the user explicitly asks for the TMDB score; otherwise fall back to `TMDB 8.4` only when IMDb data is missing.- If search returns nothing and the user gave a fuzzy description, try `movies_discover` with inferred filters (genre, decade) as a fallback.- If results span wildly different movies with the same title, surface that ambiguity and ask.- Never invent a TMDB ID. If you can't find the movie, say so.- Content warnings / parents guide on request → `movies_imdb_details({ imdbId, include: ["parentsGuide"] })`.

Frequently asked questions