Agent skill

Clawarr Suite

by LeoYeAI in LeoYeAI/openclaw-master-skills

Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa…

MITAuto-check: notesMedia & Creative

Install Clawarr Suite

skills CLI
$ npx skills add LeoYeAI/openclaw-master-skills --skill clawarr-suite -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install LeoYeAI/openclaw-master-skills clawarr-suite --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/clawarr-suite .claude/skills/clawarr-suite && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clawarr-suite
GitHub stars
2.2k
Token cost
~6.4k tokens
SKILL.md length
1,272 words
Files
39 (incl. scripts, references, assets)
Skills in repo
1,235
Repo updated
First seen
Licence
MIT

At a glance

Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa…

  • Works in 3 steps: Open any media item → "Get Info" → "View XML" → URL contains X-Plex-Token=...
  • Tasks that involve Transcription
  • SKILL.md covers Security & Scanner Clarity, Quick Start, Scripts Overview and Configuration, plus 1 more section
  • Runs Shell scripts from its folder; calls curl, jq and docker; reaches trakt.tv and simkl.com; needs PROWLARR_KEY and SONARR_KEY

What it does

Clawarr Suite is an agent skill from LeoYeAI/openclaw-master-skills. Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt…

Its SKILL.md is about 6.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 41 other files, including scripts, reference files and assets (for example `README.md`, `_meta.json` and `openclaw.plugin.json`).

It sits in Media & Creative, covering Transcription. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription

Example prompts

  • “/clawarr-suite”

Requirements

  • A Bash shell
  • Docker

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Open any media item
  2. "Get Info" → "View XML"
  3. URL contains X-Plex-Token=...

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • jq
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • trakt.tv
    • simkl.com
    • plex.tv

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PROWLARR_KEY
    • SONARR_KEY
    • RADARR_KEY
    • LIDARR_KEY
    • READARR_KEY
    • BAZARR_KEY
    • OVERSEERR_KEY
    • PLEX_TOKEN
    • TAUTULLI_KEY
    • SABNZBD_KEY
    • NOTIFIARR_KEY
    • TRAKT_CLIENT_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clawarr Suite loads about 6.4k tokens when it runs, and up to ~28k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 1,272 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~135
When it runs · the whole SKILL.md, loaded when a task matches
~6.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~28k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:430
    Store in `.env` file and source before running scripts.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,272 words, ~6,363 tokens.

Download SKILL.mdSave it as .claude/skills/clawarr-suite/SKILL.md (or your agent's skills folder). This skill also uses 38 other files; get the full folder from GitHub.
name
clawarr-suite
description
Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt, Letterboxd, Simkl).
homepage
https://github.com/omiron33/clawarr-suite

ClawARR Suite

Unified deep-integration control for self-hosted media automation stacks. This skill provides comprehensive agent-executable operations across the entire *arr ecosystem with rich analytics, dashboard generation, and advanced library exploration.

Security & Scanner Clarity

  • Local-first operations: all API calls target user-provided local hosts (typically LAN/NAS).
  • No embedded secrets: API keys/tokens are sourced from environment variables or user-owned config files.
  • No telemetry/exfiltration paths: scripts do not transmit credentials or library data to third-party endpoints.
  • Destructive behavior is opt-in: delete/remove actions require explicit command invocation by the user/agent.
  • Setup logic avoids dynamic eval and uses explicit variable mapping for scanner-friendly shell behavior.

Quick Start

First time setup (recommended):

bash
scripts/setup.sh <host-ip-or-hostname>

Discovers services, grabs API keys, verifies connections, and outputs your config.

Common operations:

bash
scripts/status.sh              # Health check all services
scripts/library.sh stats all   # Library statistics
scripts/analytics.sh activity  # Current Plex streams
scripts/dashboard.sh           # Generate HTML dashboard
scripts/manage.sh wanted all   # Show missing content
scripts/requests.sh list       # Overseerr requests

Scripts Overview

Core Operations
  • setup.sh — Guided setup wizard with auto-discovery
  • discover.sh — Scan host for *arr services
  • status.sh — Health check all configured services
  • diagnose.sh — Automated troubleshooting
