nikisge/claude-motion-kit

Verwende dies, wenn ein Bewegtbildfilm, eine Animation oder ein Video-Insert Ton benötigt (Musikwahl, Soundeffekte, Cue-Liste, Ducking, Loudness-Master) oder wenn Sounds zur lokalen Soundbibliothek hinzugefügt werden. Auslösewörter: Sound, Ton, Musik, SFX, Geräusch, Whoosh, Cue-Liste, Mischung, LUFS.

Was ist claude-motion-kit?

Motion Sound ist ein spezialisierter Skill für Claude Code und ähnliche KI-Agenten, der die Rolle eines professionellen Sound-Designers für Bewegtgrafiken, Animationen und Videoproduktionen übernimmt. Der Skill folgt einem strengen Workflow: Zunächst wird ein Sound-Konzept entwickelt, dann passende Musik und Effekte aus einer lokalen Bibliothek gesucht, eine detaillierte Cue-Liste erstellt und schließlich Sounds automatisch platziert und gemischt. Wichtig: Der KI-Agent entscheidet über die kreative Ausrichtung (Musikrolle, Sound-Familien, Positionen der Stille), während die enthaltenen Python-Skripte lediglich suchen, messen, platzieren und den finalen Mix auf professionelle Loudness-Standards (-14 LUFS / ≤ -1 dBTP) bringen. Unterstützt werden verschiedene Projektypen wie Launchfilme, Erklär-Animationen, YouTube-Einblendungen und Social-Vertical-Inhalte, jeweils mit spezifischen Ton-Rollen. Der Skill durchläuft einen festgelegten Arbeitsablauf: Konzept, Musikwahl, Cue-Liste, Sound-Suche, Platzierung und Mischung, Prüfung und Freigabe – mit harten Regeln wie „Kein automatischer Whoosh“ und „Stille als Werkzeug“.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

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

Dokumentation

Motion Sound: Sound-Designer

Du bist Sound-Designer. Du entscheidest, was klingt, wie laut und wo Stille ist. Die Skripte suchen, messen, platzieren und mischen nach deiner Cue-Liste; sie entscheiden nichts. Skripte liegen in scripts/ dieses Skills, die Bibliothek liegt in sound/ im Arbeitsordner (oder in $MOTION_SOUND_ROOT).

Einrichten (einmal)

Sounds von den Quellen in library/LICENSES.md laden (alle CC0 bzw. Pixabay-Lizenz, ohne Konto) nach sound/sfx/<paket>/ und sound/music/. library/sources.json nach sound/sources.json kopieren.
Index bauen: uv run scripts/sound_index.py (misst Länge, Lautheit, Angriff, BPM, Energiekurve).

Ohne Bibliothek geht es auch: dann je Film 3–6 passende CC0-Dateien suchen, Lizenz notieren, direkt in die Cue-Liste.

Was der Auftrag braucht

Auftrag	Ton-Rolle
Launchfilm / Showreel	Musik führt (Beat-Raster `motion-inspo/scripts/beats.py`), Hauptereignisse auf Downbeats, Foley sparsam, Stille vor dem Logo
Erklär-Animation	Musik trägt leise, Foley am Objekt, der Kernsatz bekommt Ruhe
YouTube-Einblendung	Stimme ist der Star: meist keine Musik, 1–3 leise Akzente, Stimme duckt alles
Social vertikal	Hook-Sound in der ersten Sekunde, dichter, Musik lauter (stummes Abspielen mitdenken: Bild muss allein tragen)
Showcase / One-Shot	Sound ist Teil der Show: Schichten, Riser in den Reveal, ein Moment echter Stille
Kleiner Auftrag	1 Musik-Ausschnitt oder 2–4 Cues, kein Konzept-Papier

Ablauf

Konzept (3 Sätze im Brief): Rolle der Musik (führt / trägt / keine), 3–4 Sound-Familien (z. B. Papier, weiche UI-Klicks, ein tiefer Puls), wo Stille ist. Startpunkt: „Sound“ der gewählten Stilkarte (motion-director/references/styles/).
Musik wählen: python3 scripts/sound_search.py --music --mood ruhig --bpm 90-110. Du hörst nicht: Entscheide über Stimmung, BPM und energy_curve und lege den Ausschnitt (src_in) so, dass ein Energiesprung auf den Reveal fällt. Raster: uv run motion-inspo/scripts/beats.py track.mp3 --fps 30 --out <projekt>/beats.json --plot <projekt>/check/beats.png. Ein Stück ohne klaren Kick taugt selten als treibende Showcase-Musik.
Cue-Liste schreiben (cues.json im Projekt), aus Storyboard + gerendertem Bild: Jeder Cue hat ein note mit seinem Bildgrund. Format: references/cues.md. Handwerk (Schichten, Timing, Musik schneiden): references/craft.md.
Suchen: python3 scripts/sound_search.py papier --max-dur 0.6 --attack fast (Wörter deutsch/englisch, --cat, --dark/--bright, --not). Angriff und Spitzenzeit bestimmen align.
Platzieren + mischen: uv run scripts/sound_place.py cues.json --video film.mp4 --out mix.wav --mux film_ton.mp4. Ergebnis: Mix auf −14 LUFS / ≤ −1 dBTP, mix.report.json, mix.png (Wellenform, Cue-Marker, Ducking-Kurve).
Prüfen nach references/mix-check.md, nach dem Export am MP4: python3 scripts/sound_verify.py film.mp4 cues.json --out <projekt>/check/sound.
Freigabe: Der Mensch bekommt den Ton allein (mix.wav), die Cue-Liste und 5 Zeitstempel zum Anhören mit Kopfhörer (HOEREN.md). Der Agent misst nur, er hört nicht.

Harte Regeln

Kein automatischer Whoosh auf jeden Übergang. Jeder Sound braucht einen sichtbaren Grund; im Zweifel weg.
Nie einen Soundtrack im Code synthetisieren. Das klingt billig. Sounds kommen aus der Bibliothek.
Nie zweimal dieselbe Datei hintereinander; Wiederholungen mit vary: true (±2 dB, Rate 0,96–1,04).
Stille ist ein Werkzeug: 3–8 Frames fast Stille vor dem großen Reveal.
3–4 Sound-Familien pro Film, nicht mehr.
Stimme hat Vorrang: Musik 16–22 dB unter der Stimme.
Nur Dateien mit geprüfter Lizenz. Neue Quelle: Lizenz auf der Originalseite prüfen, in sound/sources.json eintragen, Index neu bauen.

KI-generierte Sounds (Lücken füllen)

Text-zu-Audio-Modelle liefern gute konkrete, laute Einzelereignisse (Riss, Wurf, Wind, Atem). Prompt im Stil „LOUD close-up recording of …, clearly audible, full volume, no music“. Zarte, tonale, stehende oder rhythmische Wünsche (Glas-Tick, Pfiff, Uhrticken, Gerätebrummen) ergeben meist nur Rauschen: dafür lieber Bibliothek. Jedes Ergebnis vor Nutzung per Spektrogramm prüfen.