| name | manage-metadata |
| description | Inspect and update MP3 tags: genre, artist, album, track count, compilation flag. Use when checking or fixing music file metadata — including diagnostic questions like "why do these show up as separate tracks" or "is this folder's metadata consistent," not just explicit tag-editing requests. |
| allowed-tools | Bash Read |
| metadata | {"author":"eyelock","version":"0.2.0"} |
Setup
- Check environment variables: MEDIA_MGMT_DOWNLOADS, MEDIA_MGMT_LIBRARY_STORAGE
- If unset, use default paths from CLAUDE.md
- If CLAUDE.md has no paths, read config.json from $MEDIA_MGMT_CONFIG_PATH (defaults to ~/.config/media-management/config.json)
Scripts are in scripts/ relative to this skill directory.
Modes
Parse $ARGUMENTS to determine mode and parameters:
- inspect (or no mode specified): Read-only metadata inspection
- update: Inspect first, then update based on user choices
Argument format
inspect <folder>
update <folder> [genre=<genre>] [clear-album-artist | set-album-artist=<name>] [set-compilation] [update-track-count]
When update arguments include pre-confirmed values (e.g. genre=Electronic), apply them
directly — do not re-ask the user for values already specified in the arguments.
Inspect Mode
Step 1: Run inspection
bash scripts/inspect-metadata.sh "$FOLDER"
Step 2: Present results
Display metadata as a readable table:
| # | File | Title | Artist | Album | Genre | Track | Album Artist |
|---|
Step 3: Flag issues
Check for:
- Missing titles
- Missing or empty genre
- Inconsistent artist names across tracks
- Missing track numbers or wrong totals
- Album Artist set when it shouldn't be (single artist)
- Compilation flag inconsistencies
Update Mode
Step 1: Inspect first
Always run inspect before updating. Present findings.
Step 2: Ask what to update
Present the issues found and ask user to confirm what to fix. Never auto-apply changes.
Step 3: Extract genres (if needed)
If genre needs setting:
bash scripts/extract-apple-music-genres.sh
Present the genre list as numbered options. Ask user to select or type a custom genre.
Step 4: Apply updates
Run the appropriate scripts based on user's choices:
Track count:
bash scripts/update-track-count.sh "$FOLDER"
Genre:
bash scripts/update-genre.sh "$FOLDER" "$GENRE"
Album Artist (clear for single artist):
bash scripts/clear-album-artist.sh "$FOLDER"
Album Artist (set for collaboration):
bash scripts/set-album-artist.sh "$FOLDER" "$ARTIST"
Compilation:
bash scripts/set-compilation.sh "$FOLDER" true
Step 5: Verify
Run inspect again to confirm changes took effect:
bash scripts/inspect-metadata.sh "$FOLDER"
Present the updated table and confirm everything looks correct.
