# Send Streaming Buddy to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "streaming-buddy",
    "name": "Streaming Buddy",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/udiedrichsen/streaming-buddy",
    "canonicalUrl": "https://clawhub.ai/udiedrichsen/streaming-buddy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/streaming-buddy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=streaming-buddy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/justwatch.md",
      "references/services.md",
      "references/tmdb-api.md",
      "scripts/handler.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "streaming-buddy",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T22:49:20.637Z",
      "expiresAt": "2026-05-10T22:49:20.637Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=streaming-buddy",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=streaming-buddy",
        "contentDisposition": "attachment; filename=\"streaming-buddy-2.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "streaming-buddy"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/streaming-buddy"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/streaming-buddy",
    "downloadUrl": "https://openagent3.xyz/downloads/streaming-buddy",
    "agentUrl": "https://openagent3.xyz/skills/streaming-buddy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/streaming-buddy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/streaming-buddy/agent.md"
  }
}
```
## Documentation

### Streaming Buddy 📺

Personal streaming assistant that learns your taste, tracks your watching habits, and suggests what to watch next.

### Features

Search & Info: Find movies/TV shows with TMDB data
Watch Tracking: Track what you're currently watching with progress
Learning System: Learns your preferences from likes/dislikes/ratings
Smart Recommendations: Personalized suggestions based on your taste
Mood-Based Search: Find content by mood (exciting, relaxing, scary, etc.)
Availability Check: Shows which of your services has the content
Match Explanation: Explains why a title matches your preferences

### Commands

CommandAction/streamShow status with all commands/stream search <title>Search for movies/TV shows/stream info <id> [tv|movie]Detailed info + availability/stream watch <id> [tv|movie]Start tracking a title/stream progress S01E05Update progress on current show/stream done [1-5]Mark as finished + rate (auto-learns)/stream like [id]Mark as liked → learns preferences/stream dislike [id]Mark as disliked → learns preferences/stream suggest [service] [tv|movie]Personalized recommendations/stream mood <mood>Search by mood/stream surpriseRandom recommendation/stream why <id>Explain why this matches you/stream watchlistShow watchlist/stream watchlist add <id>Add to watchlist/stream historyView watch history/stream profileShow your taste profile/stream servicesManage streaming services/stream services add <name>Add a service/stream services remove <name>Remove a service

### Mood Options

MoodGenresexcitingAction, Thriller, Sci-Fi, AdventurerelaxingComedy, Animation, Family, DocumentarythoughtfulDrama, Mystery, HistoryscaryHorror, ThrillerromanticRomance, DramafunnyComedy, Animation

### Supported Services

netflix, amazon-prime, disney-plus, apple-tv-plus
youtube-premium, wow, paramount-plus, crunchyroll
joyn, rtl, magenta, mubi

### Learning System

The skill learns your preferences from:

Ratings: When you finish with /stream done [1-5]:

Rating 4-5: Adds genres/themes/actors to "liked"
Rating 1-2: Adds genres to "avoided"



Explicit Feedback: /stream like and /stream dislike:

Extracts genres, themes, actors, directors
Updates preference weights



Preference Profile includes:

Genre preferences (weighted scores)
Liked/disliked themes
Favorite actors & directors
Custom mood mappings

### Handler Usage

# Core commands
handler.sh status $WORKSPACE
handler.sh search "severance" $WORKSPACE
handler.sh info 95396 tv $WORKSPACE
handler.sh watch 95396 tv $WORKSPACE
handler.sh progress S01E05 $WORKSPACE
handler.sh done 5 "Great show!" $WORKSPACE

# Learning commands
handler.sh like $WORKSPACE                    # Like current watching
handler.sh like 12345 movie $WORKSPACE        # Like specific title
handler.sh dislike $WORKSPACE
handler.sh why 95396 tv $WORKSPACE
handler.sh profile $WORKSPACE

# Recommendation commands
handler.sh suggest $WORKSPACE                 # All services, all types
handler.sh suggest prime movie $WORKSPACE     # Prime movies only
handler.sh mood exciting $WORKSPACE
handler.sh mood relaxing tv $WORKSPACE
handler.sh surprise $WORKSPACE

# List commands
handler.sh watchlist list $WORKSPACE
handler.sh watchlist add 12345 tv $WORKSPACE
handler.sh history $WORKSPACE

# Service management
handler.sh services list $WORKSPACE
handler.sh services add netflix $WORKSPACE
handler.sh services remove netflix $WORKSPACE

### Data Files

All data stored in $WORKSPACE/memory/streaming-buddy/:

FilePurposeconfig.jsonTMDB API key, region, languageprofile.jsonUser profile metadataservices.jsonActive streaming servicespreferences.jsonLearned taste preferenceswatching.jsonCurrently watchingwatchlist.jsonWant to watch listhistory.jsonWatched + ratingscache/*.jsonAPI response cache (24h)

### Setup

Get TMDB API key: https://www.themoviedb.org/settings/api
Store in memory/streaming-buddy/config.json:
{
  "tmdbApiKey": "your_api_key",
  "region": "DE",
  "language": "de-DE"
}


Run /stream setup to configure services

### Conversation Examples

Mood-based search:

User: I want something exciting tonight
Bot: 🎬 Exciting picks for you:
     1. Reacher S3 (Prime) ⭐8.5
     2. Jack Ryan (Prime) ⭐8.1
     ...

Learning from feedback:

User: /stream done 5
Bot: ✅ Severance marked as done (⭐5)
     📚 Learned: +Drama, +Mystery, +Sci-Fi
     Actors: Adam Scott, Britt Lower saved to favorites

Explaining recommendations:

User: /stream why 95396
Bot: 🎯 Why Severance matches you:
     ✓ Genre "Drama" (you like this, +2)
     ✓ Genre "Mystery" (you like this, +2)
     ✓ Theme "office" in your preferences
     ✓ With Adam Scott (your favorite)
     Similar to: Fallout ⭐5

### Language Support

Language detected from config.json (language: "de-DE" or "en")
All output adapts to configured language
Commands work in any language

### Requirements

jq (JSON processor)
curl (HTTP client)
bash 4.0+
TMDB API key (free)

### References

services.md — Full list of streaming services
tmdb-api.md — TMDB API usage
justwatch.md — Availability data integration
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: udiedrichsen
- Version: 2.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T22:49:20.637Z
- Expires at: 2026-05-10T22:49:20.637Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/streaming-buddy)
- [Send to Agent page](https://openagent3.xyz/skills/streaming-buddy/agent)
- [JSON manifest](https://openagent3.xyz/skills/streaming-buddy/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/streaming-buddy/agent.md)
- [Download page](https://openagent3.xyz/downloads/streaming-buddy)