| name | queue-management |
| description | How to inspect the download queue and deal with stuck, stalled, or failed downloads — when to remove, when to blocklist + re-search, when to wait.
TRIGGER THIS SKILL WHEN: - "What's downloading right now?" / "show me the queue" - "This download is stuck / stalled / failed" - "Remove that download" / "blocklist it and find another" - "Why is the queue not moving?"
SYMPTOMS that you skipped this skill: - Removing a queue item without blocklisting, so the same bad release returns - Blocklisting a healthy, slowly-progressing download - Not re-searching after removing a failed grab
|
| metadata | {"version":1} |
Queue management
1. Look at the queue
sonarr_queue / radarr_queue. For each item note status,
trackedDownloadState, trackedStatus, error, and timeleft.
Common states:
- downloading / queued, time remaining shrinking → healthy, just wait.
- stalled (no peers) → torrent with no seeders; unlikely to finish.
- warning / error with a message → import failed, disk full, etc. Read
error.
- completed but stuck on import → usually a path/permission issue; report it.
2. Decide the action
| Situation | Action |
|---|
| Healthy, progressing | Do nothing; report ETA. |
| Stalled / no seeders | Remove with blocklist, then re-search for a better release. |
| Failed / errored grab | Remove with blocklist, then re-search. |
| Wrong release grabbed | Remove with blocklist; grab the correct one. |
| Disk full / health issue | Don't blocklist — fix the underlying issue (see health skill). |
3. Remove (and usually blocklist)
sonarr_remove_queue_item / radarr_remove_queue_item:
removeFromClient: true (default) deletes the failed download from the client.blocklist: true prevents that exact release from being grabbed again — use it for
bad/stalled releases so the re-search picks something different.
4. Re-search after removal
After removing a bad download, the item is missing again — run the interactive search
(*_search_releases) and grab a different release. This is the
late-episode-troubleshooter loop.
Caution
Always confirm before removing items that are still progressing. Blocklisting a good
release just because it's slow can push the next search toward a worse option.
