| name | library-health-and-diagnostics |
| description | How to diagnose "why isn't anything downloading?" and "is everything OK?" by checking system health, disk space, indexers, and download clients before concluding something is broken.
TRIGGER THIS SKILL WHEN: - "Why isn't anything downloading?" / "nothing gets grabbed anymore" - "Is Sonarr/Radarr healthy?" / "any problems?" - "Am I running low on disk space?" - Interactive searches keep returning zero releases
SYMPTOMS that you skipped this skill: - Blaming a missing download on bad luck without checking indexers/clients - Trying to grab releases when no download client is configured
|
| metadata | {"version":1} |
Health & diagnostics
Run sonarr_health / radarr_health first. It returns version, health-check
messages, free disk space, and indexer + download-client status.
Read it in this order
- Health messages.
type: error/warning items are the app telling you exactly
what's wrong (e.g. "No indexers available", "Download client unavailable",
"Root folder missing"). Address these first.
- Indexers. If there are zero indexers, or none have
enabledInteractive/
enabledAutomatic, then searches will return nothing — that's the cause of "nothing
downloads". Report it; MCPArr doesn't configure indexers (do that in the web UI).
- Download clients. If there are zero clients (or all disabled), grabs will fail
even when a release is found. Report it.
- Disk space. Low/zero free space stops imports. Flag any volume under, say,
a few GB free.
Mapping symptoms to causes
| Symptom | Likely cause | What to tell the user |
|---|
| Search returns 0 releases for everything | No/disabled indexers | Configure/enable an indexer in the UI. |
| Releases found but grabs error | No/disabled download client | Configure/enable a client in the UI. |
| Downloads complete but never import | Disk full / permissions / path | Free space or fix the root folder. |
| "Is everything OK?" and all green | Healthy | Confirm version + free space succinctly. |
Scope
MCPArr is for operating Sonarr/Radarr, not configuring their indexers/clients.
When the fix is a configuration change, explain what to change and where, rather than
attempting it through the API.
