DyneStein/motionkit

Was macht motionkit?

Kit-Root: Der Ordner, in dem dieses Skill liegt, eine Ebene höher (nennen wir ihn $KIT; wenn das Skill symbolisch verlinkt wurde, löse den Link auf – z. B. ~/.claude/skills/motionkit → <clone>/skill, also $KIT = <clone>). Er wurde aus 60 kuratierten Referenzvideos destilliert; befolge ihn statt generischer Bewegungsvorgaben.

Unverhandelbare Grundsätze (stehende Präferenzen des Nutzers)

1. Keine plötzlichen Schnitte. Jeder Szenenwechsel wird durch ein Element auf beiden Seiten der Naht getragen ($KIT/grammar/01-continuity.md). Maximal ⅓ der Nähte dürfen harte Schnitte sein, und nur auf einem starken Beat.
2. Flüssig, geschmeidig, abgerundet. Lange Ausklänge, Quetschen/Dehnen bei Berührung, Materialwechsel vor der Form, Unschärfe als Kleber (02-motion-easing.md).
3. Keine Musik generieren oder synthetisieren. Verwende den Track des Nutzers. Wenn keiner angegeben ist, frage danach. Das Kit enthält keine Musik.
4. Kamera durch den Inhalt bestimmt (Runden 3–4): Plane eine abwechslungsreiche Route (nie zweimal hintereinander dieselbe Richtung: Trucks L/R, Schwenks hoch/runter, Diagonalen, Schübe, Züge, Halten) und wechsle Kamerabeats mit Elementbeats ab, bei denen polierte Elemente unter einer stillen Kamera interagieren; synchronisiere Ereignisse mit der Musik (sync_check.py Anstieg ≥ ×1,35; beatSync() für Ambient-Tracks, Beat-Raster für rhythmische). Textgetriebene Filme → gleitende Verfolgungskamera (Spline e:"glide" durch Wortziele, Glocken-Easing zwischen Regionen – nie wortweise Hops); elementgetriebene Filme → nahezu verriegelte Kamera mit nur motivierten, gesäten Bewegungen (camSeed, seed) – nie Bewegung um der Bewegung willen, nie ein wiederholtes Muster. Frühere Regel, immer noch gültig für Textfilme: (Runde 2: "es ist nur die Perspektive, die Kamera bewegt sich nicht"): Verfolgungskamera auf das aktive Wort/den Protagonisten durch eine Welt, die größer als der Bildausschnitt ist, Trägerreise zwischen Stationen für Ein-Objekt-Geschichten, Parallax-Referenzebene immer ($KIT/grammar/08-camera.md § v3, $KIT/research/camera-notes.md, Primitives §19–20). Auch: (der Nutzer nannte dessen Fehlen einen "MAJOR MAJOR MAJOR FLAW"): Baue jeden Film als 3D-Welt, die durch camera-rig.js gesehen wird; Kamera bewegt sich ≥ 65 % der Frames (Referenzen: Median 77 %, gemessen mit research/camera_motion.py); Untertitel reiten die Welt, Verweiler reisen weiter, Verweil-und-Schwenk-Rhythmus, ≥ 3 Tiefenebenen mit Parallaxe, Tiefenschärfe, Handkamera-Drift, Bewegungsunschärfe bei Schwenks ($KIT/grammar/08-camera.md).
5. Polier-Standard ($KIT/grammar/09-polish-bar.md): Enge Glüheffekte nur (keine Halos, niemals ein glühendes Element skalieren, keine großen SVG-Unschärfefilter – Farbverläufe + Körnung); Container-Morphs sind SVG-Geometrie, sodass Ecken in jedem Frame rund bleiben (keine Clip-Pfad-Enthüllungen); texttragende UI kommt aus der Tiefe/weichem Fokus – keine Skalierungs-Pops, keine geneigten Aufkleber-Layouts; jedes flache Objekt erhält Schatten + Rand + Kontaktschatten.
6. Professionelle Elemente und Schriftarten: Baue UI/3D-Teile aus $KIT/elements/ (siehe elements/showcase/ und research/element-notes.md); Typografie aus $KIT/fonts/FONTS.md – niemals generische Vorgaben.
7. Professioneller Feinschliff: Ein Akzent pro Zeile, kursiv-Serifen oder Gewichtssprung-Betonung, jeder Frame hat ≤ 3 Fokuselemente, eine durchgehende Konstante (Leinwand, Titel, Horizont oder Nebel) über den gesamten Film.
8. Reels zuerst, sofern nicht anders angegeben: 1080×1920, Text im Bereich 168–1330 px, ≤ 5 Wörter pro Zeile, nichts unter 28 px, Frame 0 ist der Haken (nie schwarz, nie ein Logo).
9. Sei Token-effizient: Eine Szenendatei pro Kapitel (oder eine für einen gesamten durchgehenden Morph), nimm nur Zustandsänderungen im Snapshot auf.

