Install
$ agentstack add skill-innei-media-library-organizer-skill-media-library-organizer-skill ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Media Library Organizer
Overview
Systematically clean, merge, rename, and verify media libraries so that Jellyfin/Emby/Plex can correctly identify and scrape all content.
When to Use
- Media directory has messy folder names with encoding info
- Same show scattered across multiple folders
- Junk files wasting space
- Need to verify episode completeness against TMDB
Workflow
digraph media_org {
rankdir=TB;
"1. Scan & Analyze" -> "2. Clean Junk";
"2. Clean Junk" -> "3. Identify Duplicates";
"3. Identify Duplicates" -> "4. Merge Scattered Episodes";
"4. Merge Scattered Episodes" -> "5. Normalize Folder Names";
"5. Normalize Folder Names" -> "6. Verify vs TMDB";
"6. Verify vs TMDB" -> "7. Report & Confirm Deletion";
}
Steps
Each step has detailed instructions and reusable scripts:
- [Scan & Analyze](docs/scan-and-analyze.md) - Survey directory, identify issues, generate report
- Script:
scripts/scan-media.sh
- [Clean Junk](docs/clean-junk.md) - Remove temp files, empty dirs, orphan fragments
- [Identify Duplicates](docs/identify-duplicates.md) - Find same content across folders by title/year matching
- [Merge Scattered Episodes](docs/merge-scattered-episodes.md) - Combine split episodes into one folder
- Script:
scripts/check-episodes.sh
- [Normalize Folder Names](docs/normalize-folder-names.md) - Rename to
Title (Year)format
- Script:
scripts/normalize-names.sh
- [Verify vs TMDB](docs/verify-against-tmdb.md) - Compare local episode count against TMDB
- [Report & Confirm](docs/report-and-confirm.md) - Present findings, wait for user confirmation
Common Mistakes
| Mistake | Fix | |---------|-----| | Renaming folders breaks PT/BT seeding | Confirm with user if they're still seeding | | Gap detection only checks internal gaps | Must compare against TMDB total count | | macOS grep lacks -P flag | Use egrep -o instead of grep -oP | | sed with multi-line input fails on macOS | Use awk for complex text processing | | Merging without checking overlaps | Always verify no episode overlap before merge | | Guessing Chinese titles from English | Search TMDB/MyDramaList for authoritative names | | Movie in TV folder or vice versa | Check if content is film or series before placing |
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: Innei
- Source: Innei/media-library-organizer-skill
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.