pp-movie-goat
The movie CLI that combines TMDb's discovery engine with OMDb's multi-source ratings — and ships a SQLite watchlist that flags what's streaming on your services right now. Trigger phrases: `what should I watch tonight`, `where can I stream <title>`, `rate <title>`, `compare <title> and <title>`, `what's <person>'s filmography`, `plan a <franchise> marathon`, `use movie-goat`, `run movie-goat`.
Security Assessment
Detected risks:
About pp-movie-goat
The pp-movie-goat skill provides a command-line interface (CLI) that integrates movie discovery and multi-source ratings, offering users a streamlined way to decide what to watch and track content across streaming services. By combining TMDb's discovery engine with OMDb's aggregated ratings and a SQLite watchlist, this skill allows users to quickly access trending titles, compare ratings, and monitor streaming availability. It solves the problem of fragmented information across multiple platforms, enabling cinephiles and casual viewers alike to make informed viewing choices without manually checking multiple services.
This skill's main features include several unique commands. The 'tonight' command generates a curated list of trending movies currently available on a user's streaming services, filtered by mood, runtime, and region. The 'ratings' command consolidates TMDb, IMDb, Rotten Tomatoes, and Metacritic ratings into a single reference card for any title. The 'marathon' command plans franchise viewing schedules, including watch order, total runtime, and suggested breaks. Additionally, the 'career' command provides a comprehensive filmography of actors or directors with ratings and chronological details. All commands support JSON output for programmatic use, making it suitable for automated workflows.
Targeted at agents, developers, and movie enthusiasts, this CLI is particularly useful for scenarios like picking a movie for tonight, planning franchise marathons, or exploring an actor's body of work. It is designed for read-only inspection and analysis rather than modifying remote data, making it ideal for users who need quick, reliable, and structured information about movies and streaming content without requiring LLM-style summaries or interactive updates. Users must have the movie-goat-pp-cli installed and accessible in their PATH for the skill to function properly.
FAQ
How do I install the pp-movie-goat CLI?
You can install it via the Printing Press installer using `npx -y @mvanhorn/printing-press-library install movie-goat --cli-only`, or directly with Go using `go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-cli@latest`. Ensure the binary is on your PATH by verifying with `movie-goat-pp-cli --version`.
Which platforms and streaming services does this CLI support?
The CLI provides streaming availability based on the user's configured providers (e.g., Netflix, Max) and region. Exact service support depends on the data accessible through TMDb and JustWatch integrations.
Can I use this CLI to modify my watchlist or post reviews?
No, the CLI is read-only. It supports inspection, export, sync, and analysis commands but does not allow creating, updating, or deleting data, posting reviews, or interacting with remote services beyond reading available information.
What happens if I do not set an OMDb API key?
If the OMDb API key is unset, the 'ratings' command will degrade gracefully and provide ratings from TMDb only.
What are the system prerequisites for running pp-movie-goat?
You need Go 1.26.3 or newer and the movie-goat-pp-cli binary installed. Ensure your PATH includes the location of the binary (typically $GOPATH/bin or $HOME/go/bin) before invoking any commands.
Install pp-movie-goat
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
mvanhorn/printing-press-library