/transfer-failed-retry

name: transfer-failed-retry
version: 5
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
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.