Menu
Add or remove movies/shows from a named Plex collection — search library by title, resolve ratingKey, PUT into collection by name
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Find a good torrent for a specific movie and add it to Radarr — search releases, evaluate seeds/quality, confirm with user, grab
Find a good torrent for a specific TV series/season and add it to Sonarr — search Prowlarr, evaluate seeds/quality, confirm with user, enable monitoring, grab
Debug why Sonarr/Radarr can't find sources — check indexer backoffs, search results, Prowlarr health
Upload a Coder template via API — pack tar, upload file, create version with variable overrides, publish or create workspace
Debug a failing Coder workspace build — check HelmRelease, pod state, and build logs via API
Add a new Helm-based application to prod-gen2 (or non-prod-gen2) via Flux — namespace, HelmRepository, HelmRelease, HTTPRoute, kustomization overlay
| name | plex-collection |
| description | Add or remove movies/shows from a named Plex collection — search library by title, resolve ratingKey, PUT into collection by name |
User wants to manage a Plex collection (add/remove items, rename, create). Get collection name and movie/show titles from user. Confirm before removing items.
source /workspaces/home-kubernetes/.env
PLEX_BASE=https://192.168.4.124:32400
MACHINE_ID=48c52a8de213a6b0f3612495444d29c912aceb26
# PLEX_TOKEN is set by sourcing .env
Note: Plex uses self-signed cert — always pass -sk to curl.
| ID | Type | Title |
|---|---|---|
| 1 | movie | Movies |
| 2 | show | TV Shows |
curl -sk -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/sections/1/collections" | \
grep -oP 'ratingKey="\K[^"]+|title="\K[^"]+' | paste - -
Use section 2 for TV collections. The ratingKey is the collection ID needed for all subsequent calls.
curl -sk -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/sections/1/all?title=<Title>&type=1" | \
grep -oP 'ratingKey="\K[^"]+|title="\K[^"]+' | paste - -
Use type=1 for movies, type=4 for shows. Title search is case-insensitive substring match — verify the returned title matches what the user asked for before proceeding (multiple results may appear).
curl -sk -X PUT -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/collections/<COLLECTION_RATINGKEY>/items?uri=server://$MACHINE_ID/com.plexapp.plugins.library/library/metadata/<ITEM_RATINGKEY>" \
-w "%{http_code}\n" -o /dev/null
200 = success. Repeat per item — bulk URI format does not work.
curl -sk -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/collections/<COLLECTION_RATINGKEY>/children" | \
grep -oP 'title="\K[^"]+'
Confirm with user before removing.
curl -sk -X DELETE -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/collections/<COLLECTION_RATINGKEY>/items/<ITEM_RATINGKEY>" \
-w "%{http_code}\n" -o /dev/null
curl -sk -X PUT -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/collections/<COLLECTION_RATINGKEY>?title=<New+Title>&titleSort=<New+Title>" \
-w "%{http_code}\n" -o /dev/null
Add first item with a collection[0].tag param to auto-create:
curl -sk -X POST -H "X-Plex-Token: $PLEX_TOKEN" \
"$PLEX_BASE/library/sections/1/all?type=1&id=<ITEM_RATINGKEY>&collection[0].tag.tag=<Collection+Name>" \
-w "%{http_code}\n" -o /dev/null
Then add remaining items via Step 3.
| Symptom | Cause | Fix |
|---|---|---|
| 400 Bad Request on search | Wrong endpoint — /search not valid | Use /all?title=<query>&type=1 |
| 404 on bulk PUT | Comma-separated IDs in URI not supported | Add items one at a time |
| Multiple results returned | Title is substring match | Check year field or pick exact match |
| Self-signed cert error | Plex uses self-signed TLS | Always use curl -sk |