Agent skill

Create MoviePilot Skill

by jxxghp in jxxghp/MoviePilot

Guides creating, updating and reviewing built-in MoviePilot agent skills: file layout, frontmatter, allowed tools and the version bump that syncs changes to users.

GPL-3.0Auto-check passedAgent Workflows

Install Create MoviePilot Skill

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

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

GitHub CLI
$ gh skill install jxxghp/MoviePilot create-moviepilot-skill --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/create-moviepilot-skill .claude/skills/create-moviepilot-skill && 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
create-moviepilot-skill
GitHub stars
12k
Token cost
~1.4k tokens
SKILL.md length
656 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
GPL-3.0

At a glance

Guides creating, updating and reviewing built-in MoviePilot agent skills: file layout, frontmatter, allowed tools and the version bump that syncs changes to users.

  • Works in 8 steps: Understand the Request → Check Existing Skills First → Choose the Skill ID and Path → …
  • Adding a new built-in skill to the MoviePilot repository
  • SKILL.md covers Scope, MoviePilot-Specific Rules, Workflow and Minimal Example, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This workflow is for built-in skills kept in the MoviePilot repository. The repository's skills/ folder is the source of truth, and bundled skills are copied into config/agent/skills at startup. Because the copy is overwritten only when the version field in SKILL.md changes, updating an existing skill means raising its version, otherwise users may keep the older copy. The folder name must match the frontmatter name, using lowercase letters, digits and hyphens and fewer than 64 characters.

The steps are to work out whether the request is a new skill or an edit, asking one focused question only if the goal is unclear, to check existing skills first and extend one instead of adding a near-duplicate, to choose a short hyphen-case id and path, and to write frontmatter where the description lists concrete trigger scenarios. The excerpt is truncated after the frontmatter rules.

When your agent uses it

  • Adding a new built-in skill to the MoviePilot repository
  • Editing an existing built-in skill and bumping its version
  • Reviewing a MoviePilot skill's frontmatter and trigger description

Example prompts

  • “Create a MoviePilot skill that retries failed transfers.”
  • “Update the moviepilot-api skill and bump its version so users get the change.”
  • “Review skills/transfer-failed-retry/SKILL.md for frontmatter problems.”

Requirements

  • A checkout of the MoviePilot repository
  • Pre-approved tools (allowed-tools): read_file, write_file, edit_file, apply_patch, execute_command

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Understand the Request
  2. Check Existing Skills First
  3. Choose the Skill ID and Path
  4. Write Frontmatter Correctly
  5. Write the Body
  6. Add Supporting Files Only When They Help
  7. Implement the Skill
  8. Validate Before Finishing

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

    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 markdown).

    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

Create MoviePilot Skill loads about 1.4k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 656 words of instructions outside code blocks.

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

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). 656 words, ~1,398 tokens.

