MichaelVessia/prowlarr
modules/programs/agents/shared/skills/prowlarr/SKILL.md
Search across indexers and manage my self-hosted Prowlarr. Use when the user asks about indexer search, finding a release, indexer health/stats, listing or testing indexers, syncing indexers to Sonarr/Radarr, or mentions Prowlarr.
$ install --global
skillsauthnpx skillsauth add MichaelVessia/nixos-config prowlarrInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 25, 2026, 5:48 AM115.3s6 files scanned
SKILL.md
- name:
- prowlarr
- description:
- Search across indexers and manage my self-hosted Prowlarr. Use when the user asks about indexer search, finding a release, indexer health/stats, listing or testing indexers, syncing indexers to Sonarr/Radarr, or mentions Prowlarr.
- allowed-tools:
- Bash, WebFetch
Prowlarr
Manage my self-hosted Prowlarr (v1 API) indexer aggregator: search across all configured indexers, inspect indexer health and stats, test/enable/disable indexers, list connected apps, sync indexer config to Sonarr/Radarr/etc.
Environment
Credentials are exported into the shell by sops-nix (see
modules/programs/shell.nix):
PROWLARR_URL— base URL (no trailing slash)PROWLARR_API_KEY— API key
The prowlarr CLI reports a JSON error envelope when they are missing.
CLI
Use the installed prowlarr CLI for common operations. It always emits a single
JSON envelope with ok, command, result or error, and next_actions.
scripts/prowlarr.sh remains as a compatibility shim for older workflows.
prowlarr status # system/status sanity check
prowlarr health --limit 25 # health warnings
prowlarr indexers --limit 50 # list indexers
prowlarr indexer-stats --limit 50 # per-indexer usage + failures
prowlarr search "ubuntu 24.04" --limit 25 # search all indexers
prowlarr search "inception" --torrents
prowlarr search "inception" --usenet
prowlarr search "inception" --category 2000
prowlarr tv-search --tvdb 81189 --season 1 --episode 1
prowlarr movie-search --imdb tt0111161
prowlarr movie-search --tmdb 278
prowlarr test <indexerId> # test one indexer
prowlarr apps --limit 25 # connected apps (Sonarr/Radarr/...)
prowlarr sync --confirm-sync # push indexer config to apps
prowlarr history --limit 50 # recent indexer history
For anything not covered, call the API directly with $PROWLARR_URL and
$PROWLARR_API_KEY — see references/api-endpoints.md and
references/quick-reference.md.
Workflow: finding a release
prowlarr search "<query>"— top results across all indexers, with seeders, size, indexer name, and download URL.- Filter with
--torrents,--usenet, or--category <id>if the user wants narrower results (2000=Movies, 5000=TV, 3000=Audio, 7000=Books). - For TV/movie lookups by external ID, prefer
tv-search/movie-search— indexers match more accurately than a free-text query.
Workflow: indexer health check
prowlarr indexer-stats— shows query counts and failures.prowlarr health— surfaces Prowlarr's own warnings.- For a specific indexer suspected to be broken, run
prowlarr test <indexerId>.
Mutations: confirm first
Always confirm with the user before:
- Disabling or deleting an indexer (raw
PUT/DELETEagainst/api/v1/indexer/{id}). prowlarr sync --confirm-sync— this is generally safe (idempotent) but pushes config to every connected app; mention that side effect.- Any custom DELETE/PUT against
/api/v1.
References
references/api-endpoints.md— v1 endpoint reference with request/response shapesreferences/quick-reference.md— copy-paste curl recipes for common opsreferences/troubleshooting.md— auth, connection, and common error fixes
Notes
- API is v1. There is no v3 — using
/api/v3/...returns 404. X-Api-Keyheader beats?apikey=(avoids leaking the key into logs).- Prowlarr is search-only: it does not download. Hand a release URL to Sonarr/Radarr/SABnzbd to actually grab it.
- Category IDs follow the Newznab/Torznab standard (Movies 2000-2099, TV 5000-5099, etc.).
- Prowlarr lives on the LAN. If
PROWLARR_URLis unreachable, surface that to the user rather than guessing.
Related Skills
MichaelVessia/bro
development
VerifiedTrustedCommunity
Restate the last message in plain human language, with no jargon.
2SKILL.mdUpdated Jul 23, 2026
MichaelVessia/fanout-prs
testing
VerifiedTrustedCommunity
Fan out a batch of work items into one PR each via isolated worktree agents, review every PR before it opens, then babysit all PRs through green CI and review feedback. Use when the user wants to fan out PRs, dispatch parallel PR agents over a list of items, or run a batch of independent changes as separate PRs.
2SKILL.mdUpdated Jul 10, 2026
MichaelVessia/herdr-dispatch
development
VerifiedTrustedCommunity
Dispatch user-visible coding or research agents through Herdr with Codex-Desktop-like thread ergonomics. Use when the user asks to use Herdr to spawn, dispatch, fan out, inspect, follow up with, or monitor agent workspaces/threads.
2SKILL.mdUpdated Jun 30, 2026
MichaelVessia/plannotator-visual-explainer
development
VerifiedTrustedCommunity
Generate self-contained HTML visualizations with Plannotator theming. Use for implementation plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive approach; all other visual content delegates to nicobailon/visual-explainer.
2SKILL.mdUpdated Jun 12, 2026