Agent skill · magnus919
trakt
Discover trending, anticipated, and popular movies and TV shows via the
What it needs
About 2k tokens when loaded.
What this skill does
trakt-cli — Trakt.tv Media Discovery Discover trending, anticipated, and popular movies and TV shows from the terminal. Uses the Trakt.tv API v2 with a read-only Client ID — no user authentication required. Setup 1. Register an app at trakt.tv/oauth/applications to get a Client ID 2. Set the environment variable: No OAuth token, no user login needed for any of the commands below. --help and --dry-run work without credentials. Essential Commands movie trending — Trending movies movie anticipated — Most anticipated movies movie popular — Most popular movies tv trending — Trending TV shows tv anticipated — Most anticipated TV shows tv popular — Most popular TV shows Each result shows: title, year, network (for TV), TMDb/TVDB ID, and tagline (for movies). Global Flags All flags work in any position: Known Gotchas Read-only by design — The CLI only uses the Client ID flow. No OAuth, no writing to your Trakt lists. All endpoints are public discovery endpoints. No auth needed for these commands — The trending, anticipated, and popular endpoints are public. Skip the setup if you only want to preview with --dry-run. Rate limiting — Trakt API v2 has rate limits (~1,000 calls per 5 minutes for free apps). The CLI does not auto-retry on 429 responses. TRAKTCLIENTID is required at runtime — Unlike --dry-run which skips the API call, running live commands without the env var will fail with a clear error message. Pagination defaults to page 1 — The CLI uses --limit for the results per page. Default is 10, max is typically 50. TMDb/TVDB IDs — Use --json to get the full IDs object (TMDb for movies, TVDB for shows) which is useful for lookups in other tools like Radarr/Sonarr. References scripts/trakt-cli — The CLI binary. Built following the cli-builder patterns: --json, --dry-run, --quiet, --verbose, dual-output via emit(), lazy auth. Trakt API Docs — Official API reference. Trakt OAuth Applications — Register an app to get your Client ID.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/trakt