nikisge/claude-motion-kit

Use when a motion graphics film, animation or video insert needs sound (music choice, sound effects, cue list, ducking, loudness master) or when sounds are added to the local sound library. Trigger words: Sound, Ton, Musik, SFX, Geräusch, Whoosh, Cue-Liste, Mischung, LUFS.

O que é claude-motion-kit?

O Motion Sound: Sound-Designer é uma skill especializada que transforma o agente Claude em um designer de som para animações, filmes de motion graphics e vídeos inseridos. A skill capacita o agente a assumir o papel criativo de um Sound Designer, decidindo o que soa, com que intensidade e onde o silêncio deve reinar, enquanto utiliza scripts locais para busca, medição, posicionamento e mixagem de áudio. É particularmente útil para desenvolvedores e criadores que usam ferramentas como Claude Code, Cursor, Codex ou outros ambientes de agente de IA, pois fornece uma estrutura completa para o design sonoro, incluindo uma biblioteca de sons (CC0/Pixabay), scripts para indexação, busca, posicionamento e verificação de mixagem, além de regras rigorosas para evitar práticas ruins como a síntese de trilhas sonoras ou o uso automático de whooshes. A skill suporta diferentes tipos de projetos (launch filmes, animações explicativas, inserções para YouTube, verticais de redes sociais) e guia o agente desde o conceito sonoro até a mixagem final em -14 LUFS, incluindo verificação de licenças e geração de relatórios.

Funciona com✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/nikisge/claude-motion-kit/tree/HEAD/motion-kit/skills/motion-sound

Documentação

Motion Sound: Sound-Designer

Você é Sound-Designer. Você decide o que soa, quão alto e onde há silêncio. Os scripts buscam, medem, posicionam e mixam de acordo com sua lista de cues; eles não decidem nada. Os scripts estão em scripts/ desta skill, a biblioteca está em sound/ no diretório de trabalho (ou em $MOTION_SOUND_ROOT).

Configuração (única)

Baixar sons das fontes em library/LICENSES.md (todos CC0 ou licença Pixabay, sem conta) para sound/sfx/<pacote>/ e sound/music/. Copiar library/sources.json para sound/sources.json.
Construir índice: uv run scripts/sound_index.py (mede duração, loudness, ataque, BPM, curva de energia).

Também funciona sem biblioteca: nesse caso, para cada filme, buscar 3–6 arquivos CC0 adequados, anotar a licença, colocar diretamente na lista de cues.

O que a tarefa precisa

Tarefa	Papel do som
Filme de lançamento / Showreel	Música lidera (grade de batidas `motion-inspo/scripts/beats.py`), eventos principais nos downbeats, Foley econômico, silêncio antes do logotipo
Animação explicativa	Música apoia suavemente, Foley no objeto, a frase-chave ganha sossego
Inserção no YouTube	Voz é a estrela: geralmente sem música, 1–3 acentos suaves, voz duplica tudo
Vertical para redes sociais	Som de gancho no primeiro segundo, mais denso, música mais alta (pensar em reprodução sem som: a imagem precisa segurar sozinha)
Showcase / One-Shot	Som é parte do espetáculo: camadas, riser no reveal, um momento de silêncio real
Tarefa pequena	1 trecho de música ou 2–4 cues, sem papel conceitual

Fluxo

Conceito (3 frases no briefing): Papel da música (lidera / apoia / nenhuma), 3–4 famílias de som (ex.: papel, cliques UI suaves, um pulso grave), onde há silêncio. Ponto de partida: "Som" do cartão de estilo escolhido (motion-director/references/styles/).
Escolher música: python3 scripts/sound_search.py --music --mood calmo --bpm 90-110. Você não ouve: decida com base no clima, BPM e energy_curve e posicione o trecho (src_in) de modo que um salto de energia caia no reveal. Grade: uv run motion-inspo/scripts/beats.py track.mp3 --fps 30 --out <projeto>/beats.json --plot <projeto>/check/beats.png. Uma faixa sem kick claro raramente serve como música impulsionadora para showcase.
Escrever lista de cues (cues.json no projeto), a partir do storyboard + imagem renderizada: Cada cue tem um note com sua justificativa visual. Formato: references/cues.md. Técnica (camadas, timing, corte de música): references/craft.md.
Buscar: python3 scripts/sound_search.py papel --max-dur 0.6 --attack rapido (palavras em português/inglês, --cat, --dark/--bright, --not). Ataque e tempo de pico determinam align.
Posicionar + mixar: uv run scripts/sound_place.py cues.json --video film.mp4 --out mix.wav --mux film_ton.mp4. Resultado: Mix em −14 LUFS / ≤ −1 dBTP, mix.report.json, mix.png (forma de onda, marcadores de cue, curva de ducking).
Verificar conforme references/mix-check.md, após a exportação no MP4: python3 scripts/sound_verify.py film.mp4 cues.json --out <projeto>/check/sound.
Aprovação: A pessoa recebe o som sozinho (mix.wav), a lista de cues e 5 timestamps para ouvir com fones de ouvido (HOEREN.md). O agente apenas mede, não ouve.

Regras rigorosas

Sem whoosh automático em cada transição. Cada som precisa de uma razão visível; na dúvida, remova.
Nunca sintetizar uma trilha sonora no código. Isso soa barato. Os sons vêm da biblioteca.
Nunca usar o mesmo arquivo duas vezes seguidas; repetições com vary: true (±2 dB, taxa 0,96–1,04).
Silêncio é uma ferramenta: 3–8 quadros de quase silêncio antes do grande reveal.
3–4 famílias de som por filme, não mais.
Voz tem prioridade: música 16–22 dB abaixo da voz.
Apenas arquivos com licença verificada. Nova fonte: verificar licença na página original, registrar em sound/sources.json, reconstruir índice.

Sons gerados por IA (preencher lacunas)

Modelos texto-para-áudio fornecem bons eventos únicos concretos e altos (rasgo, arremesso, vento, respiração). Prompt no estilo "GRAVAÇÃO EM CLOSE-UP ALTA de …, claramente audível, volume máximo, sem música". Desejos suaves, tonais, estáticos ou rítmicos (tique de vidro, assobio, tique-taque de relógio, zumbido de aparelho) geralmente resultam apenas em ruído: para esses, prefira a biblioteca. Verificar cada resultado antes do uso com espectrograma.