Media Library Organizer Skill

Media Library Organizer

A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skill for systematically cleaning, merging, renaming, and verifying media libraries — making them ready for Jellyfin / Emby / Plex auto-scraping.

What It Does

Step	Description
Scan & Analyze	Survey directories, flag junk files, duplicates, misplaced content
Clean Junk	Remove SMB residuals, .DS_Store, download fragments, empty dirs
Identify Duplicates	Find same content across folders by title/year/quality matching
Merge Scattered Episodes	Combine split episodes from different release groups
Normalize Folder Names	Rename to Title (Year) format for media server recognition
Verify vs TMDB	Compare local episode counts against TMDB totals
Report & Confirm	Present findings, wait for user confirmation before deletions

Workflow

Scan & Analyze → Clean Junk → Identify Duplicates → Merge Scattered Episodes
    → Normalize Folder Names → Verify vs TMDB → Report & Confirm

Installation

Quick Install (Recommended)

npx skills add Innei/media-library-organizer-skill

This automatically installs the skill into your Claude Code environment.

Manual Install

Copy the skill into your Claude Code skills directory:

# Global (all projects)
git clone https://github.com/Innei/media-library-organizer-skill.git ~/.claude/skills/media-library-organizer

# Project-specific
git clone https://github.com/Innei/media-library-organizer-skill.git .claude/skills/media-library-organizer

Then invoke it in Claude Code by telling Claude to organize your media library, or use the slash command:

/media-library-organizer

Standalone Scripts

The `scripts/` directory contains standalone bash scripts that can be used independently:

# Scan media directory for issues
./scripts/scan-media.sh /path/to/media

# Check episode completeness
./scripts/