moviepilot-update

Use this skill to check MoviePilot versions, inspect Release update state, download a Release update in the background, confirm installation, restart MoviePilot, or retain the existing Dev branch update flow. Prefer the built-in system APIs instead of container commands or manual file replacement.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Quality

Content

86%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.

A well-structured, executable skill body with clear command coverage and explicit validation/confirmation checkpoints for its destructive operations. The main improvement would be trimming the redundant Direct API Examples and adding an error-recovery path for the update workflow.

Suggestions

Remove or condense the 'Direct API Examples' section since the Preferred Commands already annotate each subcommand with its underlying API call, eliminating the duplication.

Add a brief error-recovery note for the Release flow, e.g. what to do when 'status' never reports state=ready or when 'install' fails, to turn the validation checkpoint into a real feedback loop.

Drop the redundant 'Use this skill for MoviePilot restart and upgrade operations.' line since the frontmatter description already states this.

Dimension	Reasoning	Score
Conciseness	Mostly lean with clear sections and no padding about what MoviePilot is, but the 'Direct API Examples' section largely duplicates the script commands (each command is already annotated with its API call) and the opening 'Use this skill for...' line restates the description.	4 / 5
Actionability	Fully executable, copy-paste-ready commands for every common case (versions, restart, check, status, download, install, upgrade dev), backed by a real scripts/mp-update.py that maps each subcommand to a concrete API endpoint.	5 / 5
Workflow Clarity	The Release update is sequenced clearly with explicit validation checkpoints ('After status reports state=ready' and 'Do not call it until the user explicitly confirms the restart'), but there is no error-recovery feedback loop for failure cases such as status never reaching ready or install failing.	4 / 5
Progressive Disclosure	A single-purpose skill under 50 lines with well-organized sections (Setup, Preferred Commands, Direct API Examples, Notes) and one clearly signaled, one-level-deep bundle reference (scripts/mp-update.py) that exists on disk.	5 / 5
	Total	18 / 20 Passed

Description

83%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, specific description that names a comprehensive set of concrete MoviePilot update operations and includes explicit trigger guidance. It could be improved by adding distinct situational 'when' phrases and common synonyms like 'upgrade'.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'check MoviePilot versions', 'inspect Release update state', 'download a Release update in the background', 'confirm installation', 'restart MoviePilot', 'retain the existing Dev branch update flow' — with comprehensive coverage of the skill's operations.	5 / 5
Completeness	Explicit 'Use this skill to...' trigger guidance is present alongside a clear 'what', so it is not capped at 3, but the 'when' is just a restatement of the actions rather than distinct situational trigger phrases, fitting the anchor where 'when' could be more explicit.	4 / 5
Trigger Term Quality	Good natural keyword coverage ('check MoviePilot versions', 'Release update', 'restart MoviePilot', 'Dev branch update'), but missing common synonyms a user might say such as 'upgrade MoviePilot' or 'update MoviePilot'.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (MoviePilot version/update/restart operations) with distinct, product-specific triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: jxxghp/MoviePilot
Path: skills/moviepilot-update/SKILL.md
Commit: f28e8b1

Reviewed: 4 days 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.