Personal streaming assistant with learning preferences. Tracks what you're watching, learns your taste, and suggests what to watch next based on your services, mood, and preferences. Use when asked about movies, TV shows, streaming services, what to watch, or tracking viewing progress. Triggers: /stream, 'what should I watch', 'recommend something', mentioning Netflix/Prime/Disney+/Apple TV+, asking about series/seasons/episodes, mood-based requests like 'something exciting'.
Usage Guidance
Things to check before installing:
1) API key handling: The skill's metadata claims TMDB_API_KEY is an environment variable, but the script reads the key from $WORKSPACE/memory/streaming-buddy/config.json. Decide which you prefer. If you want to use an environment variable, inspect/modify handler.sh to accept ${TMDB_API_KEY} from the environment (or store the key locally if you prefer not to expose it as a process env).
2) Undeclared utilities: The script uses md5sum and stat and relies on specific stat flags; ensure these are available on your platform (or adapt the script). The declared required binaries list only jq and curl — consider adding md5sum and verifying stat behavior.
3) Workspace permissions: The skill writes persistent data under the provided workspace path. Make sure that workspace is a directory you trust and that sensitive credentials are stored where you expect. The config.json file will contain your API key in cleartext if you follow SKILL.md instructions.
4) Network traffic: The handler performs outbound HTTPS calls to api.themoviedb.org (expected). The references mention JustWatch's GraphQL endpoint only as an alternative; the shipped handler does not call JustWatch directly. If you see any modifications to the script that call other endpoints, review them carefully.
5) Review the full handler script: We reviewed the visible portions and found no obfuscated code or hidden endpoints, but the script is sizable and truncated in the package listing — before trusting it, open and read the entire scripts/handler.sh to confirm its behavior matches expectations (especially preference updates, any telemetry, or unexpected external requests).
If these issues (env-vs-config mismatch, undeclared md5sum/stat dependency) are acceptable and you host the workspace in a place you control, the skill's behavior is coherent with its purpose. If not, request or make the small fixes above before enabling it.
Capability Analysis
Type: OpenClaw Skill
Name: streaming-buddy
Version: 2.0.0
The skill bundle is benign. The `handler.sh` script uses `curl` to interact with the legitimate TMDB API (`api.themoviedb.org`) for its stated purpose of providing streaming recommendations. All file operations are confined to the designated `$WORKSPACE/memory/streaming-buddy` directory, and there is no evidence of data exfiltration, malicious execution (e.g., `eval` with untrusted input, `curl|bash`), persistence mechanisms, or prompt injection attempts in `SKILL.md`.
Capability Assessment
ℹ
Purpose & Capability
Name/description match the implementation: the skill queries TMDB, tracks local watch data, and makes recommendations. Requiring curl and jq is appropriate for a shell-based TMDB client. The declared TMDB_API_KEY requirement is reasonable for the stated purpose — however, the metadata claims an environment variable while runtime instructions and the script expect the key in a workspace config file, which is an inconsistency.
ℹ
Instruction Scope
Runtime instructions and the handler focus on TMDB queries and local storage under $WORKSPACE/memory/streaming-buddy/. The SKILL.md explicitly instructs the user to store the API key in memory/streaming-buddy/config.json and to use workspace paths for all data. The handler reads/writes only those workspace files and calls TMDB endpoints. There are no instructions to read unrelated system files or to send data to third-party endpoints other than TMDB (the references mention a JustWatch GraphQL endpoint only as an alternative, but the handler uses TMDB). The main scope issue is the mismatch between declared env-var requirement and the actual config-file usage.
✓
Install Mechanism
No install spec (instruction-only + a script). Nothing is downloaded or installed by an install step; the only runtime artifacts are files under the provided workspace directory.
ℹ
Credentials
The skill only needs a TMDB API key for its core functionality, which is proportionate. However, registry/metadata mark TMDB_API_KEY as a required environment variable while the handler reads the key from memory/streaming-buddy/config.json (not from the environment). This mismatch could lead to confusion and accidental misconfiguration. Also the script uses md5sum and stat (and other standard utilities) but only lists jq and curl as required binaries — md5sum/stat may not exist or behave the same across all platforms and were not declared as required.
✓
Persistence & Privilege
always:false and the script confines data to the specified workspace directory. It does not request system-wide configuration changes or other skills' credentials. Autonomous invocation is allowed (platform default) but not combined here with broad credentials or global persistence.
How to Use
Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install streaming-buddy
After installation, invoke the skill by name or use /streaming-buddy
Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
v2.0: Learning system, mood-based recommendations, match explanations
Metadata
Slugstreaming-buddy
Version2.0.0
License—
All-time Installs4
Active Installs3
Total Versions1
Frequently Asked Questions
What is Streaming Buddy?
Personal streaming assistant with learning preferences. Tracks what you're watching, learns your taste, and suggests what to watch next based on your services, mood, and preferences. Use when asked about movies, TV shows, streaming services, what to watch, or tracking viewing progress. Triggers: /stream, 'what should I watch', 'recommend something', mentioning Netflix/Prime/Disney+/Apple TV+, asking about series/seasons/episodes, mood-based requests like 'something exciting'. It is an AI Agent Skill for Claude Code / OpenClaw, with 2299 downloads so far.
How do I install Streaming Buddy?
Run "/install streaming-buddy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Streaming Buddy free?
Yes, Streaming Buddy is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Streaming Buddy support?
Streaming Buddy is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Streaming Buddy?
It is built and maintained by udiedrichsen (@udiedrichsen); the current version is v2.0.0.