AgentSkillsCN

mp3-diagnose

诊断 MediaMonkey 与 Serato 之间 MP3 注释字段的冲突。当用户希望检查 MP3 文件的 ID3 注释标签，以了解为何不同应用显示的注释值存在差异时使用。

SKILL.md
--- frontmatter
name: mp3-diagnose
description: Diagnose MP3 comment field conflicts between MediaMonkey and Serato. Use when the user wants to inspect ID3 comment tags on an MP3 file to understand why apps show different comment values.
argument-hint: <path-to-mp3>
allowed-tools: Bash, Read

Diagnose comment field conflicts in an MP3 file by running the diagnosis script.

Execution

Run the following command with the user-provided file path:

code
python /workspaces/mako-sync/python/diagnose_comments.py $ARGUMENTS

Instructions

  • •Present the diagnosis results clearly, grouping COMM frames and TXXX frames separately
  • •Explain what each COMM frame means: description, language, and which app typically uses it
  • •Highlight any conflicts — e.g., multiple COMM frames that different apps (MediaMonkey, Serato) would read differently
  • •If problematic fields are found (ID3v1 Comment, empty-description XXX frames, iTunes normalization data), suggest using /mp3-fix-comments to resolve them
  • •If the file looks clean, confirm that no conflicts exist