Publish MoviePilot Plugin

What it does

When your agent uses it

• Publishing a local MoviePilot plugin to a GitHub repository
• Pulling plugin changes from GitHub back into the local plugin source
• Previewing the diff between local and remote plugin files before pushing
• Maintaining the package metadata of a plugin repository

Example prompts

• “Publish my local MoviePilot plugin to GitHub, but show me the diff before anything is pushed.”
• “Pull the latest version of the plugin from my GitHub repo back into the local plugin folder.”
• “Create a new public repository for the plugin and push it.”

Requirements

• MoviePilot with a `GITHUB_TOKEN` or `REPO_GITHUB_TOKEN` setting
• Local plugin repositories listed in `PLUGIN_LOCAL_REPO_PATHS`
• Python, for `scripts/publish_plugin.py`
• Pre-approved tools (allowed-tools): read_file, write_file, edit_file, apply_patch, execute_command, moviepilot_api

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Identify the target plugin ID and local source repository.
2. 2Identify the GitHub repository as owner/repo.
3. 3Select the package version layout.
4. 4Verify token availability.

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:

  • read_file
  • write_file
  • edit_file
  • apply_patch
  • execute_command
  • moviepilot_api

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python

  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 these keys or tokens, usually read from environment variables:

  • GITHUB_TOKEN
  • REPO_GITHUB_TOKEN

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

Context cost

Publish MoviePilot Plugin loads about 1.9k tokens when it runs. Until then it costs about 179 tokens; SKILL.md has 777 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~179

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

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

• NoteMentions a .env fileSKILL.md:127

  `.env`, `.env.*`, `config/`, `data/`, `cache/`, `logs/`, `tmp/`,

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); the scripts in this folder are not scanned.

SKILL.md

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

name

publish-moviepilot-plugin

description

Use this skill when the user asks to publish, upload, sync, pull, push, diff, or maintain a MoviePilot local plugin in a GitHub repository. Covers using the configured MoviePilot GitHub token, PLUGIN_LOCAL_REPO_PATHS local plugin repositories, package.json/package.v2.json metadata, plugins/plugins.v2 layouts, safe file exclusion, diff preview before publishing, incremental GitHub Contents API updates, and syncing local plugin changes back from GitHub. Includes asking whether to use an existing repository or create a new public repository when no target repository is available. Also use for Chinese requests mentioning 插件发布, 插件维护, 推送插件到 GitHub, 从 GitHub 拉取插件, 同步本地插件仓库, 增量发布插件, 插件仓库维护.

allowed-tools

read_file, write_file, edit_file, apply_patch, execute_command, moviepilot_api

version

3

allowed-api-operations

config.system.get config.system.update

python skills/publish-moviepilot-plugin/scripts/publish_plugin.py preview \
  --repo owner/repo \
  --plugin-id MyPlugin \
  --local-repo /path/to/MoviePilot-Plugins \
  --package-version v2

python skills/publish-moviepilot-plugin/scripts/publish_plugin.py push \
  --repo owner/repo \
  --plugin-id MyPlugin \
  --local-repo /path/to/MoviePilot-Plugins \
  --package-version v2 \
  --message "Publish MyPlugin v1.0.0"

python skills/publish-moviepilot-plugin/scripts/publish_plugin.py pull \
  --repo owner/repo \
  --plugin-id MyPlugin \
  --local-repo /path/to/MoviePilot-Plugins \
  --package-version v2

python skills/publish-moviepilot-plugin/scripts/publish_plugin.py create-repo \
  --repo owner/repo

© 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

SKILL.md and 1 other file (scripts) in skills/publish-moviepilot-plugin of jxxghp/MoviePilot.

• SKILL.md
• scripts/publish_plugin.py

Open the folder on GitHubat commit 28e1cb3