Agent skill

MoviePilot Update

by jxxghp in jxxghp/MoviePilot

Checks MoviePilot versions, downloads a Release update in the background and, after explicit confirmation, installs it and restarts, using only the built-in moviepilot_api tool.

GPL-3.0Auto-check passedDevOps & Cloud

Install MoviePilot Update

skills CLI
$ npx skills add jxxghp/MoviePilot --skill moviepilot-update -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jxxghp/MoviePilot moviepilot-update --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jxxghp/MoviePilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/moviepilot-update .claude/skills/moviepilot-update && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
moviepilot-update
GitHub stars
12k
Token cost
~672 tokens
SKILL.md length
205 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
GPL-3.0

At a glance

Checks MoviePilot versions, downloads a Release update in the background and, after explicit confirmation, installs it and restarts, using only the built-in moviepilot_api tool.

  • Checking which MoviePilot versions and Release updates are available
  • SKILL.md covers Operations and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Downloading a Release update in the background without restarting

What it does

Every step goes through the built-in moviepilot_api tool, where the host picks fixed API routes, authenticates the agent and applies administrator and confirmation policy. The agent never asks for or passes an API token, URL, HTTP method, shell command or legacy helper script. The operations are version listing, which is read-only, a restart that needs explicit confirmation and ends the current agent session, and the Release update flow of check, status, download and install.

Downloading runs in the background and does not restart anything. Once status reports the update as ready, installation needs its own separate confirmation, because it writes the verified install intent and restarts MoviePilot. A Dev branch update uses a different operation whose body must be the exact string dev, and stable Release updates must not use it. All operations need a MoviePilot administrator, and manual container commands are a fallback only when the API is unavailable.

When your agent uses it

  • Checking which MoviePilot versions and Release updates are available
  • Downloading a Release update in the background without restarting
  • Installing a downloaded update once you have confirmed the restart
  • Restarting MoviePilot or moving it to the Dev branch

Example prompts

  • “Check whether a new MoviePilot release is available and show the update status.”
  • “Download the latest MoviePilot release in the background but do not restart yet.”
  • “I confirm the restart, so install the downloaded MoviePilot update now.”

Requirements

  • A MoviePilot instance with the moviepilot_api tool
  • A MoviePilot administrator or verified notification-channel administrator
  • Pre-approved tools (allowed-tools): moviepilot_api

What it can do on your machine

Read from SKILL.md and the folder at commit 28e1cb3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • moviepilot_api

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MoviePilot Update loads about 672 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 205 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~672

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jxxghp/MoviePilot at commit 28e1cb3, republished under its GPL-3.0 licence (© jxxghp). 205 words, ~672 tokens.

