media-library-organizer-skill
A Claude Code skill (plus standalone bash scripts) that scans a local media library to clean obvious junk, detect/resolve duplicates, merge scattered TV episodes, normalize folder naming to a server-friendly format, and verify episode completeness against TMDB—reporting findings and confirming before destructive changes.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
The tool is local shell-based and claims a safety posture (confirm before deletions; dry-run for name normalization; only auto-removes certain 'safe junk' like SMB residuals/.DS_Store). However, the README does not document TMDB authentication mechanism, secret handling (how tokens/keys are provided), network/TLS usage, or detailed error handling. No dependency/security scanning info is provided in the supplied text.
⚡ Reliability
Best When
You have a local movie/TV folder hierarchy and want an assisted, confirmation-based cleanup/normalization flow to improve auto-scraping reliability.
Avoid When
You require no filesystem writes at all, or you cannot provide TMDB connectivity/credentials (if required by the implementation).
Use Cases
- • Cleaning NAS media libraries (removing SMB artifacts, .DS_Store, empty dirs, download fragments)
- • Normalizing movie/TV folder names for Jellyfin/Emby/Plex scraping
- • Merging split/fragmented TV episodes across release groups
- • Detecting duplicates across folders by title/year/quality heuristics
- • Checking TV episode completeness against TMDB totals
Not For
- • Fully automated deletion workflows without human confirmation
- • Environments where shell-script execution is prohibited
- • Libraries without TMDB access or where TMDB verification is undesired
- • Highly customized media server naming schemes that diverge from Title (Year)
Interface
Authentication
The README indicates TMDB access for verification but does not document an auth method, tokens, or scopes. Claude Code usage likely runs locally without dedicated auth from the skill itself.
Pricing
License is MIT, but no pricing model is described (it appears to be self-hosted/local tooling).
Agent Metadata
Known Gotchas
- ⚠ Renaming can break active PT/BT seeding; confirm with user before renaming if seeding is ongoing
- ⚠ Gap detection should rely on TMDB total counts to avoid truncation/tail-missing issues
- ⚠ Use of grep -P may fail on macOS; README suggests using egrep -o
- ⚠ Merging without checking overlaps can create duplicate/overlapping episode ranges
- ⚠ Guessing Chinese titles from English can be wrong; README recommends TMDB for authoritative names
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for media-library-organizer-skill.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.