Library Exploration (library.sh)

Deep statistics and exploration for Radarr/Sonarr/Lidarr:

bash
library.sh stats [app]          # Overall library stats
library.sh quality [app]        # Quality profile breakdown
library.sh missing [app]        # Missing/wanted content
library.sh unmonitored [app]    # Unmonitored items
library.sh recent [app] [days]  # Recently added (default: 7)
library.sh genres [app]         # Genre distribution
library.sh years [app]          # Year distribution
library.sh studios [app]        # Studio/network breakdown
library.sh nofiles [app]        # Monitored but no files
library.sh disk [app]           # Disk usage by root folder
Analytics (analytics.sh)

Rich viewing analytics from Tautulli/Plex:

bash
analytics.sh activity                 # Currently watching
analytics.sh history [count]          # Watch history
analytics.sh most-watched [period]    # Most watched (week/month/year)
analytics.sh popular-genres [period]  # Popular genres
analytics.sh peak-hours               # Peak watching hours
analytics.sh user-stats [user]        # User activity
analytics.sh library-stats            # Plex library stats
analytics.sh recent-added [count]     # Recently added to Plex
analytics.sh play-totals              # Total play statistics
Content Management (manage.sh)

Add, remove, and manage content:

bash
manage.sh add-movie "<title>" [quality] [root]
manage.sh add-series "<title>" [quality] [root]
manage.sh remove <app> <id>
manage.sh wanted [app]
manage.sh calendar [app] [days]
manage.sh history [app] [count]
manage.sh rename <app> <id>
manage.sh refresh <app> [id]
Request Management (requests.sh)

Overseerr request handling:

bash
requests.sh list [pending|approved|available|all]
requests.sh approve <id>
requests.sh deny <id> [reason]
requests.sh info <id>
requests.sh stats
Subtitle Management (subtitles.sh)

Bazarr operations:

bash
subtitles.sh wanted
subtitles.sh history [count]
subtitles.sh search <series|movie> <id>
subtitles.sh languages
Indexer Management (indexers.sh)

Prowlarr operations:

bash
indexers.sh list
indexers.sh test [id]
indexers.sh stats
Download Client (downloads.sh)

SABnzbd operations:

bash
downloads.sh active
downloads.sh speed
downloads.sh history [count]
downloads.sh pause
downloads.sh resume
downloads.sh queue
Dashboard Generation (dashboard.sh)

Generate self-contained HTML dashboard:

bash
dashboard.sh [output_file]

Creates beautiful dark-themed dashboard with:

  • System health
  • Download activity
  • Library statistics
  • Recent activity
  • Viewing analytics
  • Disk usage

Output defaults to clawarr-dashboard.html (open in any browser).

Media Tracker Integration (trakt.sh, trackers.sh, letterboxd.sh, simkl.sh)

Track and sync what you watch across services like Trakt.tv, Letterboxd, Simkl, and more.

Unified Interface (trackers.sh):

bash
trackers.sh setup              # Interactive setup wizard
trackers.sh status             # Show configured trackers
trackers.sh sync plex trakt    # Sync Plex → Trakt
trackers.sh export trakt json  # Export watch history
trackers.sh import letterboxd file.csv
trackers.sh compare trakt simkl

Trakt.tv Integration (trakt.sh):

Authentication:

bash
trakt.sh auth                  # Device code OAuth flow
trakt.sh auth-status           # Check authentication

Profile & Stats:

bash
trakt.sh profile [username]    # Show profile
trakt.sh stats [username]      # Detailed statistics

Watching & History:

bash
trakt.sh watching              # Currently watching
trakt.sh history [movies|shows|episodes] [limit]
trakt.sh sync-history export file.json
trakt.sh sync-history import file.json

Scrobbling:

bash
trakt.sh scrobble start movie 12345
trakt.sh scrobble stop movie 12345 100
trakt.sh checkin movie "Inception"

Lists & Collections:

