trakt-readonly

What This Skill Does

The trakt-readonly skill is a specialized OpenClaw integration designed for seamless interaction with the Trakt.tv API. It allows users to retrieve personal media tracking data directly through the agent. This skill provides a read-only interface to query what you are currently watching, review your recent viewing history, access your stats, and monitor your progress across various shows and movies. By leveraging the trakt-api.sh script, it abstracts complex API calls into simple, intuitive command outputs. Whether you are checking if you have already seen an episode or pulling your overall viewing statistics, this skill acts as your personal media assistant, ensuring you stay up to date with your Trakt profile without leaving your terminal environment.

Installation

To integrate this skill into your OpenClaw setup, use the following command:

clawhub install openclaw/skills/skills/dennisooki/trakt-readonly

Ensure that you have curl and jq installed on your system, as they are mandatory dependencies for processing API requests. After installation, configure the required environment variables—specifically your TRAKT_CLIENT_ID and TRAKT_USERNAME—in your shell profile or OpenClaw configuration file. For advanced features like playback progress, you must also provide your TRAKT_ACCESS_TOKEN and TRAKT_CLIENT_SECRET.

Use Cases

This skill is perfect for power users who want to bridge their media consumption habits with their AI-driven workflow. It is highly effective for tracking progress in long-running television series, quickly checking which movies are on your recent history list, or providing context to the agent regarding your current entertainment status. Developers and enthusiasts can use it to build status boards or to provide 'what am I watching?' context in conversational interfaces.

Example Prompts

• "Hey, check what I am currently watching on Trakt right now."
• "What were the last 5 episodes I watched according to my Trakt history?"
• "Can you pull my user profile and stats from Trakt and show me my overview?"

Tips & Limitations

• Security: Never share your TRAKT_ACCESS_TOKEN or CLIENT_SECRET in public logs or chat history. The skill is read-only by design, minimizing risks.
• Rate Limiting: Be mindful of the Trakt API limits; requesting history too frequently may trigger rate-limiting policies.
• Input Validation: Ensure that when requesting your recent history, you keep the limit between 1 and 100 to avoid API errors.
• Account Visibility: This skill requires that your Trakt.tv profile is set to public to retrieve data without complex OAuth handshake requirements in standard queries.