How do I install the Trakt Readonly skill?

Run npx skillmds add modbender/trakt-readonly 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 Trakt Readonly safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Trakt Readonly?

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 Trakt Readonly free to use?

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

Who published Trakt Readonly?

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

Trakt Readonly by modbender — Agent Skill

Name: Trakt Readonly
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Trakt Readonly

Read-only Trakt.tv skill for checking a user’s currently watching item, recent episode history, watched shows list, stats, profile, and playback progress (OAuth) using the Trakt API. Use when the user asks about their Trakt activity, watching status, or recent episodes. Requires a Trakt Client ID and username.

modbender aa5ffb6 4 files · 15.9 KB Updated Sep 9, 2026 12 repo stars

File contents

Trakt (OpenClaw) — Read-only

Use this skill to query Trakt.tv user data via the API (read-only). Default to read-only; do not implement write operations unless the user explicitly asks for OAuth support.

Requirements

Env vars:
- TRAKT_CLIENT_ID (Trakt API Client ID)
- TRAKT_USERNAME (Trakt username or user slug)
- TRAKT_ACCESS_TOKEN (OAuth Bearer token, required for playback)
- TRAKT_CLIENT_SECRET (required for device token exchange)
Binaries: curl, jq

Commands (script)

Use {baseDir}/scripts/trakt-api.sh.

watching — current movie/episode being watched
recent [limit] — recent episode history (default 10, max 100)
watched-shows — recently watched shows list
profile — user profile
stats — user stats
playback <type> <start_at> <end_at> — playback progress (OAuth required)

Examples:

TRAKT_CLIENT_ID=xxx TRAKT_USERNAME=user {baseDir}/scripts/trakt-api.sh watching
TRAKT_CLIENT_ID=xxx TRAKT_USERNAME=user {baseDir}/scripts/trakt-api.sh recent 5
TRAKT_CLIENT_ID=xxx TRAKT_ACCESS_TOKEN=yyy {baseDir}/scripts/trakt-api.sh playback movies 2016-06-01T00:00:00.000Z 2016-07-01T23:59:59.000Z
TRAKT_CLIENT_ID=xxx {baseDir}/scripts/trakt-api.sh device-code
TRAKT_CLIENT_ID=xxx TRAKT_CLIENT_SECRET=zzz {baseDir}/scripts/trakt-api.sh device-token <device_code>

Guardrails

Never log or expose API keys or access tokens.
Only call https://api.trakt.tv.
Read-only endpoints only; playback uses OAuth token read access.
Device OAuth flow is read-only; do not request write scopes.
Validate recent limit is numeric and between 1–100.
Handle empty/404 responses gracefully (public profile required).

References

Read references/trakt-api.md for endpoints, headers, and auth notes.

---name: trakt-readonlydescription: Read-only Trakt.tv skill for checking a user’s currently watching item, recent episode history, watched shows list, stats, profile, and playback progress (OAuth) using the Trakt API. Use when the user asks about their Trakt activity, watching status, or recent episodes. Requires a Trakt Client ID and username.--- # Trakt (OpenClaw) — Read-only Use this skill to query Trakt.tv user data via the API (read-only). Default to **read-only**; do not implement write operations unless the user explicitly asks for OAuth support. ## Requirements - Env vars: - `TRAKT_CLIENT_ID` (Trakt API Client ID) - `TRAKT_USERNAME` (Trakt username or user slug) - `TRAKT_ACCESS_TOKEN` (OAuth Bearer token, required for playback) - `TRAKT_CLIENT_SECRET` (required for device token exchange) - Binaries: `curl`, `jq` ## Commands (script) Use `{baseDir}/scripts/trakt-api.sh`. - `watching` — current movie/episode being watched - `recent [limit]` — recent episode history (default 10, max 100) - `watched-shows` — recently watched shows list - `profile` — user profile - `stats` — user stats - `playback <type> <start_at> <end_at>` — playback progress (OAuth required) Examples: ``` TRAKT_CLIENT_ID=xxx TRAKT_USERNAME=user {baseDir}/scripts/trakt-api.sh watching TRAKT_CLIENT_ID=xxx TRAKT_USERNAME=user {baseDir}/scripts/trakt-api.sh recent 5 TRAKT_CLIENT_ID=xxx TRAKT_ACCESS_TOKEN=yyy {baseDir}/scripts/trakt-api.sh playback movies 2016-06-01T00:00:00.000Z 2016-07-01T23:59:59.000Z TRAKT_CLIENT_ID=xxx {baseDir}/scripts/trakt-api.sh device-code TRAKT_CLIENT_ID=xxx TRAKT_CLIENT_SECRET=zzz {baseDir}/scripts/trakt-api.sh device-token <device_code> ``` ## Guardrails - Never log or expose API keys or access tokens. - Only call `https://api.trakt.tv`. - Read-only endpoints only; playback uses OAuth token read access. - Device OAuth flow is read-only; do not request write scopes. - Validate `recent` limit is numeric and between 1–100. - Handle empty/404 responses gracefully (public profile required). ## References - Read `references/trakt-api.md` for endpoints, headers, and auth notes.

Frequently asked questions