moviepilot-cli

Use this skill when the user asks to operate MoviePilot through the local `moviepilot tool` MCP CLI for normal product workflows: media search, torrent search, downloads, subscriptions, downloader tasks, library checks, sites, schedulers, workflows, and messages. Prefer dedicated skills for slash command dispatch, manual file organization or failed transfer retry, direct REST API calls, direct database SQL, browser operations, and restart/upgrade.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Quality

Content

88%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 highly actionable, well-sequenced CLI skill body with strong validation checkpoints and feedback loops around destructive and batch operations. The main improvement opportunity is splitting the lengthy command reference and workflow detail into one-level-deep reference files to improve progressive disclosure.

Suggestions

Move the Command Groups table and the per-command `tool show`/`tool run` examples into a dedicated REFERENCE.md (one level deep) so SKILL.md stays a concise overview.

Tighten the autonomous-task broadcast paragraph in 'Manage Autonomous Agent Tasks' to the essential behavioral rule, trimming the explanatory prose.

Consider extracting the Season Validation episode-range logic into a separate reference file, since it is the most procedurally dense section and only needed for TV-season requests.

Dimension	Reasoning	Score
Conciseness	The body is lean and operational, dominated by concrete commands with only modest domain-specific prose (e.g., the autonomous-task broadcast behavior); a few explanatory sentences could still be trimmed, so it sits just below the fully lean anchor.	4 / 5
Actionability	Provides copy-paste-ready `moviepilot tool run ...` commands with real parameter examples (e.g., `search_torrents media_source="themoviedb" media_id=791373 sites='1,3'`) covering the common cases across every command group.	5 / 5
Workflow Clarity	Multi-step workflows are explicitly numbered with validation checkpoints ("Stop — do not call get_search_results yet", the mandatory Check Library and Subscriptions step, "confirm with user first — irreversible" for deletions) and an error-handling table that gives fix-and-retry feedback.	5 / 5
Progressive Disclosure	No bundle files exist and the skill is a single well-sectioned document (Scope, Discover Commands, Command Groups, Workflows, Error handling); structure is good, but at ~285 lines the command-group reference and per-workflow detail could plausibly be split into one-level-deep reference files.	4 / 5
	Total	18 / 20 Passed

Description

92%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 clearly states both its purpose and its trigger conditions while explicitly distinguishing itself from neighboring skills. The only gap is a slight lack of user-natural synonyms for the media types it handles.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete action categories — "media search, torrent search, downloads, subscriptions, downloader tasks, library checks, sites, schedulers, workflows, and messages" — giving comprehensive coverage of the skill's capability surface.	5 / 5
Completeness	Explicitly answers both what (operate MoviePilot via the local `moviepilot tool` MCP CLI for normal product workflows) and when ("Use this skill when the user asks to operate MoviePilot...") with concrete trigger phrasing.	5 / 5
Trigger Term Quality	Includes natural workflow terms users would say ("downloads", "subscriptions", "torrent search"), but omits common synonyms such as "movies", "TV shows", or "tracker" that a user might naturally phrase.	4 / 5
Distinctiveness Conflict Risk	Names a specific tool and explicitly carves out adjacent skills ("Prefer dedicated skills for slash command dispatch, manual file organization..., direct REST API calls, direct database SQL, browser operations, and restart/upgrade"), yielding a clear niche with minimal conflict risk.	5 / 5
	Total	19 / 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-cli/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.