| name | late-episode-troubleshooter |
| description | The "poke" workflow: an episode (or movie) that should already be out wasn't grabbed automatically. Confirm it aired, run an interactive search, pick the best release by seeders, grab it, and verify it entered the queue.
TRIGGER THIS SKILL WHEN: - "A new episode of <show> should be out but nothing downloaded" - "Sonarr/Radarr didn't grab <title> — can you poke it?" - "Why hasn't <episode/movie> downloaded yet?" - "Manually grab the latest episode of <show>"
SYMPTOMS that you skipped this skill: - Grabbing the first release returned instead of the best by seeders - Grabbing a release whose `rejected` is true - Not verifying the grab actually entered the queue
|
| metadata | {"version":1} |
Late episode / movie troubleshooter (the "poke")
Use this when something that should have downloaded didn't. Read
references/decision-tree.md for the full branch logic.
Step-by-step
1. Locate the item and confirm it should exist
- TV:
sonarr_search_library to get the seriesId, then sonarr_missing_episodes
(or sonarr_list_episodes filtered to the season) to find the specific
episodeId. Confirm airDate is in the past — an episode that hasn't aired yet
has no release, so there's nothing to grab.
- Movie:
radarr_missing_movies to find the movieId and confirm status is
"released" (or a digital release date in the past).
2. Rule out the boring causes first
If there are several late items, run sonarr_health / radarr_health once:
no enabled indexers ⇒ search returns nothing; no download client ⇒ grabs fail.
Fix or report that before searching. See the library-health-and-diagnostics skill.
3. Interactive search
- TV:
sonarr_search_releases with the episodeId.
- Movie:
radarr_search_releases with the movieId.
Results come back sorted by seeders descending. If the list is empty, the
release simply isn't available on the configured indexers yet — tell the user, don't
grab something wrong.
4. Pick the right release
Apply the interactive-release-search skill. In short: skip rejected: true
releases, prefer healthy seeders, and respect the quality the user expects. The
top-seeded result is usually right, but not if it's a wrong-quality or rejected one.
5. Grab and verify
- Grab with
sonarr_grab_release / radarr_grab_release using the chosen
guid + indexerId.
- Verify with
sonarr_queue / radarr_queue that the item now appears with a
downloading/queued status. If it's not there or shows an error, surface it.
Confirm before grabbing
State which release you intend to grab (title, quality, size, seeders) and grab it.
For a single obvious match you may grab directly, but never grab a rejected release.