bash
trakt.sh watchlist [movies|shows]
trakt.sh watchlist-add movie "Dune Part Two"
trakt.sh collection movies
trakt.sh collection-add movie 12345
trakt.sh lists                 # Custom lists
trakt.sh list-items my-favorites

Ratings:

bash
trakt.sh ratings movies 8      # Movies rated 8+
trakt.sh rate movie "Inception" 10

Discovery:

bash
trakt.sh recommendations movies
trakt.sh trending shows
trakt.sh popular movies
trakt.sh calendar all 7        # Next 7 days

Search:

bash
trakt.sh search "Breaking Bad" show

Sync:

bash
trakt.sh sync-plex             # Sync Plex watch history to Trakt

Letterboxd Integration (letterboxd.sh):

bash
letterboxd.sh export           # Export from Plex as Letterboxd CSV
letterboxd.sh import diary.csv # Import Letterboxd diary
letterboxd.sh profile username # View public profile
letterboxd.sh diary username 2024

Simkl Integration (simkl.sh):

bash
simkl.sh auth                  # OAuth authentication
simkl.sh profile               # Show profile
simkl.sh stats                 # Viewing statistics
simkl.sh history movies        # Watch history
simkl.sh watchlist all         # View watchlist
simkl.sh sync                  # Sync with Plex
Traktarr & Retraktarr Integration

Automate content discovery and library syncing with Trakt lists.

Traktarr (Trakt → Radarr/Sonarr):

bash
# Status and configuration
trakt.sh traktarr-status       # Check if installed
trakt.sh traktarr-config       # Configure Traktarr

# Add content from Trakt lists
trakt.sh traktarr-add movies trending 10
trakt.sh traktarr-add movies anticipated 15
trakt.sh traktarr-add movies popular 5
trakt.sh traktarr-add shows trending 5
trakt.sh traktarr-add movies watchlist 50

Retraktarr (Radarr/Sonarr → Trakt):

bash
# Status and configuration
trakt.sh retraktarr-status     # Check if installed
trakt.sh retraktarr-config     # Configure Retraktarr

# Sync library to Trakt lists
trakt.sh retraktarr-sync all   # Sync movies and shows
trakt.sh retraktarr-sync movies
trakt.sh retraktarr-sync shows

Installation via Setup Wizard:

bash
trackers.sh setup
# Choose option 5 for Traktarr
# Choose option 6 for Retraktarr
# Offers to install via pip if not found

What They Do:

  • Traktarr: Automatically adds content from Trakt lists (trending, anticipated, watchlist, custom) to Radarr/Sonarr for download
  • Retraktarr: Syncs your Radarr/Sonarr library back to Trakt as public/private lists

See references/traktarr-retraktarr.md for complete setup, cron scheduling, and usage patterns.

Prowlarr Indexer Management (prowlarr.sh)

Centralized indexer management across all *arr apps:

bash
prowlarr.sh indexers              # List all indexers
prowlarr.sh test [id]             # Test indexer(s)
prowlarr.sh stats                 # Indexer & app sync statistics
prowlarr.sh search <query> [type] # Search across all indexers (type: movie|tv|audio|book)
prowlarr.sh apps                  # List sync targets (Sonarr/Radarr/etc)
prowlarr.sh add-app <type> <url> <key>  # Add app sync target
prowlarr.sh sync                  # Trigger sync to all apps
prowlarr.sh status                # Health check
prowlarr.sh logs [count]          # Recent logs
Recyclarr Quality Profiles (recyclarr.sh)

Sync TRaSH Guides quality profiles to Sonarr/Radarr:

bash
recyclarr.sh status               # Check status & config
recyclarr.sh sync [instance]      # Sync profiles (all or specific)
recyclarr.sh diff [instance]      # Preview changes without applying
recyclarr.sh profiles             # List available TRaSH profiles
recyclarr.sh qualities [app]      # List quality definitions
recyclarr.sh config               # Show current config
recyclarr.sh create-config        # Generate config template
recyclarr.sh logs [count]         # View recent logs
Maintainerr Library Cleanup (maintainerr.sh)

