CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moviepilot-api

Use this skill for MoviePilot product operations such as media search, torrent search, downloads, subscriptions, library checks, sites, storage, workflows, schedulers, plugins, filter rules, and system settings. It authorizes the structured moviepilot_api gateway only; it does not authorize arbitrary HTTP, legacy Agent tools, MCP compatibility commands, authentication headers, or API tokens.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

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

An expertly structured API routing guide with genuinely strong actionability and a well-validated workflow including feedback loops for unknown writes, input errors, and destructive operations. Its two weaknesses are repetition of a few safety rules across sections (hurting token efficiency) and a progressive-disclosure architecture whose 21 referenced category files are entirely absent from the bundle, leaving the promised operation contracts unreachable.

Suggestions

Ship the api/ category files (api/config.md through api/workflow.md) and code-execution.md in the skill bundle, or inline a minimal fallback contract for the most common operations, so the routing guide's destinations actually resolve.

Consolidate the repeated never-bypass-the-gateway and never-repeat-an-unknown-write rules into a single "Safety invariants" section referenced from the workflow steps, removing the duplicate statements at lines 128-131/245-246/386-387 and 172/311/334-338.

Trim host-agent bookkeeping sections ("Reusable learning", session_search/memory tooling, agent_task state) into the files they belong to or a short pointer, keeping SKILL.md focused on MoviePilot operation routing.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely non-obvious, product-specific contract detail (identity-binding rules, SMB share semantics, pagination conventions, provenance markers) with almost no explanation of concepts Claude already knows. It falls short of anchor 5 due to repetition — the never-bypass-the-gateway/arbitrary-HTTP rule appears three times (lines 128-131, 245-246, 386-387) and the never-repeat-an-unknown-write rule is stated three times (172, 311, 334-338) — and host-agent bookkeeping sections ("Reusable learning", session/memory tools) that pad the routing guide.

4 / 5

Actionability

Guidance is fully executable: copy-paste gateway call shapes in JSON ("{\"operation_id\":\"media.search\",\"path_params\":{},\"query\":{\"title\":\"The Wandering Earth\",\"type\":\"media\"},\"body\":{}}"), a table of exact parameter contracts for common reads/downloads, explicit field-placement rules (path_params vs query vs body), and a defined error-feedback contract ("an invalid_input response names the failing field and includes input_contract; correct that field... before retrying"). This matches anchor 5's copy-paste-ready, common-cases-covered profile.

5 / 5

Workflow Clarity

The 7-step "Overall Workflow" is clearly sequenced with explicit validation checkpoints and feedback loops: inspect success/execution_outcome before reporting, correct the named failing field on invalid_input and retry, verify writes with the category's read-back operation, and never repeat a write whose outcome is unknown. Destructive operations (plugin.instance.purge, deletes, discard-corrupt) carry explicit rejection conditions and safety boundaries, satisfying the destructive/batch validation requirement that would otherwise cap this dimension.

5 / 5

Progressive Disclosure

The structure is well designed — the file self-declares as a routing guide ("Detailed operation contracts live in the linked category files under api/; load only the one category file needed"), with a 21-entry category index table mapping each namespace to its detail file and one-level-deep navigation. However, none of the referenced files (api/config.md through api/workflow.md, code-execution.md) exist in the provided bundle — no references/, scripts/, assets/, or api/ directories are present — so the entire detail layer the skill routes to is unverifiable and navigation breaks as shipped. This lands between anchor 4 (clear structure, minor gaps) and anchor 2 (references effectively unusable).

3 / 5

Total

17

/

20

Passed

Description

78%Weight 40%Scale 1-5

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

A strong, third-person description with an explicit trigger clause, a named product niche, and unusually good negative-scope fencing against arbitrary HTTP and legacy tools. The main gap is that the capability list leans on domain nouns rather than concrete verb-phrases and lacks common colloquial trigger variations, keeping specificity, trigger quality, and completeness at the above-midpoint level rather than the top anchor.

Suggestions

Convert the trailing noun list into concrete actions a user would request, e.g., "search media and torrents, add and manage subscriptions, submit and inspect downloads, run workflows and schedulers, configure plugins and filter rules".

Add a few natural trigger phrasings such as "when the user asks to find a movie or TV show, subscribe to a series, or manage MoviePilot downloads, sites, or settings".

Keep the negative-scope sentence but tighten it, since the enumeration of excluded mechanisms is long relative to the value it adds.

DimensionReasoningScore

Specificity

The description names the domain and lists many capability areas ("media search, torrent search, downloads, subscriptions, library checks, sites, storage, workflows, schedulers, plugins, filter rules, and system settings") with broad coverage, but several entries are generic nouns ("sites", "storage", "system settings") rather than the concrete verb-phrases in the top anchor. It sits above anchor 3 (which expects only 1-2 concrete actions) but the noun-heavy tail keeps it below anchor 5.

4 / 5

Completeness

Both halves are present: the "what" is explicit ("authorizes the structured moviepilot_api gateway") and the "when" is an explicit trigger clause ("Use this skill for MoviePilot product operations such as..."). It does not reach anchor 5 because the trigger is one broad category ("MoviePilot product operations") plus a noun list, without the concrete user-moment trigger phrases ("when the user asks to...") of the top example; it is well above anchor 3 where "when" is only weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "media search", "torrent search", "downloads", "subscriptions", "plugins" are phrases a MoviePilot user would actually say. A few common variations and more colloquial forms (e.g., "add a subscription", "find a movie/TV show", "manage download tasks") are missing, so it falls just short of the comprehensive synonym-level anchor 5 and clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is a single named product, and the description explicitly fences its scope ("authorizes the structured moviepilot_api gateway only; it does not authorize arbitrary HTTP, legacy Agent tools, MCP compatibility commands, authentication headers, or API tokens"), which minimizes overlap with generic HTTP/download skills and neighboring domain skills. It clearly matches anchor 5's clear-niche, minimal-conflict profile.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 23 missing

Warning

Total

14

/

16

Passed

Repository

jxxghp/MoviePilot

Path

skills/moviepilot-api/SKILL.md

Reviewed

Table of Contents

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.