Download SKILL.mdSave it as .claude/skills/moviepilot-update/SKILL.md (or your agent's skills folder).
name
moviepilot-update
description
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.
allowed-tools
moviepilot_api
version
5
allowed-api-operations
system.versions system.update.status system.update.check system.update.download system.restart system.update.install system.upgrade.dev

MoviePilot Update

Use this skill for MoviePilot restart and upgrade operations.

Use the built-in moviepilot_api tool only. The host selects fixed API routes, authenticates with the trusted Agent identity, and applies administrator and confirmation policy. Never request or pass an API token, URL, HTTP method, shell command, or legacy helper script.

Operations

Check versions
json
{"operation_id":"system.versions","path_params":{},"query":{},"body":{}}

This read-only operation lists available MoviePilot releases.

Restart MoviePilot
json
{"operation_id":"system.restart","path_params":{},"query":{},"body":{}}

Restart requires explicit confirmation and interrupts the current Agent session.

Release update

Check for a stable Release and inspect current progress:

json
{"operation_id":"system.update.check","path_params":{},"query":{},"body":{}}
{"operation_id":"system.update.status","path_params":{},"query":{},"body":{}}

Start the background download. This does not restart MoviePilot:

json
{"operation_id":"system.update.download","path_params":{},"query":{},"body":{}}

After status reports state=ready, installation requires a separate explicit confirmation:

json
{"operation_id":"system.update.install","path_params":{},"query":{},"body":{}}

install writes the verified install intent and restarts MoviePilot. Do not call it until the user explicitly confirms the restart.

Dev update and restart
json
{"operation_id":"system.upgrade.dev","path_params":{},"query":{},"body":"dev"}

The body must be the exact JSON string "dev". Stable Release updates must use check, download, status, and install instead.

Notes

  • All operations require a MoviePilot administrator or a verified notification-channel administrator. The host performs authorization; the model must never invent an administrator flag.
  • Only restart, Release installation, and Dev upgrade interrupt the current agent session. Checking and downloading remain online.
  • Prefer the API flow above. Only fall back to manual container commands when the API is unavailable.

© jxxghp, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/moviepilot-update of jxxghp/MoviePilot.

Open the folder on GitHubat commit 28e1cb3

Compare with similar skills

MoviePilot Update next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MoviePilot Update compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MoviePilot Update this skilljxxghp/MoviePilot12k—~672Automated safety check: PassGPL-3.0
Vercel Deploybytedance/deer-flow84k10 repos~797Automated safety check: PassMIT
Deploy to Vercelvercel-labs/agent-skills32k11 repos~2.9kAutomated safety check: NotesNone
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
Twenty App Operationstwentyhq/twenty58k—~1.9kAutomated safety check: PassCustom licence
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0

Similar skills

  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    84k GitHub starsUsed in 10 repos~797 tokens
    DevOps & CloudAuto-check passed
  • Deploy to Vercel

    vercel-labs/agent-skills

    Official

    Deploys applications to Vercel as previews by default, picking a deploy method from the project's link state, git remote and team.

    32k GitHub starsUsed in 11 repos~2.9k tokens
    DevOps & CloudAuto-check: notes
  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Twenty App Operations

    twentyhq/twenty

    Operates an existing Twenty app: managing remotes, syncing, building, deploying, reading logs, running tests and setting up CI/CD, with confirmation for production.

    58k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Vercel CLI With Tokens

    vercel-labs/agent-skills

    Official

    Deploys and manages Vercel projects through the CLI using an access token from the environment or a .env file instead of interactive login.

    32k GitHub starsUsed in 7 repos~2.6k tokens
    DevOps & CloudAuto-check: notes

More from jxxghp/MoviePilot

All 16 skills in this repo
  • Inspects, diagnoses and directly controls qBittorrent, Transmission or rTorrent downloaders configured in MoviePilot through a bundled Python helper.

    12k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Turns a confirmed MoviePilot bug or feature request into a structured upstream GitHub issue, but only after local diagnosis and an explicit request to file.

    12k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Inspects and operates Emby, Jellyfin, Plex and other media servers configured in MoviePilot through one helper script, without exposing stored credentials.

    12k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Publish MoviePilot Plugin

    jxxghp/MoviePilot

    Publishes and syncs a local MoviePilot plugin to a GitHub repository, merging only that plugin's package entry and previewing differences before writing.

    12k GitHub stars~1.9k tokensUpdated today
    Auto-check: notes
  • Submits code changes as a GitHub pull request through an isolated Git clone, reusing or creating your fork and pushing only after you confirm the real diff.

    12k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • AnySearch

    jxxghp/MoviePilot

    Gives your agent a real-time search service for web queries, domain-specific lookups, parallel batch searches and full-page URL extraction.

    12k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about MoviePilot Update

What does MoviePilot Update do?

Checks MoviePilot versions, downloads a Release update in the background and, after explicit confirmation, installs it and restarts, using only the built-in moviepilot_api tool. Every step goes through the built-in moviepilot_api tool, where the host picks fixed API routes, authenticates the agent and applies administrator and confirmation policy. The agent never asks for or passes an API token, URL, HTTP method, shell command or legacy helper script.

When should I use MoviePilot Update?

MoviePilot Update fits situations like: checking which MoviePilot versions and Release updates are available; downloading a Release update in the background without restarting; installing a downloaded update once you have confirmed the restart; restarting MoviePilot or moving it to the Dev branch.

How do I install MoviePilot Update in Claude Code?

Run `npx skills add jxxghp/MoviePilot --skill moviepilot-update -a claude-code`. Or copy the skill folder (skills/moviepilot-update in jxxghp/MoviePilot) into .claude/skills/moviepilot-update in your project. Claude Code loads it when a task matches its description.

How do I install MoviePilot Update in Codex?

Run `npx skills add jxxghp/MoviePilot --skill moviepilot-update -a codex`. Or copy the skill folder (skills/moviepilot-update in jxxghp/MoviePilot) into .agents/skills/moviepilot-update in your project. Codex loads it when a task matches its description.

Can I use MoviePilot Update in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jxxghp/MoviePilot --skill moviepilot-update -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/moviepilot-update, .gemini/skills/moviepilot-update, .github/skills/moviepilot-update and .opencode/skills/moviepilot-update in your project.

What does MoviePilot Update need to run?

SKILL.md names no scripts, command-line tools or credentials: MoviePilot Update is instructions for the agent only. Our summary lists: A MoviePilot instance with the moviepilot_api tool; A MoviePilot administrator or verified notification-channel administrator. Its frontmatter pre-approves these tools: moviepilot_api.

Does MoviePilot Update access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is MoviePilot Update safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MoviePilot Update use?

MoviePilot Update is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MoviePilot Update use?

About 672 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to MoviePilot Update?

Skills that share tags, products or a category with MoviePilot Update: Vercel Deploy (bytedance/deer-flow, 84k stars), Deploy to Vercel (vercel-labs/agent-skills, 32k stars), Kubeshark Installer (kubeshark/kubeshark, 12k stars) and Twenty App Operations (twentyhq/twenty, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MoviePilot Update?

jxxghp (a GitHub user) maintains it in jxxghp/MoviePilot, which has 11,861 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 11, 2026.

Source: jxxghp/MoviePilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.