Automated library cleanup based on rules:

bash
maintainerr.sh status             # Check status
maintainerr.sh rules              # List cleanup rules
maintainerr.sh collections        # List managed collections
maintainerr.sh run [rule_id]      # Trigger rules (all or specific)
maintainerr.sh media <rule_id>    # Show media matched by a rule
maintainerr.sh exclude <media_id> <rule_id>  # Exclude media from rule
maintainerr.sh logs               # View activity log
Notifiarr Notifications (notifiarr.sh)

Unified notification management across *arr services:

bash
notifiarr.sh status               # Check status & integrations
notifiarr.sh triggers             # List notification triggers
notifiarr.sh services             # Show connected services
notifiarr.sh test [channel]       # Send test notification
notifiarr.sh config               # Configuration summary
notifiarr.sh logs                 # Recent notification log
Kometa Collection Manager (kometa.sh)

Plex collection, overlay, and metadata automation:

bash
kometa.sh status                  # Check container status
kometa.sh run [library]           # Run Kometa (all or specific library)
kometa.sh collections             # Show Plex collections
kometa.sh overlays                # Check overlay config
kometa.sh config                  # Show Kometa config
kometa.sh templates               # List available default collections/overlays
kometa.sh logs [count]            # View recent logs
Unpackerr Archive Extraction (unpackerr.sh)

Automatic archive extraction for download clients:

bash
unpackerr.sh status               # Check status & config
unpackerr.sh activity             # Recent extraction activity
unpackerr.sh errors               # Recent errors/warnings
unpackerr.sh config               # Show configuration
unpackerr.sh logs [count]         # View recent logs
unpackerr.sh restart              # Restart container
Legacy Scripts
  • queue.sh — View download queues (use manage.sh wanted or downloads.sh active for more detail)
  • search.sh — Search content (use manage.sh add-* for full workflow)

Configuration

Environment Variables

Core Services:

bash
export CLAWARR_HOST=192.168.1.100
export SONARR_KEY=abc123...
export RADARR_KEY=def456...
export LIDARR_KEY=ghi789...
export READARR_KEY=jkl012...
export PROWLARR_KEY=mno345...
export BAZARR_KEY=pqr678...
export OVERSEERR_KEY=stu901...
export PLEX_TOKEN=vwx234...
export TAUTULLI_KEY=yz567...
export SABNZBD_KEY=abc890...
export NOTIFIARR_KEY=xyz123...

# Companion services (auto-detected, keys optional)
export PROWLARR_KEY=abc123...   # Required for prowlarr.sh

# Docker-based services (SSH access for remote management)
export RECYCLARR_SSH=mynas       # SSH host for recyclarr container
export KOMETA_SSH=mynas          # SSH host for kometa container
export UNPACKERR_SSH=mynas       # SSH host for unpackerr container
export DOCKER_CONFIG_BASE=/opt/docker  # Docker config root (default: /volume1/docker for Synology)

Media Trackers (optional):

bash
# Trakt.tv (register app at https://trakt.tv/oauth/applications/new)
export TRAKT_CLIENT_ID=your_client_id
export TRAKT_CLIENT_SECRET=your_client_secret

# Simkl (register at https://simkl.com/settings/developer)
export SIMKL_CLIENT_ID=your_client_id
export SIMKL_CLIENT_SECRET=your_client_secret

# Letterboxd (requires API approval)
export LETTERBOXD_API_KEY=your_api_key  # Optional, uses CSV export if not set

Token Storage:

  • Tokens are automatically saved to ~/.config/clawarr/
  • Files: trakt_tokens.json, simkl_tokens.json
  • Permissions: 600 (user read/write only)

Store in .env file and source before running scripts.

Standard Ports
  • Sonarr: 8989
  • Radarr: 7878
  • Lidarr: 8686
  • Readarr: 8787
  • Prowlarr: 9696
  • Bazarr: 6767
  • Overseerr: 5055
  • Plex: 32400
  • Tautulli: 8181
  • SABnzbd: 38080
  • Notifiarr: 5454
  • Maintainerr: 6246
  • FlareSolverr: 8191
  • Homarr: 7575

