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 $0.00037 $0.00620
Sonnet 5 $0.00015 $0.00248
Haiku 4.5 $0.00007 $0.00124

Measured 11d ago against content hash 97844db74f88, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, 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 11d 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. 11d 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 (78 stars, last pushed 1mo ago), licensed MIT. It adds 75 tokens to every session and 1,241 once invoked, about $0.0004 per session on Opus 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

jira-delivery

Close the needs-fix branch for both ticket classes: isolated git worktree, a red test BEFORE any implementation on change tickets, delegation to a core executor, every publish action (push / PR / comment / QA transition) gated behind a green @verification-agent verdict, commit + push + PR, then writeback via…

atretyak1985/swarmery · 114 tokens

mission-creation

Use this skill to create and drive a UAV mission end-to-end through the web UI with the Playwright MCP browser tools on LOCALDEV (https:// ) — rebuild/redeploy, Keycloak login, the multi-step BYROUTE/REALTIME mission wizard, pre-flight, the Start-Mission FSM, AND the full per-drone flight-command lifecycle (arm →…

atretyak1985/swarmery · 176 tokens

aws-cicd-auth

Configure and review AWS auth for GitHub Actions CI/CD — OIDC role assumption, ECR push perms, ECS deploy perms, least-privilege IAM. Not for application IAM/Cognito, not for GCP.

atretyak1985/swarmery · 50 tokens

github-actions-cicd

Design, review, or debug GitHub Actions workflows — CI jobs (type-check, lint, test, build, security, summary), AWS ECR/ECS deploys, and a standardized per-repo workflow set. NOT for cloud-auth role/OIDC trust details (use aws-cicd-auth) or Dockerfile/image-build mechanics (use docker-build).

atretyak1985/swarmery · 78 tokens

jira-triage

Parse a Jira ticket past access preflight, classify it as a defect or a change, run the mandatory evidence step that class demands (reproduction / baseline + absence proof), and assign exactly one of five verdicts (already-fixed / cannot-reproduce / needs-fix / needs-info / too-large). NOT for posting the verdict back…

atretyak1985/swarmery · 95 tokens

mavlink-integration

Use this skill when a task involves MAVLink protocol communication via pymavlink, UART/UDP/TCP drone connections, ArduPilot SITL simulation, or telemetry message parsing in the edge service. Don't use it for raw UART hardware driver code without MAVLink framing (use embedded-systems), WebSocket transport to the web…

atretyak1985/swarmery · 86 tokens