Readarr Management

VerifiedCaution

Manage a Readarr library, search for books, monitor downloads, and perform health checks. Useful for automating book acquisition and ensuring Readarr is running.

Sby Skills Guide Bot
ContentBeginner
606/2/2026
Claude CodeCursorWindsurf
#readarr#ebook-management#library-automation#nzb-search#book-downloader

Recommended for

Our review

Manage your Readarr library: search and add books, monitor downloads, and check service health.

Strengths

  • Quick search for books and authors within the Readarr library
  • Auto-adds the first search result as a book
  • Health check to ensure Readarr service is running
  • Direct Usenet search via NZBGeek integration

Limitations

  • Requires a running Readarr instance
  • Auto-add may not match the exact edition you want
  • Depends on network configuration and API key for NZBGeek
When to use it

Use this skill to automate adding books to your Readarr library and monitor its health.

When not to use it

Avoid this skill if you need to manage non-book media libraries (movies, music).

Security analysis

Caution
Quality score90/100

The skill performs legitimate automation tasks (searching, adding books) via network calls and service management. While not inherently destructive, it uses run_command to interact with external APIs and control a local service, which could be risky if misconfigured or exploited. The API key is handled via env var, reducing hardcoded secret risks, but the network activity warrants a caution rating.

Findings
  • Uses run_command for network interactions with external services (NZBGeek) and local service management.
  • API key is read from environment variable, but mishandling could expose it.

Examples

Add a book by title
Add the book 'Hacking: The Art of Exploitation' to my Readarr library.
Check Readarr health
Check if my Readarr service is running and healthy.
Search for a book
Search for 'The Art of Exploitation' in my Readarr library.

name: readarr-ops description: > Manage Readarr library, search for books, and monitor downloads. Handles service health checks and API interactions. allowed-tools:

  • run_command
  • read_file triggers:
  • readarr
  • manage books
  • add book
  • search book metadata: short-description: Manage Readarr library and downloads

readarr-ops

Manage Readarr library, search for books, and monitor downloads.

Commands

  • search <term>: Search for books/authors in Readarr.
  • nzb-search <term>: Direct Usenet search via NZBGeek.
  • add <term>: Search and add the first matching book (Auto-Learn).
  • health: Check if Readarr is running and healthy.
  • ensure-running: Start Readarr if not running.

Usage

# Check health
./run.sh health

# Search for a book
./run.sh search "The Art of Exploitation"

# Add a book
./run.sh add "Hacking: The Art of Exploitation"

Configuration

  • Readarr Path: ~/workspace/experiments/Readarr/Readarr
  • Data Path: ~/workspace/experiments/Readarr/data
  • Port: 8787
  • API Key: READARR_API_KEY env var (optional for localhost in some configs)
Related skills