API Key Discovery

Method 1: /initialize.json (Easiest)

Most *arr apps expose API key at public endpoint:

bash
curl -s http://HOST:7878/initialize.json | jq -r '.apiKey'

For older versions (v3):

bash
curl -s http://HOST:7878/initialize.js | grep -o "apiKey: '[^']*'" | cut -d"'" -f2
Method 2: Config Files

Docker/Unraid/Synology: /config/config.xml (inside container)

bash
grep '<ApiKey>' /path/to/config.xml | sed 's/.*<ApiKey>\(.*\)<\/ApiKey>.*/\1/'
Method 3: Web UI

Settings → General → Security → API Key

Plex Token

From Plex Web UI:

  1. Open any media item
  2. "Get Info" → "View XML"
  3. URL contains X-Plex-Token=...

Or use:

bash
curl -u "username:password" -X POST \
  'https://plex.tv/users/sign_in.json' \
  -H "X-Plex-Client-Identifier: <unique-id>"
Tautulli API Key

Settings → Web Interface → API → API Key

SABnzbd API Key

Config → General → Security → API Key

Common Workflows

Library Analysis
bash
# Get complete library overview
scripts/library.sh stats all

# Find quality upgrade candidates
scripts/library.sh quality radarr

# Show missing content
scripts/library.sh missing all

# Check disk usage
scripts/library.sh disk all
Viewing Analytics
bash
# Current activity
scripts/analytics.sh activity

# Most watched this month
scripts/analytics.sh most-watched month

# User statistics
scripts/analytics.sh user-stats

# Peak hours
scripts/analytics.sh peak-hours
Request Management
bash
# Show pending requests
scripts/requests.sh list pending

# Approve request
scripts/requests.sh approve 123

# Request statistics
scripts/requests.sh stats
Content Management
bash
# Add movie
scripts/manage.sh add-movie "Dune Part Two"

# Show calendar
scripts/manage.sh calendar all 7

# View history
scripts/manage.sh history radarr 30

# Show wanted/missing
scripts/manage.sh wanted all
Indexer Management (Prowlarr)
bash
# List and test all indexers
scripts/prowlarr.sh indexers
scripts/prowlarr.sh test

# Search across all indexers
scripts/prowlarr.sh search "Dune" movie

# Add Sonarr/Radarr as sync targets
scripts/prowlarr.sh add-app sonarr http://host:8989 <sonarr_key>
scripts/prowlarr.sh add-app radarr http://host:7878 <radarr_key>

# Trigger indexer sync to all apps
scripts/prowlarr.sh sync
Quality Profiles (Recyclarr)
bash
# Preview changes
scripts/recyclarr.sh diff

# Sync TRaSH Guides profiles
scripts/recyclarr.sh sync

# Check status
scripts/recyclarr.sh status
Library Cleanup (Maintainerr)
bash
# View rules and matched media
scripts/maintainerr.sh rules
scripts/maintainerr.sh media 1

# Run cleanup
scripts/maintainerr.sh run

# Exclude something from cleanup
scripts/maintainerr.sh exclude 12345 1
Collections & Overlays (Kometa)
bash
# Run collection/overlay generation
scripts/kometa.sh run

# View existing collections
scripts/kometa.sh collections

# See available templates
scripts/kometa.sh templates
Dashboard
bash
# Generate dashboard
scripts/dashboard.sh my-dashboard.html

# Open in browser
open my-dashboard.html
Media Tracking Workflows

Initial Setup:

bash
# Set up Trakt.tv
scripts/trackers.sh setup
# Select option 1 (Trakt.tv)
# Follow device auth flow

# Check status
scripts/trackers.sh status

Sync Plex to Trakt:

bash
# One-time sync of watch history
scripts/trakt.sh sync-plex

# Or use unified interface
scripts/trackers.sh sync plex trakt

Export for Letterboxd:

bash
# Generate Letterboxd-compatible CSV
scripts/letterboxd.sh export

# Upload at letterboxd.com/import/

