# Mp3 Fix Comments > Fix MP3 comment field conflicts by removing iTunes normalization data and stale ID3v1 comment frames while preserving Songs-DB_Custom1. Supports single file and batch directory mode. Always defaults to dry-run for safety. Use when this capability is needed. - Skill: `tomevault-io/mp3-fix-comments` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/mp3-fix-comments` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mp3-fix-comments/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/mp3-fix-comments --- Fix comment field conflicts in MP3 files. This removes problematic COMM frames (ID3v1 Comment, empty-description XXX) while preserving Songs-DB_Custom1 fields used by MediaMonkey. ## Argument Handling The arguments map directly to the Python script: | Example | Behavior | |---------|----------| | `song.mp3` | Dry-run on a single file (shows what would change) | | `song.mp3 --apply` | Apply changes to a single file | | `--batch /music/dir` | Dry-run on all MP3s recursively in directory | | `--batch /music/dir --apply` | Apply changes to all MP3s in directory | ## Execution Run the following command with the user-provided arguments: ``` python /workspaces/mako-sync/python/fix_comments.py $ARGUMENTS ``` ## Instructions - **Default is always dry-run.** If the user did not pass `--apply`, emphasize that no changes were made and show what would happen. - When `--apply` is used, confirm that changes were applied and summarize what was removed vs preserved. - For batch mode, report the total number of files scanned and how many needed fixing. - After a dry-run, prompt the user: "Run again with `--apply` to make these changes." - After applying fixes, suggest running `/mp3-diagnose` on the file to verify the result. - Warn clearly if batch mode with `--apply` will modify many files. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/gwherrett) — claim your Tome and manage your conversions.