Manage Usenet downloads with SABnzbd. Use when the user asks to "check SABnzbd", "list NZB queue", "add NZB", "pause downloads", "resume downloads", "SABnzbd status", "Usenet queue", "NZB history", or mentions SABnzbd/sab download management.
From homelab-corenpx claudepluginhub jmagar/claude-homelab --plugin homelab-coreThis skill uses the workspace's default tool permissions.
README.mdload-env.shreferences/api-endpoints.mdreferences/quick-reference.mdreferences/troubleshooting.mdscripts/sab-api.shGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Configures VPN and dedicated connections like Direct Connect, ExpressRoute, Interconnect for secure on-premises to AWS, Azure, GCP, OCI hybrid networking.
⚠️ MANDATORY SKILL INVOCATION ⚠️
YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:
Failure to invoke this skill when triggers occur violates your operational requirements.
Manage Usenet downloads via SABnzbd's REST API.
This skill provides read and write access to your SABnzbd Usenet downloader:
Operations include both read and write actions. Always confirm before deleting downloads with file deletion.
Credentials: ~/.claude-homelab/.env
SABNZBD_URL="http://localhost:8080"
SABNZBD_API_KEY="your-api-key-from-config-general"
Get your API key from SABnzbd Config → General → Security.
Security: Never commit .env file. Set permissions: chmod 600 ~/.claude-homelab/.env
# Full queue
./scripts/sab-api.sh queue
# With filters
./scripts/sab-api.sh queue --limit 10 --category tv
# Specific job
./scripts/sab-api.sh queue --nzo-id SABnzbd_nzo_xxxxx
# By URL (indexer link)
./scripts/sab-api.sh add "https://indexer.com/get.php?guid=..."
# With options
./scripts/sab-api.sh add "URL" --name "My Download" --category movies --priority high
# By local file
./scripts/sab-api.sh add-file /path/to/file.nzb --category tv
Priority: force, high, normal, low, paused, duplicate
./scripts/sab-api.sh pause # Pause all
./scripts/sab-api.sh resume # Resume all
./scripts/sab-api.sh pause-job <nzo_id>
./scripts/sab-api.sh resume-job <nzo_id>
./scripts/sab-api.sh delete <nzo_id> # Keep files
./scripts/sab-api.sh delete <nzo_id> --files # Delete files too
./scripts/sab-api.sh purge # Clear queue
./scripts/sab-api.sh speedlimit 50 # 50% of max
./scripts/sab-api.sh speedlimit 5M # 5 MB/s
./scripts/sab-api.sh speedlimit 0 # Unlimited
./scripts/sab-api.sh history
./scripts/sab-api.sh history --limit 20 --failed
./scripts/sab-api.sh retry <nzo_id> # Retry failed
./scripts/sab-api.sh retry-all # Retry all failed
./scripts/sab-api.sh delete-history <nzo_id>
./scripts/sab-api.sh categories
./scripts/sab-api.sh scripts
./scripts/sab-api.sh change-category <nzo_id> movies
./scripts/sab-api.sh change-script <nzo_id> notify.py
./scripts/sab-api.sh status # Full status
./scripts/sab-api.sh version
./scripts/sab-api.sh warnings
./scripts/sab-api.sh server-stats # Download stats
Queue slot includes:
nzo_id, filename, statusmb, mbleft, percentagetimeleft, priority, catscript, labelsStatus values: Downloading, Queued, Paused, Propagating, Fetching
History status: Completed, Failed, Queued, Verifying, Repairing, Extracting
When the user asks about Usenet downloads:
queue to show active downloadsadd "<url>" with appropriate category and prioritypauseresumehistoryretry-all or retry <nzo_id>speedlimit <percentage> or speedlimit <MB>MCRITICAL: When invoking scripts from this skill via the zsh-tool, ALWAYS use pty: true.
Without PTY mode, command output will not be visible even though commands execute successfully.
Correct invocation pattern:
<invoke name="mcp__plugin_zsh-tool_zsh-tool__zsh">
<parameter name="command">./skills/SKILL_NAME/scripts/SCRIPT.sh [args]</parameter>
<parameter name="pty">true</parameter>
</invoke>