# Publish Moviepilot Plugin

Use this skill when the user asks to publish, upload, sync, pull, push, diff, or...

- Repository: https://github.com/jxxghp/MoviePilot (12002 stars)
- Category: Git and review
- License: GPL-3.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add jxxghp/MoviePilot --skill publish-moviepilot-plugin -g -a claude-code -y`
Codex: `npx skills add jxxghp/MoviePilot --skill publish-moviepilot-plugin -g -a codex -y`
Cursor: `npx skills add jxxghp/MoviePilot --skill publish-moviepilot-plugin -g -a cursor -y`
Gemini CLI: `npx skills add jxxghp/MoviePilot --skill publish-moviepilot-plugin -g -a gemini-cli -y`

## 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/package.v3.json metadata, plugins/plugins.v2/plugins.v3 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 拉取插件, 同步本地插件仓库, 增量发布插件, 插件仓库维护.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Publish MoviePilot Plugin

Use this skill to publish and maintain a MoviePilot local plugin repository
through GitHub while protecting local secrets and unrelated plugins.

## Scope

- Publish one local plugin under `plugins.v3/<plugin_id_lower>/`,
  `plugins.v2/<plugin_id_lower>/` or `plugins/<plugin_id_lower>/` to a GitHub
  repository.
- Merge only that plugin's entry into `package.v3.json`, `package.v2.json` or
  `package.json`.
- Preview local/remote differences before writing.
- Pull remote plugin files back to the local plugin source.
- Create the target GitHub repository when the user explicitly chooses automatic
  creation; repositories are public by default unless the user asks for private.
- Reuse MoviePilot settings `GITHUB_TOKEN`, `REPO_GITHUB_TOKEN`,
  and `PLUGIN_LOCAL_REPO_PATHS` when available.

## Ground Truth

- Local plugin development rules: `skills/create-moviepilot-plugin/SKILL.md`.
- Local plugin source discovery: `app/adapters/external/market.py`,
  `PluginHelper.get_local_repo_paths()`.
- GitHub token settings: `app/runtime/config.py`, especially `GITHUB_TOKEN` and
  `REPO_GITHUB_TOKEN`.
- Plugin package layouts:
  - V3: `package.v3.json` and `plugins.v3/<plugin_id_lower>/`
  - V2: `package.v2.json` and `plugins.v2/<plugin_id_lower>/`
  - Legacy: `package.json` and `plugins/<plugin_id_lower>/`

## Pre-Flight

The rest: https://github.com/jxxghp/MoviePilot/blob/HEAD/skills/publish-moviepilot-plugin/SKILL.md