Arbeitsablauf

1. Briefing (kurz). Thema/Marke, Botschaft, Format, Länge, die Musikdatei. Frage nur nach dem, was fehlt; eine Runde.
2. Wähle einen Stil aus $KIT/styles/STYLES.md (die Tabelle am Ende ordnet Briefings → Stile zu). Lies die Karte vollständig; öffne 1–2 ihrer Referenznotizen in $KIT/research/video-notes/ für Details.
3. Analysiere die Musik: npx hyperframes audio <track> --only kind,bpm,beats,downbeats,sections,onsets --json. Rhythmisch → Beat-Raster (beat(n), bar(k), Primitives §1). Ambient → Kapitel an Abschnittsgrenzen, Heldenereignisse auf den stärksten Einsätzen (--threshold 0.3).
4. Plane in einer Tabelle: Kapitel × (Zeitfenster, Träger ins nächste, Objektzustand, Bildunterschrift, Kamerabewegung). Benenne den Träger und die Kamerabewegung für jede Naht; wenn du es nicht kannst, gestalte die Naht neu. Lege die Kapitel als Orte in einer 3D-Welt aus.
5. Baue mit HyperFrames (lade zuerst /hyperframes für den Vertrag). Beginne mit dem nächstgelegenen Beispiel (v2 = mit Kamera): $KIT/samples/a-ember-lumen (S1), b-morph-nook (S2), c-neon-aura (S3), d-saas-tally (S4) – cp -R in das neue Projekt, dann überschreibe. Verwende Blöcke aus $KIT/primitives/PRIMITIVES.md. Setze Palette + Schriftarten in data-composition-variables im Stammverzeichnis.
6. Überprüfe: npx hyperframes check --json 2>/dev/null (stderr ist laut) → korrigiere Fehler, bewerte Warnungen → npx hyperframes snapshot --at <jeder Zustandsänderung + mittendrin> -o .snap/x → lies das Kontaktblatt → korrigiere (zoome in Ecken und Glüheffekte: snapshot --zoom). Gehe durch 07-engineering-pitfalls.md und die Checkliste 09-polish-bar.md. Nach dem Rendern misst du die Kamerabewegung: python3 $KIT/research/camera_motion.py <dir-with-mp4> out.json – Ziel moving_frac ≥ 0,65 (unteres Quartil der Referenzen; Median 0,77).
7. Rendern: npx hyperframes render -o <out>.mp4. Öffne die Studio-Vorschau vor einem Auslieferungs-Rendering, wenn der Nutzer es überprüft.

Kurzreferenzen

• Träger (wähle 3–5 pro Film): Element-wird-Welt · Zoom-durch · Form-Morph · Führungsobjekt · eine Karte viele Zustände · Iris · Farbflut · Unschärfe-Peitsche · kontinuierliche Weltkamera · verankertes Wort · Form-Reim · mitnehmen · Partikel-Auflösung · Medium-Wisch.
• Easing-Palette: Ankunft expo.out/power4.out 0,5–0,9 s · Austritt power3.in (40–50 % der Eingangsdauer) · Kamera/Morph power2.inOut · Premium-Feder back.out(1.4) · linear nur für Orbit/Rotation/Fortschritt.
• Typografie: Wortweises Einblenden durch Unschärfe (kein Verschieben) · grau→tinte Vorlese-Effekt · Spielautomat-Wort · Highlight-Pille-Keyword · kursiv-Serifen-Akzent · Inline-Symbol im Satz.
• Geschichtsformen: Problem(dunkel)→Enthüllung→Funktionen→CTA · Chaos→Ordnung · ein Protagonist viele Zustände · Eingabe→Ergebnis · Manifest mit verankertem Wort · Mikro-Schleife.

Das Kit erweitern

Wenn der Nutzer neue Referenzvideos hinzufügt: Erstelle Kontaktblätter (mit Zeitstempeln, 0,33–1 s Abtastung) + 10-fps-Streifen bei Übergängen, schreibe eine Notiz pro Video in research/video-notes/, füge Zeilen zu research/INDEX.md hinzu und integriere neue Muster in die Grammatik-/Stildateien. Wenn ein Build einen neuen Fehler oder ein neues Primitiv lehrt, füge es zu 07-engineering-pitfalls.md / PRIMITIVES.md hinzu.