Magnus HedemarkandGitHub
035e58d3e3
Squash-merge verified routing remediation at exact head 690f9c14b0. Required validate and paired evaluation checks passed; advisory droid review had no blocking findings.
Trakt — Media Discovery Signals in the Terminal
Why Install This Skill
Give your agent a reliable way to answer "what is everyone watching?" without confusing a current Trakt discovery ranking with a metadata catalog. The skill covers movies and shows that are trending, broadly popular, or anticipated, and produces JSON that can feed media automation.
Public discovery reads need an application Client ID, not a user login. OAuth boundaries, required headers, pagination, rate-limit behavior, and the difference between Trakt IDs and TMDb metadata are documented so workflows fail clearly instead of silently mixing services.
What You Get
| Path | Purpose |
|---|---|
SKILL.md |
Command guide, recipes, gotchas, and routing |
scripts/trakt |
Executable CLI with JSON and dry-run modes |
scripts/test_trakt.py |
Offline pytest and unittest suite, including header injection and pagination |
references/auth-and-request-contract.md |
Required headers, OAuth boundary, and errors |
references/discovery-endpoints.md |
Trending/popular/anticipated semantics and paging |
references/recipes-and-operations.md |
jq pipelines and rate-safe operations |
evals/evals.json |
Six representative usage-quality cases |
Quick Start
export TRAKT_CLIENT_ID="YOUR_TRAKT_CLIENT_ID"
trakt movie trending --limit 10
trakt --json tv anticipated --page 2 | jq '.pagination'
Create a free Client ID at trakt.tv/oauth/applications. Preview commands with trakt --dry-run --json movie popular without credentials or network access.
Triggers
Load this skill for Trakt API discovery, trending movies or shows, popular rankings, anticipated releases, watch-signal pipelines, or Trakt pagination and authentication questions. Do not use it for TMDb catalog metadata, credits, images, or provider lookups.
Requirements
- Python 3.8 or newer
requests- A Trakt application Client ID in
TRAKT_CLIENT_IDfor live reads - No OAuth login is needed for the public discovery commands