library-health-and-diagnostics

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

1. 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.
2. 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).
3. Download clients. If there are zero clients (or all disabled), grabs will fail even when a release is found. Report it.
4. 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.