Skill Oido Musical — Productivity skill for Claude Code

skill-oido-musical

Skill de [Claude Code](https://claude.com/claude-code) que le da a Claude **oído para la música** de un vídeo o una pista de audio. Todo en local, sin subir el audio a ningún sitio (salvo un paso opcional con Shazam).

Nació montando promos de vídeo con narración sobre música: Claude podía leer el `.wav`, pero no sabía si la pista era tensa o épica, en qué tono estaba, dónde caían los golpes ni, sobre todo, **si la música pisaba la voz**. Un fichero de audio es una lista de números; esta skill los convierte en las cuatro cosas que un montador sabe al oír la pista una vez.

---

Qué hace

Paso	Script	Pregunta que responde	Motor
1	scripts/separar.py	¿Qué parte es voz y qué parte es música?	Demucs (local)
2	scripts/identificar.py	¿De quién es esta música?	Shazam (única llamada de red, opcional)
3	scripts/perfil.py	Tonalidad, tempo real y sentido, graves, curva de energía, golpes	librosa (local)
4	scripts/mezcla.py	¿La música pisa la voz? Margen en dB y nivel en los huecos	ffmpeg + numpy (local)

Cada script funciona por separado. Sobre un vídeo ajeno: 1 → 3 (y 2 si quieres saber si es comercial). Sobre una mezcla tuya: 4.

Instalación

git clone https://github.com/flopez1977/skill-oido-musical.git ~/.claude/skills/oido-musical
pip install librosa demucs shazamio numpy
brew install ffmpeg        # o apt install ffmpeg

Claude Code carga las skills de `~/.claude/skills/` al arrancar la sesión. La primera vez que corra Demucs descargará el modelo `htdemucs` (~80 MB) a la caché de torch.

Uso

python3 scripts/separar.py promo.mp4 -o separado/          # vocals.wav + no_vocals.wav
python3 scripts/identificar.py separado/no_vocals.wav       # ¿tema conocido? (prueba varios tramos)
python3 scripts/perfil.py separado/no_vocals.wav            # perfil técnico legible (--json para todo)
python3 scripts/mezcla.py --master master.mp4               # ¿l