# Create Moviepilot Plugin

Use this skill when the user asks to create, modify, debug, validate, or scaffold a...

- Repository: https://github.com/jxxghp/MoviePilot (12002 stars)
- Category: Testing
- License: GPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

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

## Description

Use this skill when the user asks to create, modify, debug, validate, or scaffold a MoviePilot local plugin. Covers version-aware V3/V2 plugin development, _PluginBase implementations, package.v3.json/package.v2.json/package.json metadata, plugins.v3/plugins.v2/plugins source layout, PLUGIN_LOCAL_REPO_PATHS local plugin sources, plugin APIs, Vuetify JSON forms/pages/dashboards, Vue module federation remote components, get_render_mode, get_sidebar_nav, plugin sidebar pages, get_agent_pets assistant avatars, commands, services, workflow actions, agent tools, and local install/reload flows. Also use for Chinese requests mentioning 编写插件、本地插件源, 插件开发, V3插件, V2插件, 插件市场, 本地安装插件, 插件热加载, 前端联邦, 侧栏入口, Vue插件页面, 助手形象.

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

# Create MoviePilot Plugin

Use this skill to build or revise MoviePilot plugins that can be developed from
a local plugin source and installed into the running MoviePilot instance.

## Ground Truth

- Host plugin contract: `app/plugins/__init__.py`, especially `_PluginBase`.
- Host plugin discovery, local source sync, install, reload: `app/runtime/extensions/plugin_manager.py`
  and `app/adapters/external/market.py`.
- Host plugin endpoints, API auth, static files, remotes, and sidebar nav:
  `app/api/endpoints/plugin.py`.
- Local development note: `docs/development-setup.md`.
- First identify the actual host generation from its source/version and the
  target plugin repository. MoviePilot V3 uses `plugins.v3/` with
  `package.v3.json`; V2 uses `plugins.v2/` with `package.v2.json`; legacy V1
  uses `plugins/` with `package.json`. Do not generate V2 paths for a V3 host.
- When working in or from `MoviePilot-Plugins`, read its `README.md`,
  `docs/Repository_Guide.md`, and the guide for the target generation:
  `docs/Plugin_Development.md` for V3, `docs/V2_Plugin_Development.md` for V2.
  For scenario-specific extensions, read the matching `docs/faq/*.md`.
- For V3, prefer the public `app.sdk.*` entry points documented by the current
  host and guide; do not copy old internal imports from a V2 example. Verify
  extension signatures against the installed host before using a template.

## Task Scope

A request to create or fix a plugin authorizes relevant local source edits and
validation. Reuse that authorization; it does not by itself authorize changing
host configuration, installing/reloading the plugin, restarting, or publishing.
Perform those steps when the user requested them or already approved their
scope, honoring host confirmation requirements. Inspect auto-reload settings
before editing a live watched plugin source; such edits can affect the runtime
immediately and require that runtime effect to be within the authorized scope.

## Code Tool Workflow

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