skills.rest
lepinkainen
lepinkainenCOMMUNITY
Explore all skills by this author →
GitHub

plex-query

Converts natural-language queries into CLI-based searches for movies and TV shows.

1|Updated Dec 17, 2025
Search Tags:#nlp#query#filters#cli-tools#plex#tv-shows#movies
One-click install
npx skills add https://github.com/lepinkainen/skills --skill plex-query
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plex-query
Source: https://github.com/lepinkainen/skills/tree/main/plex
Command: npx skills add https://github.com/lepinkainen/skills --skill plex-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plexapi, and includes scripts (resource) components.

What problem does it solve?

This skill enables querying a Plex Media Server using natural language to locate movies and TV shows, helping you quickly discover what to watch.

Core Features & Use Cases

  • Flexible filtering: search by duration, genre, actors, year, ratings, and watch status for both movies and TV shows
  • Cross-type queries: handle queries about standalone movies or TV series, including ongoing progress and unwatched content
  • Guided automation: suggests exact CLI commands using plex-movie, plex-tv, and plex-genres to fetch results
  • Example scenario: "I have 90 minutes and want a high-rated romantic movie" returns suitable options with metadata

Quick Start

Ask Plex a question about your library and receive filtered results using the plex-movie, plex-tv, and plex-genres CLI tools.

Frequently Asked Questions about plex-query

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

FAQPage Schema
How do I search my Plex library using natural language filters?▼

You can search your Plex library using natural language by querying for movies and TV shows with filters like duration, genre, actors, year, and watch status. The skill translates queries into CLI commands to fetch results.

Can I find unwatched movies on my Plex server by duration and rating?▼

Yes, you can locate unwatched movies on Plex by filtering for specific durations and ratings. The skill processes natural language requests to return suitable options complete with metadata.

How do I query Plex for TV shows with ongoing watch progress?▼

To query Plex for TV shows with ongoing watch progress, use natural language to filter by watch status. The skill handles cross-type queries for both movies and television series.

Do I need plexapi installed to query Plex libraries with natural language?▼

Yes, you need the plexapi dependency installed to query your Plex libraries. The skill leverages plex-movie, plex-tv, and plex-genres CLI tools built on this library to output JSON-friendly results.

What is the best way to get AI-friendly JSON results from a Plex media server?▼

The best way to get AI-friendly JSON results from a Plex media server is using natural language queries that leverage CLI tools to fetch filtered movies and TV shows. The output is structured for AI reasoning.

Related Skills

Explore More Software Engineering Skills→
eddmanneddmann
2

plex

Query Plex media catalogs and playback history using plexapi in Python.

Community
Advanced
jimloopjimloop

automotive-media

Implement Android Automotive OS media playback with MediaBrowserServiceCompat and MediaSessionCompat.

Community
Advanced
maneeshanifmaneeshanif

search-skill

Search tasks by keyword in titles, descriptions, and tags.

Community
Intermediate
videogorlvideogorl
3

plex-api

Provide Plex Media Server OpenAPI reference for integration and debugging.

Community
Advanced