plex-media-server

Plex Media Server API — library management, media search, playback sessions, server status, and automation

Quality

52%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plex-media-server/SKILL.md

Quality

Content

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid API reference skill with highly actionable, copy-paste ready curl commands covering the breadth of Plex Media Server management. Its main weaknesses are the lack of multi-step workflow validation (especially for maintenance operations) and the monolithic structure that could benefit from splitting advanced/tangential topics into separate files. The content is mostly concise but includes some peripheral topics that dilute the core focus.

Suggestions

Add validation/verification steps after maintenance operations (e.g., check server status after optimize, confirm scan completion via activity endpoint) to create proper feedback loops.

Split Docker deployment, webhooks, and Radarr/Sonarr integration into separate referenced files to keep SKILL.md focused on core API usage and improve progressive disclosure.

Complete the webhook example with actual executable code rather than pseudocode comments describing what a server would do.

Dimension	Reasoning	Score
Conciseness	Generally efficient with mostly executable examples and minimal fluff, but some sections like the webhook example are incomplete/pseudocode-ish, and the Docker deployment and Radarr/Sonarr integration sections add breadth that may not be core to the skill's stated purpose. Some inline comments are unnecessary for Claude.	2 / 3
Actionability	Nearly every section provides copy-paste ready curl commands with specific jq filters for parsing responses. Endpoints, HTTP methods, and expected JSON paths are all explicit and executable.	3 / 3
Workflow Clarity	Individual API calls are clear, but there are no multi-step workflows with validation checkpoints. Maintenance operations (optimize, clean bundles, empty trash) are destructive/batch but lack sequencing, verification steps, or feedback loops to confirm success.	2 / 3
Progressive Disclosure	Content is well-organized with clear section headers, but it's a long monolithic file (~200 lines) with no references to external files. Advanced topics like Docker deployment, webhooks, and Radarr/Sonarr integration could be split into separate referenced documents to keep the main skill lean.	2 / 3
	Total	9 / 12 Passed

Description

40%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies a clear niche (Plex Media Server API) and lists several capability areas, making it distinctive. However, it lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill, and the listed capabilities are category-level rather than concrete actions. Adding explicit trigger guidance and more specific action verbs would significantly improve this description.

Suggestions

Add a 'Use when...' clause with trigger terms like 'Use when the user asks about Plex, managing media libraries, checking what's playing on Plex, or automating Plex server tasks'.

Replace category-level terms with concrete actions, e.g., 'Search for movies and TV shows, manage playlists, monitor active streams, check transcoding status, and automate library scans'.

Include additional natural trigger terms users might say, such as 'movies', 'TV shows', 'streaming', 'transcoding', 'media library', and 'Plex server'.

Dimension	Reasoning	Score
Specificity	Names the domain (Plex Media Server API) and lists several action areas (library management, media search, playback sessions, server status, automation), but these are category-level rather than concrete specific actions like 'search for movies', 'start playback', or 'check transcoding status'.	2 / 3
Completeness	Describes what the skill does (Plex Media Server API interactions) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.	1 / 3
Trigger Term Quality	Includes relevant keywords like 'Plex', 'media search', 'playback', 'server status', and 'library management' that users might naturally use, but misses common variations like 'Plex server', 'streaming', 'movies', 'TV shows', 'transcoding', or 'media library'.	2 / 3
Distinctiveness Conflict Risk	The description is clearly scoped to Plex Media Server API, which is a very specific niche product. It is unlikely to conflict with other skills given the explicit mention of 'Plex Media Server API'.	3 / 3
	Total	8 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: ddnetters/homelab-agent-skills
Path: plex-media-server/SKILL.md
Commit: 808c382

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.