Agent skill

MoviePilot Failed Transfer Retry

by jxxghp in jxxghp/MoviePilot

Retries failed MoviePilot video and music transfer records one verified group at a time, keeping retry evidence and re-identifying only legacy records that were actually deleted.

GPL-3.0Auto-check passedProductivity & Automation

Install MoviePilot Failed Transfer Retry

skills CLI
$ npx skills add jxxghp/MoviePilot --skill transfer-failed-retry -a claude-code

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

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

At a glance

Retries failed MoviePilot video and music transfer records one verified group at a time, keeping retry evidence and re-identifying only legacy records that were actually deleted.

  • Works in 8 steps: Call transfer.history with status=failed… → If the source no longer exists or… → Group records only when identity and… → …
  • Retrying MoviePilot transfers that show as failed for a given list of history IDs
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Reorganizing a failed album or series without mixing up the identification of unrelated files

What it does

This skill handles specific failed transfer history IDs in MoviePilot using only the structured moviepilot_api operations. The agent first fetches the failed history and finds every requested ID, writing down source path and storage, destination, mode, identity, music type, season and episode, status and error, and never touches a record that was not asked for. If the source file is gone or the transfer directory setting is missing, it stops for that record and reports the blocker.

Records are grouped only when their identity and source layout prove they are the same movie, series, recording or album, since a shared parent folder is not proof. Each exact history ID is deleted before the retry, which can instead hand the record to a persistent retry scheduler; if that happens the result is final for the task. Only when a legacy history was truly deleted does the agent recognize the media from the source path, fall back to a narrow search, and call the file transfer with the original source, storage and mode. Accepted retries, retransfers, skipped cases and remaining failures are reported separately, and a queued retry is never presented as a completed transfer.

When your agent uses it

  • Retrying MoviePilot transfers that show as failed for a given list of history IDs
  • Reorganizing a failed album or series without mixing up the identification of unrelated files
  • Reporting which failed transfers were retried, skipped for missing files or still failing

Example prompts

  • “Retry the three failed MoviePilot transfer history IDs I listed in my last message.”
  • “These failed music transfers are all one album folder, so retry them and tell me what is still broken.”
  • “Check why this one failed history record broke and re-run it only if the source file still exists.”

Requirements

  • Access to a MoviePilot instance through the moviepilot_api tool
  • Pre-approved tools (allowed-tools): moviepilot_api

Workflow steps

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

  1. Call transfer.history with status=failed and locate every requested ID.
  2. If the source no longer exists or transfer-directory configuration is
  3. Group records only when identity and source layout prove they belong to the
  4. Call transfer.history.delete for each exact history ID before retrying.
  5. If the result says durable retry was accepted or rejected, that result is
  6. Only when the response confirms a legacy history was actually deleted may
  7. Call transfer.file with the original source/storage/mode and the verified
  8. Report accepted durable retries, successful legacy retransfers, skipped

What it can do on your machine

Read from SKILL.md and the folder at commit 5b19d31. 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:

    • moviepilot_api

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

MoviePilot Failed Transfer Retry loads about 584 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 263 words of instructions outside code blocks.

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

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 5b19d31, republished under its GPL-3.0 licence (© jxxghp). 263 words, ~584 tokens.