Download SKILL.mdSave it as .claude/skills/create-moviepilot-skill/SKILL.md (or your agent's skills folder).
name
create-moviepilot-skill
description
Use this skill when the user asks to create, scaffold, update, or review a MoviePilot agent skill. This includes adding a new built-in skill under the repository `skills/` directory, editing an existing built-in skill, writing `SKILL.md` frontmatter and workflow instructions, choosing `allowed-tools`, adding helper scripts when needed, and bumping the built-in skill `version` so changes can sync into `config/agent/skills`.
allowed-tools
read_file, write_file, edit_file, apply_patch, execute_command
version
3

Create MoviePilot Skill

This skill guides you through creating or updating a built-in MoviePilot agent skill in this repository.

Scope

Use this workflow for repository built-in skills:

  • Create or update files under skills/<skill-id>/
  • Commit the skill as part of the MoviePilot repository
  • Do not place the implementation only in config/agent/skills unless the user explicitly asks for a local override instead of a built-in skill

MoviePilot-Specific Rules

  • The repository root skills/ directory is the bundled source of truth for built-in skills.
  • On agent startup, bundled skills are synced into config/agent/skills.
  • Sync overwrite depends on the version field in SKILL.md. If you update an existing built-in skill, increment version, or users may continue using an older copied version.
  • Keep the folder name and frontmatter name identical. Use lowercase letters, digits, and hyphens only.
  • Prefer extending an existing skill instead of creating an overlapping duplicate.

Workflow

Step 1: Understand the Request
  • Determine whether the user wants a new skill or a change to an existing one.
  • Extract the target task, likely trigger phrases, needed tools, and whether helper scripts are necessary.
  • If the goal is still ambiguous after reading the request and local context, ask one focused clarification question. Otherwise proceed with a reasonable default.
Step 2: Check Existing Skills First
  • Inspect the repository skills/ directory before creating anything new.
  • If an existing skill already covers most of the workflow, update it instead of adding a near-duplicate.
  • Reuse the repository style: concise YAML frontmatter, trigger-rich description, and procedural body sections.
Step 3: Choose the Skill ID and Path
  • New built-in skill path: skills/<skill-id>/SKILL.md
  • Keep <skill-id> short, hyphen-case, and under 64 characters.
  • Use a verb-led or domain-led name that makes the trigger obvious, such as transfer-failed-retry, moviepilot-api, or create-moviepilot-skill.
Step 4: Write Frontmatter Correctly

Use this shape:

markdown
---
name: create-moviepilot-skill
version: 1
description: >-
  Explain what the skill does and exactly when to use it.
allowed-tools: read_file write_file edit_file execute_command
---

Rules:

  • description is the primary trigger surface. Put concrete "when to use" scenarios there.
  • Include version for built-in skills. Increment it whenever you ship a new built-in revision.
  • Add allowed-tools when the workflow depends on a small, well-defined tool set.
  • Add compatibility only when environment constraints actually matter.
Step 5: Write the Body

The body should contain:

  • A short purpose statement
  • MoviePilot-specific rules or guardrails
  • A step-by-step workflow
  • Concrete examples of matching user requests
  • References to supporting files when they exist

Prefer:

  • Imperative instructions
  • Concrete file paths
  • Examples aligned with actual MoviePilot conventions

Avoid:

  • Generic theory that does not change execution
  • Large duplicated documentation
  • Extra files like README.md or CHANGELOG.md inside the skill directory
Show full SKILL.md (249 more words)Show less
Step 6: Add Supporting Files Only When They Help
  • Add scripts/ only when the same deterministic work would otherwise be rewritten repeatedly.
  • Keep helper files inside the same skill directory.
  • Reference helper paths explicitly from SKILL.md.
  • If the skill is instructions-only, keep it to a single SKILL.md.
Step 7: Implement the Skill

For a new built-in skill:

  1. Create skills/<skill-id>/
  2. Create SKILL.md
  3. Add helper scripts only if they are justified

For an existing built-in skill:

  1. Edit skills/<skill-id>/SKILL.md
  2. Increment version
  3. Update helper files in the same directory if needed
Step 8: Validate Before Finishing
  • Re-read the frontmatter and confirm name matches the directory name.
  • Confirm description mentions real trigger scenarios.
  • If you changed an existing built-in skill, confirm version increased.
  • If possible, validate the file can be parsed by the MoviePilot skills loader.
  • Report the final path and note whether the agent needs a restart to sync the latest built-in skill into config/agent/skills.

Minimal Example

User request:

给 MoviePilot agent 加一个处理站点 Cookie 更新的内置技能

Expected outcome:

  • Create or update a directory such as skills/update-site-cookie/
  • Write SKILL.md with a trigger-rich description
  • Include only the tools needed for that workflow
  • Increment version when revising an existing built-in skill

Final Checklist

  • Is the skill under the repository skills/ directory?
  • Does the folder name equal frontmatter name?
  • Does description clearly say when the skill should trigger?
  • Did you avoid duplicating an existing skill unnecessarily?
  • Did you increment version for built-in skill updates?
  • Did you keep the skill lean and procedural?

© 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/create-moviepilot-skill of jxxghp/MoviePilot.

Open the folder on GitHubat commit 28e1cb3

Compare with similar skills

Create MoviePilot Skill 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.

Create MoviePilot Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create MoviePilot Skill this skilljxxghp/MoviePilot12k—~1.4kAutomated safety check: PassGPL-3.0
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    67k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

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 Create MoviePilot Skill

What does Create MoviePilot Skill do?

Guides creating, updating and reviewing built-in MoviePilot agent skills: file layout, frontmatter, allowed tools and the version bump that syncs changes to users. This workflow is for built-in skills kept in the MoviePilot repository. The repository's skills/ folder is the source of truth, and bundled skills are copied into config/agent/skills at startup.

When should I use Create MoviePilot Skill?

Create MoviePilot Skill fits situations like: adding a new built-in skill to the MoviePilot repository; editing an existing built-in skill and bumping its version; reviewing a MoviePilot skill's frontmatter and trigger description.

How do I install Create MoviePilot Skill in Claude Code?

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

How do I install Create MoviePilot Skill in Codex?

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

Can I use Create MoviePilot Skill 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 create-moviepilot-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-moviepilot-skill, .gemini/skills/create-moviepilot-skill, .github/skills/create-moviepilot-skill and .opencode/skills/create-moviepilot-skill in your project.

What does Create MoviePilot Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Create MoviePilot Skill is instructions for the agent only. Our summary lists: A checkout of the MoviePilot repository. Its frontmatter pre-approves these tools: read_file, write_file, edit_file, apply_patch, execute_command.

Does Create MoviePilot Skill 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 Create MoviePilot Skill 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 Create MoviePilot Skill use?

Create MoviePilot Skill 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 Create MoviePilot Skill use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Create MoviePilot Skill?

Skills that share tags, products or a category with Create MoviePilot Skill: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create MoviePilot Skill?

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.