How do I install the Moviepilot Update skill?

Run npx skillmds@latest add pkc278/moviepilot-update in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Moviepilot Update safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Moviepilot Update?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Moviepilot Update free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Moviepilot Update?

pkc278 (@pkc278) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Moviepilot Update by pkc278 — Agent Skill

Name: Moviepilot Update
Author: pkc278

Moviepilot Update

Use this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled, call the upgrade API so MoviePilot performs a one-shot upgrade and restart.

pkc278 Updated Sep 17, 2026

File contents

MoviePilot Update

All script paths are relative to this skill file.

Use this skill for MoviePilot restart and upgrade operations.

Setup

This skill reuses the moviepilot-api client configuration.

Configure host and API key once:

python ../moviepilot-api/scripts/mp-api.py configure --host http://localhost:3000 --apikey <API_TOKEN>

Preferred Commands

Check versions

python scripts/mp-update.py versions

This calls GET /api/v1/system/versions.

Restart MoviePilot

python scripts/mp-update.py restart

This calls GET /api/v1/system/restart.

Upgrade and restart MoviePilot

Release mode:

python scripts/mp-update.py upgrade

Dev mode:

python scripts/mp-update.py upgrade dev

This calls POST /api/v1/system/upgrade.

Behavior:

If MOVIEPILOT_AUTO_UPDATE is already enabled (release or dev), MoviePilot only triggers a restart and lets the normal startup flow perform the upgrade.
If MOVIEPILOT_AUTO_UPDATE is disabled, MoviePilot writes a one-shot upgrade flag, restarts itself, performs that single upgrade during startup, and then continues running without changing the persisted auto-update setting.

Direct API Examples

python ../moviepilot-api/scripts/mp-api.py GET /api/v1/system/restart
python ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"release"'
python ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"dev"'

Notes

These operations require administrator authentication.
Restart or upgrade will interrupt the current agent session. Do not rely on post-restart follow-up steps in the same run.
Prefer the API flow above. Only fall back to manual container commands when the API is unavailable.

---name: moviepilot-updatedescription: Use this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled, call the upgrade API so MoviePilot performs a one-shot upgrade and restart.---# MoviePilot Update> All script paths are relative to this skill file.Use this skill for MoviePilot restart and upgrade operations.## SetupThis skill reuses the `moviepilot-api` client configuration.Configure host and API key once:```bashpython ../moviepilot-api/scripts/mp-api.py configure --host http://localhost:3000 --apikey <API_TOKEN>```## Preferred Commands### Check versions```bashpython scripts/mp-update.py versions```This calls `GET /api/v1/system/versions`.### Restart MoviePilot```bashpython scripts/mp-update.py restart```This calls `GET /api/v1/system/restart`.### Upgrade and restart MoviePilotRelease mode:```bashpython scripts/mp-update.py upgrade```Dev mode:```bashpython scripts/mp-update.py upgrade dev```This calls `POST /api/v1/system/upgrade`.Behavior:- If `MOVIEPILOT_AUTO_UPDATE` is already enabled (`release` or `dev`), MoviePilot only triggers a restart and lets the normal startup flow perform the upgrade.- If `MOVIEPILOT_AUTO_UPDATE` is disabled, MoviePilot writes a one-shot upgrade flag, restarts itself, performs that single upgrade during startup, and then continues running without changing the persisted auto-update setting.## Direct API Examples```bashpython ../moviepilot-api/scripts/mp-api.py GET /api/v1/system/restartpython ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"release"'python ../moviepilot-api/scripts/mp-api.py POST /api/v1/system/upgrade --json '"dev"'```## Notes- These operations require administrator authentication.- Restart or upgrade will interrupt the current agent session. Do not rely on post-restart follow-up steps in the same run.- Prefer the API flow above. Only fall back to manual container commands when the API is unavailable.

Frequently asked questions