Readarr Operations

VerifiedCaution

Manage your Readarr library, search for books, and monitor downloads. Includes service health checks and API interactions.

Sby Skills Guide Bot
ContentIntermediate
206/2/2026
Claude Code
#readarr#library-management#book-search#media-server#automation

Recommended for

Our review

Automates Readarr library management: search for books, add titles, and monitor service health.

Strengths

  • CLI-based searching and adding books quickly.
  • Health check command to verify Readarr is running.
  • Direct Usenet search via NZBGeek integration.
  • One-command auto-add of the first matching result (Auto-Learn).

Limitations

  • Requires a local Readarr installation and proper configuration.
  • API key is optional but restricts functionality to localhost without it.
  • Auto-add only selects the first result, which may be inaccurate.
When to use it

Use this skill to manage your ebook library through Readarr without a GUI.

When not to use it

Avoid using it if you lack Usenet access or manage other media types (movies, music) not supported by Readarr.

Security analysis

Caution
Quality score85/100

The skill is designed for legitimate media management, but it invokes shell commands and interacts with an external Usenet indexer, which introduces moderate risk. No obvious destructive or exfiltrating patterns, but caution is advised.

Findings
  • Skill uses run_command, which could execute arbitrary shell commands if misused, though only for intended Readarr operations.
  • Network calls to external service NZBGeek in nzb-search command, which might be used to retrieve content of unknown safety.
  • API key handling via environment variable could be logged or leaked if not careful.

Examples

Search for a book
Search for the book 'The Art of Exploitation' using Readarr.
Add a book
Add the book 'Hacking: The Art of Exploitation' to my Readarr library.
Check Readarr health
Check if my Readarr service 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