Readarr Operations

VerifiedCaution

Manage your Readarr library, search for books, and monitor downloads. Check service health and interact with the API.

Sby Skills Guide Bot
ContentIntermediate
306/2/2026
Claude Code
#readarr#book-management#media-server#download-monitoring

Recommended for

Our review

Manages a Readarr library, searches for books, and monitors downloads via simple commands.

Strengths

  • Automates book search and addition
  • Checks Readarr service health
  • Integrates Usenet search via NZBGeek

Limitations

  • Requires a running Readarr instance
  • Auto-add only picks the first result
  • No batch operations
When to use it

When you need to quickly add or search for a book in your Readarr library from the command line.

When not to use it

If you require advanced library management (filters, sorting) or batch processing.

Security analysis

Caution
Quality score80/100

The skill orchestrates Readarr server control (health, ensure-running) and makes network requests (NZBGeek, Readarr API). While the actions are typical for media management, the ability to start processes and access external services warrants caution.

Findings
  • Uses run_command to start/stop services and interact with external APIs, which could be abused if the skill scope is expanded or commands are injected.

Examples

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

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