Cross-Tracker Sync:

bash
# Export from Trakt, convert for Letterboxd
scripts/trackers.sh sync trakt letterboxd

# Compare two services
scripts/trackers.sh compare trakt simkl

Discovery & Recommendations:

bash
# Get personalized recommendations
scripts/trakt.sh recommendations movies

# See what's trending
scripts/trakt.sh trending shows

# Check upcoming releases
scripts/trakt.sh calendar all 7

Track Viewing:

bash
# See what you're currently watching
scripts/trakt.sh watching

# View watch history
scripts/trakt.sh history movies 50

# Rate something you watched
scripts/trakt.sh rate movie "Inception" 10

Automation with Traktarr/Retraktarr:

bash
# Set up Traktarr (Trakt → Arr)
scripts/trackers.sh setup  # Option 5

# Add trending movies to Radarr
scripts/trakt.sh traktarr-add movies trending 10

# Add anticipated shows to Sonarr
scripts/trakt.sh traktarr-add shows anticipated 5

# Set up Retraktarr (Arr → Trakt)
scripts/trackers.sh setup  # Option 6

# Sync library to Trakt lists
scripts/trakt.sh retraktarr-sync all

# Schedule automation (cron):
# Traktarr every 6 hours: 0 */6 * * * traktarr run
# Retraktarr daily at 3am: 0 3 * * * retraktarr sync

Troubleshooting

No Files Eligible for Import

Diagnosis:

bash
scripts/diagnose.sh

Common causes:

  1. Stale Docker mounts — Container restarted but host didn't
  2. Path mapping — Download client and *arr app see different paths
  3. Permissions — *arr app can't read download directory
  4. Category mismatch — Download in wrong category

Solutions:

bash
# Restart containers (fixes stale mounts)
docker restart radarr sonarr

# Check path mappings
# Settings → Download Clients → Remote Path Mappings
Queue Stuck

Check download client:

bash
scripts/downloads.sh active
scripts/downloads.sh speed

*Check arr queues:

bash
scripts/manage.sh wanted all

Check indexers:

bash
scripts/indexers.sh test
scripts/indexers.sh stats
Missing Subtitles
bash
scripts/subtitles.sh wanted
scripts/subtitles.sh search series <id>

Reference Documentation

  • references/api-endpoints.md — Complete API reference for all services
  • references/tracker-apis.md — Media tracker API documentation (Trakt, Simkl, Letterboxd)
  • references/traktarr-retraktarr.md — Complete guide to Traktarr & Retraktarr automation
  • references/companion-services.md — Prowlarr, Recyclarr, FlareSolverr, Unpackerr, Notifiarr, Maintainerr, Kometa reference
  • references/common-issues.md — Troubleshooting guide with solutions
  • references/setup-guide.md — Platform-specific installation
  • references/prompts.md — Suggested natural-language prompts for agents
  • references/dashboard-templates.md — HTML/CSS templates for dashboards
Show full SKILL.md (569 more words)Show less

Example Agent Prompts

See references/prompts.md for complete list. Examples:

Library & Downloads:

  • "Show me what's downloading right now"
  • "What movies were added this week?"
  • "Generate a dashboard of my media library"
  • "What are the most watched shows this month?"
  • "Find all 720p movies that could be upgraded to 4K"
  • "Show missing episodes for all monitored shows"
  • "What's coming out this week?"
  • "Approve all pending Overseerr requests"
  • "How much disk space am I using per library?"
  • "Show my Plex viewing stats for the last 30 days"
  • "What subtitles are missing?"
  • "Test all my indexers"

Media Tracking:

  • "Set up Trakt tracking for my Plex library"
  • "Sync my Plex watch history to Trakt"
  • "What am I currently watching on Trakt?"
  • "Show my Trakt watch history from this month"
  • "Get movie recommendations based on my Trakt ratings"
  • "What's trending on Trakt right now?"
  • "Export my library for Letterboxd"
  • "Compare my Trakt and Simkl watch histories"
  • "Show me upcoming movie releases I'm tracking"
  • "Rate Inception 10/10 on Trakt"
  • "Add Dune Part Two to my Trakt watchlist"
  • "Show my Letterboxd profile stats"
  • "What are my top-rated movies on Trakt?"

