OpenSkillIndex← back to search
claude-code

Awesome-omni-skill trakt-tv

Trakt.tv integration for tracking movies and TV shows. Use when syncing watch history, checking what user is watching, updating watchlists, or integrating Trakt data into memory. Triggers on "trakt", "watch history", "what am I watching", "TV shows", "movies watched".

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/trakt-tv" ~/.claude/skills/diegosouzapw-awesome-omni-skill-trakt-tv && rm -rf "$T"
manifest: skills/data-ai/trakt-tv/SKILL.md
source content

Trakt.tv Skill

Sync and track movies/TV shows via Trakt.tv API.

Setup

Required environment variables:

  • TRAKT_CLIENT_ID
    : Get from https://trakt.tv/oauth/applications (create app, use Client ID)
  • TRAKT_USERNAME
    : Your Trakt username (profile must be public, or use OAuth for private)

API Endpoints

Base URL: 

https://api.trakt.tv

Headers required:

Content-Type: application/json
trakt-api-version: 2
trakt-api-key: {TRAKT_CLIENT_ID}

Common Operations

Get Watch History

curl -s "https://api.trakt.tv/users/{username}/history?limit=10" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Currently Watching

curl -s "https://api.trakt.tv/users/{username}/watching" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watchlist

curl -s "https://api.trakt.tv/users/{username}/watchlist" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watched Shows (with progress)

curl -s "https://api.trakt.tv/users/{username}/watched/shows" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watched Movies

curl -s "https://api.trakt.tv/users/{username}/watched/movies" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Ratings

curl -s "https://api.trakt.tv/users/{username}/ratings" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Stats

curl -s "https://api.trakt.tv/users/{username}/stats" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Memory Integration

When syncing to memory, create/update a file like 

entertainment.md
:

# Entertainment

## Currently Watching
- **Show Name** - Season X, Episode Y (last watched: DATE)

## Recently Watched
- Movie Name (DATE) - ⭐ RATING/10

## Watchlist
- Show/Movie to watch

## Stats
- Total shows: X
- Total movies: Y
- Total hours: Z

Polling Strategy

For regular sync, check:

  1. /users/{username}/history?limit=5
    - Recent activity
  2. Compare with last known state
  3. Update memory only if changes detected