sonarr

sonarr is a skill for Claude Code from jmagar/claude-homelab. It costs 75 tokens per session (1,241 once invoked), scanned A, original, MIT.

A Sonarr assistant for managing a library of TV shows. Sonarr is an application that finds, downloads, and organises television episodes.

In plain words
What is it for?
It helps search for series, add them to Sonarr, check whether they are already present, view available folders and quality settings, and remove shows.
Why use it?
It avoids switching between searches, library checks, download settings, and removal actions when managing shows. It also makes potentially destructive removals require confirmation.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: reads .claude/ paths.

Part of the homelab-core plugin — 18 skills, 5 commands, 1 agent shipped together

Good fit It helps search for series, add them to Sonarr, check whether they are already present, view available folders and quality settings, and remove shows.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jmagar/claude-homelab/sonarr
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add jmagar/claude-homelab --skill sonarr
Clone the repo
git clone --depth 1 https://github.com/jmagar/claude-homelab

Made for: Claude Code.

Or install homelab-core, the plugin that ships this one along with the rest of its 18 skills, 5 commands, 1 agent.

Its marketplace also offers this one on its own, as the plugin sonarr — /plugin install sonarr after adding the marketplace above.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for sonarr

README.md
[![agentmods](https://agentmods.dev/badge/skills/jmagar/claude-homelab/sonarr/github.svg)](https://agentmods.dev/skills/jmagar/claude-homelab/sonarr)
Your own site
<a href="https://agentmods.dev/skills/jmagar/claude-homelab/sonarr"><img src="https://agentmods.dev/badge/skills/jmagar/claude-homelab/sonarr/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for sonarr

Your own site · 80×15
<a href="https://agentmods.dev/skills/jmagar/claude-homelab/sonarr"><img src="https://agentmods.dev/badge/skills/jmagar/claude-homelab/sonarr.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 75 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,241 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Rogue Agent · line 29
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00075 $0.01241
Opus 5.5 $0.00030 $0.00496
Sonnet 5.5 $0.00015 $0.00248
Haiku 4.5 $0.00007 $0.00124

Measured 1mo ago against content hash 97844db74f88, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

sonarr scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

The scan reads SKILL.md. This mod also ships 2 executable files (load-env.sh, scripts/sonarr.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/sonarr/SKILL.md · 157 lines

How it starts

The opening of the file, as written. The whole thing — 157 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Sonarr TV Show Management Skill

⚠️ MANDATORY SKILL INVOCATION ⚠️

YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:

  • "add a TV show", "search Sonarr", "find a series", "add to Sonarr"
  • "remove a show", "delete show", "check if show exists"
  • "Sonarr library", "TV show management", "add show"
  • Any mention of Sonarr or managing TV shows

Failure to invoke this skill when triggers occur violates your operational requirements.

Search and add TV shows to your Sonarr library with support for monitor options, quality profiles, and search-on-add.

Purpose

This skill enables management of your Sonarr TV show library:

  • Search for TV shows by name
  • Add shows to your library with configurable options
  • Check if shows already exist
  • Remove shows (with optional file deletion)
  • View quality profiles and root folders

Operations include both read and write actions. Always confirm before removing shows with file deletion.

Setup

Add credentials to .env file: ~/.claude-homelab/.env

SONARR_URL="http://localhost:8989"
SONARR_API_KEY="<your_api_key>"
SONARR_DEFAULT_QUALITY_PROFILE="1"  # Optional: defaults to 1 if not set

Configuration variables:

  • SONARR_URL: Your Sonarr server URL (no trailing slash)
  • SONARR_API_KEY: API key from Sonarr (Settings → General → API Key)
  • SONARR_DEFAULT_QUALITY_PROFILE: Quality profile ID (optional, defaults to 1)

Commands

All commands return JSON output.

Search for Shows

bash scripts/sonarr.sh search "Breaking Bad"
bash scripts/sonarr.sh search "The Office"

Output: Numbered list with TVDB IDs, titles, years, and overview.

Check if Show Exists

bash scripts/sonarr.sh exists <tvdbId>

Output: Boolean indicating if show is in library.

Add a Show

bash scripts/sonarr.sh add <tvdbId>              # Searches immediately (default)
bash scripts/sonarr.sh add <tvdbId> --no-search  # Add without searching

Read the full file on GitHub · 157 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 157 lines · 75 tokens per session scan A 97844db74f88

Subscribe to this mod's changes

sonarr is a skill published in the GitHub repository jmagar/claude-homelab (87 stars, last pushed 25d ago), licensed MIT. It adds 75 tokens to every session and 1,241 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

neurolink-guide

Guide for using the NeuroLink SDK and CLI. Invoke when users ask how to use neurolink, integrate AI providers, add MCP tools, configure RAG, set up memory, deploy servers, or work with multimodal content. Covers SDK, CLI, providers, tools, and enterprise features.

juspay/neurolink · 65 tokens

github-commenting

How to post clean, rich, deduplicated GitHub PR review comments — suggestion blocks, multi-line anchors, markers, formatting rules. Load before posting or fixing any PR comment.

juspay/neurolink · 41 tokens

repo-conventions

NeuroLink's review standards — the critical rules to enforce, what NOT to comment on, the security bar, hot paths. Load before reviewing any change in this repository.

juspay/neurolink · 39 tokens

generative-ui

Use when presenting information already in hand as a small, static structured panel in the conversation — status, results, comparisons, or a compact summary — rather than prose, a markdown table, a widget, or an app.

bearlike/Assistant · 48 tokens

st-widget-builder

Use when the user asks to render, build, visualise, mock up, or show a widget (chart, dashboard, card, table, graph) in the Mewbo Console. Teaches how to delegate the work to the st-widget-builder sub-agent instead of writing HTML or inline code yourself.

bearlike/Assistant · 65 tokens

device-control

Use when driving the user's Android device through devicecontrolstart, deviceui and deviceaction — opening apps, navigating screens, filling fields, or any multi-step flow through another app's UI.

bearlike/Assistant · 41 tokens