Prowlarr & Indexers:

  • "Show all my indexers and test them"
  • "Search across all indexers for Breaking Bad"
  • "Sync Prowlarr indexers to Sonarr and Radarr"
  • "Add Sonarr as a sync target in Prowlarr"

Quality Profiles (Recyclarr):

  • "Sync TRaSH Guides quality profiles"
  • "Preview what Recyclarr would change"
  • "Show available quality profiles for Radarr"
  • "What quality definitions does Sonarr have?"

Library Cleanup (Maintainerr):

  • "Show my library cleanup rules"
  • "What movies are flagged for deletion?"
  • "Run all cleanup rules now"
  • "Exclude this movie from the cleanup rule"

Collections & Overlays (Kometa):

  • "Run Kometa to update collections"
  • "Show all my Plex collections"
  • "What overlay templates are available?"
  • "Add IMDb Top 250 collection to my movie library"

Notifications (Notifiarr):

  • "Check Notifiarr status and integrations"
  • "Send a test notification"
  • "Show recent notifications"

Archive Extraction (Unpackerr):

  • "Check Unpackerr status"
  • "Show recent extraction activity"
  • "Any extraction errors?"

Traktarr/Retraktarr Automation:

  • "Set up Traktarr to auto-add trending movies"
  • "Add the top 10 anticipated movies from Trakt to Radarr"
  • "Configure Traktarr to monitor my Trakt watchlist"
  • "Sync my Radarr library to a public Trakt list"
  • "Show Traktarr status and configuration"
  • "Add trending shows to Sonarr via Traktarr"
  • "Set up automatic syncing between Trakt and my *arr apps"
  • "What's Retraktarr doing? Is it synced?"

Technical Notes

Bash 3.2 Compatibility

All scripts are compatible with macOS bash 3.2:

  • No associative arrays (declare -A)
  • No uppercase parameter expansion (${var^^})
  • Use $(echo "$var" | tr '[:lower:]' '[:upper:]') for case conversion
  • No |& (pipe stderr), use 2>&1 instead
Dependencies
  • curl — HTTP requests
  • jq — JSON parsing
  • bc — Math calculations (for percentages, GB conversions)
  • sed — Text processing

All standard on macOS/Linux.

Security
  • Never log API keys
  • Confirm destructive actions (delete, remove)
  • Rate limiting for bulk operations
  • Use HTTPS for remote access
Performance
  • Scripts cache API responses where possible
  • Dashboard generation pulls data once per run
  • Bulk operations use batch APIs when available

Version Compatibility

Tested with:

  • Sonarr v4.x (API v3)
  • Radarr v5.x (API v3)
  • Lidarr v2.x (API v1)
  • Readarr v0.3.x (API v1)
  • Prowlarr v1.x (API v1)
  • Bazarr v1.4.x
  • Overseerr v1.33.x (API v1)
  • Plex Media Server (all recent versions)
  • Tautulli v2.x (API v2)
  • SABnzbd v4.x
  • Recyclarr v7.x
  • Unpackerr v0.14.x
  • Notifiarr v0.8.x
  • Maintainerr v2.x
  • Kometa v2.x (Plex Meta Manager successor)
  • FlareSolverr v3.x

Contributing

Report issues or suggest features via GitHub. Include:

  • Script name and command run
  • Error output (sanitize API keys!)
  • Service versions
  • Platform (Docker/Unraid/Synology/etc)

License

MIT License - See repository for details.

© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 38 other files (scripts, references, assets) in skills/clawarr-suite of LeoYeAI/openclaw-master-skills.

  • SKILL.md
  • README.md
  • _meta.json
  • assets/icon.svg
  • openclaw.plugin.json
  • references/api-endpoints.md
  • references/common-issues.md
  • references/companion-services.md
  • references/dashboard-templates.md
  • references/prompts.md
  • references/setup-guide.md
  • references/tracker-apis.md
  • references/traktarr-retraktarr.md
  • scripts/analytics.sh
  • scripts/dashboard.sh
  • scripts/diagnose.sh
  • scripts/discover.sh
  • scripts/downloads.sh
  • … and 21 more

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Clawarr Suite next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clawarr Suite compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clawarr Suite this skillLeoYeAI/openclaw-master-skills2.2k—~6.4kAutomated safety check: NotesMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~1.8kAutomated safety check: PassMIT
Edu Chem Videowy51ai/edulab1.4k—~2.1kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0

Similar skills

  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed
  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Media & CreativeAuto-check passed

More from LeoYeAI/openclaw-master-skills

All 1,235 skills in this repo
  • DevOps Pipeline Management

    LeoYeAI/openclaw-master-skills

    Manages pipelines on a DevOps quality and efficiency platform through its OpenAPI: list workspaces and templates, create, update, run and cancel pipelines, and read run records.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check: notes
  • Feishu Document Collaboration

    LeoYeAI/openclaw-master-skills

    Patches OpenClaw's Feishu extension so an edited document triggers an isolated agent session that reads the doc and replies inline, turning it into a live chat space.

    2.2k GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Files Memory System

    LeoYeAI/openclaw-master-skills

    Multi-context memory management system for OpenClaw agents with group-isolated storage, global shared memory, workspace organization, and group-specific skills isolation.

    2.2k GitHub stars~3.8k tokensUpdated 2 mo ago
    Auto-check passed
  • GEO-Claw AI Visibility Agent

    LeoYeAI/openclaw-master-skills

    Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Google Workspace CLI

    LeoYeAI/openclaw-master-skills

    Installs and authenticates the gws CLI, then automates Gmail, Drive, Sheets, Calendar, Docs, Chat and Tasks with ready-made recipes, persona bundles and security audits.

    2.2k GitHub stars~2.6k tokensUpdated 2 mo ago
    Auto-check: notes
  • HealthFit Health Advisors

    LeoYeAI/openclaw-master-skills

    Runs four advisor roles, a fitness coach, nutritionist, data analyst and TCM practitioner, to build a health profile and track workouts, diet and wellness over time.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Clawarr Suite

What does Clawarr Suite do?

Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa…. Clawarr Suite is an agent skill from LeoYeAI/openclaw-master-skills. Comprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr).

When should I use Clawarr Suite?

Clawarr Suite fits situations like: tasks that involve Transcription.

How do I install Clawarr Suite in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill clawarr-suite -a claude-code`. Or copy the skill folder (skills/clawarr-suite in LeoYeAI/openclaw-master-skills) into .claude/skills/clawarr-suite in your project. Claude Code loads it when a task matches its description.

How do I install Clawarr Suite in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill clawarr-suite -a codex`. Or copy the skill folder (skills/clawarr-suite in LeoYeAI/openclaw-master-skills) into .agents/skills/clawarr-suite in your project. Codex loads it when a task matches its description.

Can I use Clawarr Suite in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill clawarr-suite -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clawarr-suite, .gemini/skills/clawarr-suite, .github/skills/clawarr-suite and .opencode/skills/clawarr-suite in your project.

What does Clawarr Suite need to run?

Going by SKILL.md and its folder, Clawarr Suite needs a shell for the scripts in its folder, the command-line tools its instructions call (curl, jq and docker) and credentials named PROWLARR_KEY, SONARR_KEY, RADARR_KEY and LIDARR_KEY. Our summary lists: A Bash shell; Docker.

Does Clawarr Suite access the network?

SKILL.md names 3 domains. In commands or code: trakt.tv, simkl.com and plex.tv; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Clawarr Suite safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Clawarr Suite use?

Clawarr Suite is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clawarr Suite use?

About 6.4k tokens (SKILL.md is roughly 25k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 22k tokens, read only when the agent opens those files.

What are the alternatives to Clawarr Suite?

Skills that share tags, products or a category with Clawarr Suite: HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Edu Chem Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clawarr Suite?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.