Download SKILL.mdSave it as .claude/skills/transfer-failed-retry/SKILL.md (or your agent's skills folder).
name
transfer-failed-retry
description
Use this skill for failed MoviePilot video or music transfer history IDs. Inspect the exact records, preserve durable retry evidence, group only records with a trustworthy shared identity, and re-identify/reorganize only legacy records that were actually deleted.
allowed-tools
moviepilot_api
version
5
allowed-api-operations
transfer.history transfer.history.delete media.recognize media.search transfer.file

Transfer Failed Retry

Use structured moviepilot_api operations only.

Required Flow

  1. Call transfer.history with status=failed and locate every requested ID. Record source path/storage, destination, mode, exact identity, music type, season/episode, status, and error. Do not act on a different record.
  2. If the source no longer exists or transfer-directory configuration is missing, stop for that record and report the blocker.
  3. Group records only when identity and source layout prove they belong to the same movie, series, recording, or album. Same parent directory alone is not enough. Recognize once per verified group.
  4. Call transfer.history.delete for each exact history ID before retrying. This operation may submit a durable record to the persistent retry scheduler instead of deleting it.
  5. If the result says durable retry was accepted or rejected, that result is final for the current task. Do not call transfer.file, delete the target, or remove history/retry evidence.
  6. Only when the response confirms a legacy history was actually deleted may you continue. First call media.recognize with the source path. If the result is absent or unreliable, call media.search with narrow filename/tag facts.
  7. Call transfer.file with the original source/storage/mode and the verified source-native identity. Preserve season and music entity fields. For a verified complete album sharing one directory, retry the directory once, not each track as unrelated media.
  8. Report accepted durable retries, successful legacy retransfers, skipped missing/configuration cases, and remaining failures separately.

Never transfer an artist entity. Never reuse one identification across records that do not form a verified group. Never report a queued durable retry as a completed file transfer.

© 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/transfer-failed-retry of jxxghp/MoviePilot.

Open the folder on GitHubat commit 5b19d31

Compare with similar skills

MoviePilot Failed Transfer Retry 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.

MoviePilot Failed Transfer Retry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MoviePilot Failed Transfer Retry this skilljxxghp/MoviePilot12k—~584Automated safety check: PassGPL-3.0
Skyvern Browser AutomationSkyvern-AI/skyvern23k1 repos~2.9kAutomated safety check: PassAGPL-3.0
Disk Storage AnalyzerKKKKhazix/khazix-skills21k1 repos~1.4kAutomated safety check: PassMIT
N8n CLIn8n-io/n8n207k—~3kAutomated safety check: PassCustom licence
Feishu Bitable Managementop7418/CodePilot6.5k1 repos~1.7kAutomated safety check: PassCustom licence
CUAWright Web Task Automationmicrosoft/CUAWright6k—~2kAutomated safety check: NotesMIT

Similar skills

  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Picks the right Skyvern CLI command for a web task, from quick yes/no checks to reusable multi-page workflows, instead of falling back to plain page fetching.

    23k GitHub starsUsed in 1 repo~2.9k tokens
    Productivity & AutomationAuto-check passed
  • Disk Storage Analyzer

    KKKKhazix/khazix-skills

    Scans a Mac or Windows PC read-only to find what fills the disk, grades each item by how safe it is to clean and builds an interactive HTML report.

    21k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • N8n CLI

    n8n-io/n8n

    Official

    Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance.

    207k GitHub stars~3k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Creates, queries and edits Feishu Bitable tables through tool calls, covering records, fields, views and batch operations with the correct value format for each field type.

    6.5k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Official

    Solves web tasks by driving a local Playwright browser one bash command at a time, saving a reusable script, screenshots and an action log for each run.

    6k GitHub stars~2k tokensUpdated 4 days ago
    Productivity & AutomationAuto-check: notes
  • Refly Skill Runner

    refly-ai/refly

    Base skill for the Refly ecosystem: finds, runs and monitors workflow-backed skills through the refly command line, with the actual work done on the Refly backend.

    7.5k GitHub stars~1.7k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-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

Questions about MoviePilot Failed Transfer Retry

What does MoviePilot Failed Transfer Retry do?

Retries failed MoviePilot video and music transfer records one verified group at a time, keeping retry evidence and re-identifying only legacy records that were actually deleted. This skill handles specific failed transfer history IDs in MoviePilot using only the structured moviepilot_api operations. The agent first fetches the failed history and finds every requested ID, writing down source path and storage, destination, mode, identity, music type, season and episode, status and error, and never touches a record that was not asked for.

When should I use MoviePilot Failed Transfer Retry?

MoviePilot Failed Transfer Retry fits situations like: retrying MoviePilot transfers that show as failed for a given list of history IDs; reorganizing a failed album or series without mixing up the identification of unrelated files; reporting which failed transfers were retried, skipped for missing files or still failing.

How do I install MoviePilot Failed Transfer Retry in Claude Code?

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

How do I install MoviePilot Failed Transfer Retry in Codex?

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

Can I use MoviePilot Failed Transfer Retry 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 transfer-failed-retry -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/transfer-failed-retry, .gemini/skills/transfer-failed-retry, .github/skills/transfer-failed-retry and .opencode/skills/transfer-failed-retry in your project.

What does MoviePilot Failed Transfer Retry need to run?

SKILL.md names no scripts, command-line tools or credentials: MoviePilot Failed Transfer Retry is instructions for the agent only. Our summary lists: Access to a MoviePilot instance through the moviepilot_api tool. Its frontmatter pre-approves these tools: moviepilot_api.

Does MoviePilot Failed Transfer Retry 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 MoviePilot Failed Transfer Retry 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 MoviePilot Failed Transfer Retry use?

MoviePilot Failed Transfer Retry 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 MoviePilot Failed Transfer Retry use?

About 584 tokens (SKILL.md is roughly 2.3k 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 MoviePilot Failed Transfer Retry?

Skills that share tags, products or a category with MoviePilot Failed Transfer Retry: Skyvern Browser Automation (Skyvern-AI/skyvern, 23k stars), Disk Storage Analyzer (KKKKhazix/khazix-skills, 21k stars), N8n CLI (n8n-io/n8n, 207k stars) and Feishu Bitable Management (op7418/CodePilot, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MoviePilot Failed Transfer Retry?

jxxghp (a GitHub user) maintains it in jxxghp/MoviePilot, which has 11,858 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 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.