plex-library-curator

Audit a Plex library, identify gaps, and propose verified-absent titles with cited warrants.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/moistalgia/hermes-tools --skill plex-library-curator-moistalgia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plex-library-curator
Source: https://github.com/moistalgia/hermes-tools/tree/main/skills-from-hermes/media/plex-library-curator
Command: npx skills add https://github.com/moistalgia/hermes-tools --skill plex-library-curator-moistalgia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Growing a media collection without a plan leads to padded libraries and duplicate purchases. This Skill audits a Plex server's actual contents, models the owner's taste from watched items, finds structural and canon gaps, and proposes additions where every pick is verified absent and backed by a named piece of evidence. ## Core Features & Use Cases - Library census and taste modeling: Uses Plex MCP tools like library_export, library_stats, and discover to inventory the collection and infer preferences from watched items, with horror volume explicitly excluded from taste weighting. - Warrant-based recommendations: Every proposed title carries a labeled warrant type (Canon, Bridge, Lineage, Coverage, or Event) and is verified absent via check_titles or search before it ships. - Batch curation with caching: Supports long-running curation passes with a 90-day canon-list cache in references/canon-lists and incremental append-only report writing to /sandbox/out. - Use Case: Ask "what am I missing from my movie library?" and receive a report showing zero documentaries, a missing Blade Runner (1982) behind its owned sequel, and a shortlist of defensible additions. ## Quick Start Ask the agent to audit my Plex library and propose ten defensible additions, writing the full report to /sandbox/out.

Frequently Asked Questions about plex-library-curator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find gaps in my Plex movie library?▼

Run a census with library_export and library_stats to get genre, decade, and resolution counts, then diff against canon lists like Sight & Sound or AFI 100. Structural gaps such as zero documentaries surface directly from discover returning no matches.

How does the skill avoid recommending titles I already own?▼

Every candidate title is verified absent using check_titles in bulk or search individually before it appears in the report. A fuzzy search hit means the pick is dropped silently; only confirmed misses ship.

What is the difference between gap-analysis mode and quality mode?▼

Gap-analysis mode requires one of five strict warrant types (Canon, Bridge, Lineage, Coverage, Event) tied to library evidence. Quality mode, for open-ended requests, only requires cited critical acclaim plus verified absence.

Does this skill work without the Plex MCP server?▼

No. It requires the plex MCP server exposed as mcp__plex__* tools running host-side, with no in-container fallback. If the tools do not resolve, the skill instructs loading plex-media-playback's readiness guide and stopping.

Why does the skill exclude horror from the taste model?▼

The library's horror volume comes from hosting a horror event, which is a programming obligation rather than personal taste. Counting it would swamp similarity metrics, so horror is handled as a separate programming slate judged on lineup balance.

When should I not use plex-library-curator?▼

Do not use it to play media or recommend from titles already on the server; that is plex-media-playback's job. This skill only proposes titles verified absent from the library.