media-library-organizer

Organize media libraries by cleaning junk, merging episodes, renaming folders, and verifying against TMDB.

36|3|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/Innei/media-library-organizer-skill --skill media-library-organizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: media-library-organizer
Source: https://github.com/Innei/media-library-organizer-skill/tree/main
Command: npx skills add https://github.com/Innei/media-library-organizer-skill --skill media-library-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Organizes a messy media library by cleaning junk, merging scattered episodes, renaming folders, and verifying completeness against TMDB.

Core Features & Use Cases

  • Scan & Analyze: survey directories and flag junk, duplicates, and misplacements.
  • Clean Junk: remove SMB residuals, .DS_Store, and empty dirs.
  • Identify Duplicates: find same content across folders by title/year/quality.
  • Merge Scattered Episodes: consolidate split episodes from different release groups.
  • Normalize Folder Names: rename to Title (Year) format for media servers.
  • Verify vs TMDB: compare local episode counts against TMDB totals.
  • Report & Confirm: present findings and require user confirmation before deletions.

Quick Start

Run the skill to scan a media directory and apply cleaning, merging, renaming, and TMDB verification with a single command.

Frequently Asked Questions about media-library-organizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize a messy media library with inconsistent folder structures and duplicates?

To organize a messy media library, you can scan directories to flag junk, identify duplicates, merge scattered episodes, and normalize folder names to the Title (Year) format. The process safely analyzes and transforms collections without auto-deleting content.

How do I verify local media library completeness against TMDB episode counts?

You can verify media library completeness against TMDB by comparing local episode counts with TMDB totals. This verification identifies missing episodes in your local NAS or desktop collections containing movies, TV, and anime.

Can I use Bash scripts to clean junk files and merge scattered episodes on a local NAS?

Yes, you can use Bash scripts to clean junk files like SMB residuals and .DS_Store, merge scattered episodes from different release groups, and remove empty directories on a local NAS or desktop media collection.

Does media library renaming require user confirmation before deleting duplicate content?

Media library renaming and cleaning requires user confirmation before any deletions occur. The process presents findings through reports and requires explicit approval to safely transform directories without losing content.

What is the best way to normalize folder names for media servers when managing local collections?

The best way to normalize folder names for media servers is to rename directories to the Title (Year) format. This standardization enables flawless scraping and proper metadata recognition for movies, TV shows, and anime.