Communitygithub.com

motion-reel

Zeigt einem Agenten, wie man einen „Motion Reel“ plant, baut oder schneidet, damit das konkrete Ergebnis ein fertiger Video-Schnitt ist. Der Ablauf umfasst Motion Reel (Demon Clips Studio), was der Benutzer jedes Mal erwartet (ohne nachfragen zu müssen) und den Workflow. Verwende es, wenn ein neuer Auftrag dieses Handwerk erfordert.

Was ist motion-reel?

Diese Fähigkeit befähigt einen KI-Agenten, vollständige Motion-Reel-Videos von Grund auf zu erstellen – jedes Pixel und jeder Sound wird in Code generiert. Sie basiert auf Remotion für die visuelle Darstellung, Python-Skripten für die Audioproduktion und Edge TTS für Sprachsynthesen. Die Fähigkeit betont die Lieferung eines vollständigen, fertigen Produkts beim ersten Mal, ohne dass der Benutzer nachfragen muss: Hindi-Sprachausgabe, zeitlich auf die Beats abgestimmt, Einbindung von Outros, Erstellung mehrerer Skriptvarianten (Roman Hinglish und Devanagari) und Einhaltung eines strengen visuellen Stils (Paper Glass Lab mit roten Akzenten). Der Workflow ist hochgradig detailliert und umfasst Schritte von der Ideenfindung und Formatierung über das Schreiben von Beats, das Verfassen von Kopien, die Komposition in Remotion, Sounddesign mit Sidechain-Ducking bis hin zum Rendern, Zusammenfügen und der Qualitätssicherung. Die Fähigkeit erzwingt Best Practices wie das Generalisieren von Pipeline-Code für Wiederverwendbarkeit, das Überprüfen von Standbildern vor dem vollständigen Rendern und das Validieren der endgültigen Ausgabe auf Format, Lautstärke und korrekte Outro-Frames. Sie ist für Claude Code und ähnliche Agenten konzipiert, die innerhalb eines bestimmten Projektverzeichnisses (D:\Claude-Chrome\wearethedemon\studio) arbeiten, und folgt einer markdownbasierten Spezifikation.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wearethedemon/motion-reel-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Motion Reel (Demon Clips Studio)

Jedes Pixel und jeder Sound dieser Reels wird in Code erstellt: Remotion für das Bild, pipeline/synth.py für den Sound, Edge TTS oder die eigene Aufnahme des Benutzers für die Stimme. Die Referenz Build ist "Made in code": remotion/src/promo/MadeInCode.tsx, pipeline/promo.py, reels/261120-made-in-code/. Lies sie, bevor du einen neuen Reel schreibst. Kopiere ihre Muster, nicht ihren Text.

Arbeite innerhalb von D:\Claude-Chrome\wearethedemon\studio und befolge studio/CLAUDE.md (Umgebung, Render-Pfad, A:-Laufwerk für temporäre Dateien, vor Downloads fragen, nur committen wenn aufgefordert, kein Claude-Credit).

Was der Benutzer jedes Mal erwartet (nicht nachfragen lassen)

Der Benutzer ist direkt und wird frustriert, wenn etwas zweimal gefragt werden muss. Liefere das Ganze beim ersten Mal:

  • Sprach-Over. Hindi-Erzählung, zeitlich Zeile für Zeile auf die Beats abgestimmt. Verwende die KI-Stimme (Edge TTS hi-IN-MadhurNeural), es sei denn, der Benutzer hat eine eigene im Voice-over-Recorder aufgenommen. Ein Reel mit nur Musik kam zurück als "kein Sprach-Over?".
  • Das Outro angehängt. Die postbaren Dateien sind -ig.mp4 (Folgen) und -yt.mp4 (Abonnieren), mit den eigenen Soundeffekten des Outros und einem Soundtrack, der über Reel und Outro gemastert ist.
  • Beide Skripte. Roman Hinglish und Devanagari, also 4 Dateien: {roman,deva}-{ig,yt}.
  • Lebendige, aber flüssige Bewegung. Dinge poppen, wackeln, pulsieren und überschwingen. Nichts ruckelig oder gehetzt: gib großen Bewegungen Zeit (ein Pendeldurchgang dauert 1,5 s; 1 s war "zu schnell und nicht glatt"), und gib allem, was schnell ist, eine Bewegungsunschärfe-Spur.
  • Haus-Look: Paper Glass Lab. Helles Gitter, weißes Glas, Kanalrot #E5162D / #B80F22, Tinte und Weiß. Nachtinterludien (#0E0E12 plus ein roter Schein) sind für den Rhythmus erlaubt, aber der Benutzer hat sie nicht formell genehmigt, also halte sie optional. Kein Gelb, kein Emoji im Video, keine gefälschten Zahlen, keine verifizierten Abzeichen.
  • Ehrliche Behauptungen. Wenn der Reel sagt "jeder Sound ist Code", dann ist er das. Code auf dem Bildschirm ist die echte Quelle dieses Reels, und ein Test überprüft es.
  • Baue, worum sie gebeten haben. Wenn sie nach X fragen, biete keine abgespeckte Version an und frage erneut.

Arbeitsablauf

1. Format und Idee

Wenn es einen Referenz-Reel gibt, übernimm nur sein Format: Struktur, Rhythmus und Arten von Bewegungen. Niemals sein Skript, seine Untertitel oder Designs. Schreibe 5-8 Beats, jeweils eine Zeile: Was sich bewegt, welcher Text erscheint, welcher Sound abgespielt wird. Überprüfe jede Tatsache, bevor sie in den Text kommt. Verwende eine "Comment KEYWORD"-Karte nur mit einer echten Lieferung in reward.md. Entwerfe diese Datei und markiere sie als benötigt die Zustimmung des Benutzers; sie verschicken die DMs von Hand.

2. Ordner und Text

Erstelle reels/<YYMMDD>-<slug>/ mit:

  • copy.yaml:
    • handle, keyword, brand.
    • Einen roman: und einen deva: Block für den Bildschirmtext.
    • Einen voice: Block: id, rate, lines: [{at, text, roman}]. text ist Devanagari für die TTS, mit englischen Wörtern, die so geschrieben sind, wie eine hi-IN-Stimme sie sagt (कोड, क्लॉड, एडिटर, डी एम). roman ist was der Benutzer im Rekorder liest.
  • reward.md: ENTWURF, bis der Benutzer ihn genehmigt.
  • notes.md:
    • der Build-Befehl und die zu postenden Dateien;
    • eine Checkliste vor dem Posten und ein Vorschlag für ein Cover-Bild;
    • Post-Text: eine IG-Bildunterschrift mit maximal 5 Hashtags, ein YT-Titel mit maximal 100 Zeichen und eine Beschreibung mit 3-5 Hashtags.

3. Zuerst das Beat-Blatt

Setze die Beat-Zeiten in eine JSON-Datei, remotion/src/promo/<slug>.beats.json, in Sekunden.

  • Geteilt: die Komposition und der Python-Mix lesen beide daraus, was jeden Sound auf seinem Frame hält.
  • Namen: Benenne Beats nach dem, was passiert (cut, wall, land[], reveal, stretch, toCard, keyword, brand, fadeOut).
  • Ende: die letzten 0,4 s bleiben ruhig und still, damit die Schleife zurück zu Frame 0 sauber ist.
  • Länge: 25–30 s Reel, plus das 3,5 s Outro.

4. Komposition

Schreibe remotion/src/promo/<Name>.tsx und registriere es in Root.tsx, mit calculateMetadata, das die Länge aus den Beats bezieht.

  • Schema: ein Zod-Schema für jedes Stück Text (script: "roman" | "deva", Zeilen, Karte, Marke, audio, fps). Der römische Text ist die Standardeinstellung.
  • Zeit: in Sekunden, über ../motion (seconds, springAt, ramp, wiggle, pulse, loop, stagger) und die Federn in brand/tokens.ts (SPRING.ui 18/160/0.8, SPRING.stamp 11/220/0.7). Niemals Frame-Zahlen, damit jede Bildrate funktioniert.
  • Kit: Backdrop, NightBackdrop, FitLine (passt eine Linie an eine Breite an), Card, Chip, Stamp, Rich, Phone, CaptionBar, SafeOverlay.
  • Text:
    • Halte ihn in der Sicherheitszone: x 60–950, y 250–1560. Nichts, was gelesen werden soll, ist unter 34 px.
    • Römische Untertitel sind in GROSSBUCHSTABEN Rajdhani; zweite Zeilen sind Poppins 600 kursiv in Rot.
    • Devanagari wird nicht großgeschrieben. Es benötigt größere Maximalgrößen (etwa 148/120 gegenüber Roman 150/128, der Pill 72 gegenüber 64), lineHeight ≥ 1.25 und lang="hi".
  • Abwechslung: Mische 4–6 Bewegungen aus dem untenstehenden Vokabular, in einer anderen Reihenfolge pro Reel. YouTube behandelt wiederholte Vorlagen als unauthentischen Inhalt.

5. Sound und Stimme

Siehe „Sound" unten. Musik und Soundeffekte gehen auf einen Bus zu den Beat-Zeiten. Die Musik duckt sich um −9 dB und die Effekte um −5 dB unter der Stimme. Dann kommt der Limiter, dann Loudnorm auf −14 LUFS. Jede Sprachzeile endet vor der nächsten beginnt.

6. Pipeline-Modul

pipeline/promo.py ist auf den einen Made-in-Code-Reel verdrahtet (SLUG, COMPOSITION, BEATS_JSON, seine music/sfx).

Wenn du das erste Mal einen zweiten Reel baust, generalisiere ihn, anstatt die Datei zu kopieren:

  • Verschiebe die gemeinsamen Teile (load_copy, voiceover, soundtrack, _master, render, filmstrip, final) in ein Modul, das eine Reel-Konfiguration nimmt: Slug, Kompositions-ID, Beats-Pfad und die music(b) und sfx(b) dieses Reels.
  • Behalte promo.py als dünne Konfiguration für Made in Code und gib der CLI ein --reel <slug>.
  • Mache dasselbe für den Rekorder: pipeline/recorder.py Project nimmt den Slug, und pipeline record --reel <slug> funktioniert, damit die Voice-over-Recorder-App jeden Reel vertonen kann.

Halte die Tests bestanden und sage in deinem Bericht, dass du diese Änderung vorgenommen hast.

7. Filmstrip-Überprüfung vor dem vollständigen Render

Rendere Key-Beat-Standbilder (6 pro Reihe, --filmstrip) in A:\claude-workspace\screenshots\demon-studio\<slug>\ und sieh sie dir selbst an. Überprüfe:

  • dass Text lesbar und in der Sicherheitszone ist und Devanagari nicht zu klein ist;
  • auf leere Momente (eine Karte, die 0,6 s lang leer sitzt, sieht kaputt aus, also starte ihren Text innerhalb von etwa 0,4 s);
  • dass lange letzte Zeilen nicht die Ränder berühren und geschichtete Effekte ausgerichtet sind.

Korrigiere, rendere die Standbilder neu, dann rendere das Video.

8. Rendern, Outro, endgültige Dateien

Baue den Mix, dann rendere jedes Skript. final() hängt dann:

  • das Plattform-Outro an: O.render_outro(platform, script, keyword=..., reward=...), mit seinem dritten Aufzählungspunkt "Comment KEYWORD: reward";
  • fügt die beiden Videos zusammen und mastert einen Soundtrack über beide;
  • codiert H.264 CRF 18, BT.709 limited range, AAC 320k 48 kHz, +faststart.

9. Verifizieren, dann Bericht erstatten

  • Format (ffprobe): 1080×1920, 30 fps, yuv420p, BT.709, AAC 48 kHz Stereo, Länge = Reel + Outro.
  • Lautstärke: −14 ±1 LUFS und True Peak ≤ −1 dBTP auf jeder finalen Datei.
  • Audio vorhanden: Überprüfe RMS pro Sekunde mit ffmpeg.
  • Outro-Frames: Überschrift, Karte, Antippen, Folgt/Abonniert, Keyword-Bullet.
  • Tests: uv run python -m pytest -q besteht. Füge Tests für den neuen Reel hinzu:
    • der Code auf dem Bildschirm ist echt;
    • die Beats sind in Ordnung;
    • die Props sind für beide Skripte gültig;
    • jede Sprachzeile endet 0,05 s vor der nächsten;
    • der Soundtrack läuft volle Länge mit einer stillen letzten 0,4 s;
    • das Keyword hat eine Belohnung.

Berichte in einfachen Worten:

  • die 4 zu postenden Dateien als Links;
  • den Reel Beat für Beat als kurze Liste;
  • was du überprüft hast und was du nicht konntest (du kannst nicht zuhören, also sollten sie es abspielen);
  • offene Entscheidungen: Belohnungsgenehmigung, Cover-Bild.

Erinnere sie daran, dass die VS Code-Vorschau diese Dateien stumm abspielen kann ("warum ist kein Ton?"). VLC, Windows Media Player oder Chrome spielen sie korrekt ab.

Bewegungsvokabular (Code in MadeInCode.tsx)

Ein Heldenobjekt treibt den Reel an (der rote Ball). Alles andere reagiert darauf, wo es ist, was Ursache und Wirkung ergibt: Der Ball passiert, der Text erscheint.

Pfade

  • Pendel. ballAt: x = 540 − SWING·cos(t·TURN), y auf dem Kreis der Schnur (stringY), mit TURN = π / pass und einem 1,5 s Durchgang. PendulumString hat einen weichen Schatten und rastet nach dem Schnitt am Drehpunkt ein.
  • Hüpfer. hop(a, b, u, h) ist eine gerade Linie minus 4·h·u·(1−u): eine echte Parabel mit Scheitelhöhe h. Kette Hüpfer eine Treppe von Landepunkten hinunter. Erweiche das endgültige Einrasten mit Easing.out(Easing.back(1.5)).
  • Flug in eine Wand. Ease-in quadratisch, plus einen kleinen sin(u·π) Bogen.
  • Gleiten. lensAt: Catmull-Rom durch Keyframes, Einweichen im ersten Segment und Ausweichen im letzten.
  • Bewegungsunschärfe-Spur. Trail: Abtasten der letzten 0,09 s des Pfades und Zeichnen von ceil(length / 5 px) Kreisen (maximal 48) unter einem SVG feGaussianBlur, die zum Ende hin schrumpfen und verblassen (0.16·(1−k)^1.4). Die Kopien überlappen sich, sodass es wie ein Komet wirkt, niemals wie Perlen.

Text

  • Wischen, das dem Objekt folgt. SceneSwing/SwingText: Jeder Untertitel ist eine Vollbild-Ebene, beschnitten mit clip-path: inset() bei der x-Position des Balls. Der neue Untertitel erscheint hinter dem Ball, der alte davor, und die Richtung wechselt sich mit jedem Durchgang ab.
  • Stempel bei der Landung. StackLine: Die Zeile poppt mit springAt(c, at, SPRING.stamp) genau auf dem Landungs-Beat.

Aufprälle und Leben

  • Quetschen und Dehnen. squashAt: für 0,14 s nach einer Landung, sx += 0.3·sin und sy −= 0.26·sin, mit transform-origin: 50% 100%. Ein Wandtreffer dehnt in die andere Richtung.
  • Welligkeit. Ein flacher elliptischer Ring, der sich über 0,45 s vom Kontaktpunkt aus ausdehnt.
  • Ausbruch. 14 Glitzer und Punkte, mit random() gesät, sodass Render exakt wiederholbar sind. Verwende es nur für den einen großen Moment (das Keyword).
  • Wackeln und Pulsieren. wiggle(c, at, dur, hz, amp) schüttelt die Rotation; pulse(c, at, dur, amount) skaliert die Größe. Multipliziere Pulse miteinander und füge am Ende jede Sekunde einen weichen Puls hinzu, damit die Karte weiter atmet.
  • Glanz. Ein geneigter weißer Farbverlaufsbalken überquert die Pille einmal.

Szenen

  • Hell zu Nacht. Der Ball zieht ein NightBackdrop-Panel über das Papier. Seine Vorderkante ist eine geneigte Linie (panelEdge/edgeX, Neigung erweichend 0 → 14° → −6°), die verwendet wird, um die Nachtschicht als Polyagon zu beschneiden.
  • Zurück zum Papier. Schneide auf einen starken Beat zurück.
  • Kamera-Einzoom. 3–6 % pro Szene ist in Ordnung, aber niemals in einer Szene mit einer Lupe.

Fokus und Enthüllung

  • Ball zu Linse. lensRadius/Lens: Der Ball bläst sich zu einem roten Ring auf (Feder), füllt sich mit Glas, bekommt einen Griff und gleitet über eine graue Code-Ebene, während der Rest abdunkelt. Die Enthüllungswörter poppen dann im Glas auf, und es schließt sich wieder zum Ball (Easing.in(Easing.back(1.4))).
  • Vergrößern. Zeichne im Glas dieselbe Ebene, skaliert um ZOOM (2.1) mit transform-origin am Linsenzentrum. Wenn sich die Basisebene bewegt (ein Kameraeinzoom), driftet die vergrößerte Kopie aus der Linie.
  • Code auf dem Bildschirm. Er kommt von code-lines.ts: wörtliche Zeilen des eigenen Quellcodes dieses Reels, die durch einen Test synchron gehalten werden, farbig hervorgehoben nur innerhalb der Linse.

CTA-Morph

  • Die Form. Morph baut ein abgerundetes Rechteck aus drei Federn: Breite sW, Höhe sH (lockerer, sodass es wackelt) und Karte sC. w = 60 + 840·sW + 20·sC, h = hPill + 430·sC, und der Radius geht von Pille zu 52.
  • Die Sequenz. Ball → Pille mit dem CTA-Text, der nach oben rutscht → wackeln und glänzen → Karte. Die Karte hält MessageCircle + "comment karo", dann ein 190 px kursives Keyword, das von Skala 1,7 auf 1 mit einem Ausbruch gestempelt wird, dann die Post-Zeile.
  • Das Ende. Brand-Verbund (Emblem, Anton-Wortmarke, Mono-Tag), ein Ausblenden in die Nacht und eine stille letzte 0,4 s. Ein @handle-Wasserzeichen bleibt oben links während des gesamten Videos.

Sound (pipeline/synth.py, pipeline/audio.py)

S.Bus(seconds) ist eine Stereo-Zeitleiste:

  • add(clip, at, gain_db, pan) platziert einen Clip.
  • mix(other, db) summiert zwei Busse.
  • duck_under(key, depth_db) Sidechain-Ducking unter einem anderen Bus.
  • fade_out(start, end) und peak().

Lese jedes Mal aus dem Beats-JSON. Die Regel: Jeder visuelle Beat bekommt einen Sound, und schnelle Bewegung bekommt Luft. Gib jedem Whoosh seinen eigenen seed und panne kleine Sounds ±0.15–0.7.

VisuellSoundGain dB
Schneller Durchgang oder Flugwhoosh(dur, lo, hi, peak, seed), mit Spitze, wo es sich am schnellsten bewegt, in Richtung gepannt−11 bis −16
Extremwerte des Durchgangs, UI-Tickstick(freq, dur)−24
Schnitt, Schnurrisssnap() + riser(dur) in den nächsten Treffer−13 / −17
Großer Treffer (Wand, Keyword)impact()−9 / −10
Landungthud(150, 50, 0.4) + pop(900+80·i, 300), steigend mit jeder Landung−8 / −13
Lichter an, abgeschlossenting(Hz): 1318.5, 1568, 1760, 2093, 2637−13 bis −15
Aufblasen, dehnen, morphboing(f0, f1, dur)−10 bis −14
Enthüllung, Glitzer, Glanzshimmer(base, gap)−13 bis −22
Schrumpfen, schließenzip_down()−14
Wackelnrattle()−13

Musik bei 120 BPM, A-Moll Am F C G, 2 s Takte (ein 1,5 s Durchgang = 3 Beats, sodass Bewegung und Musik synchron sind).

  • pad pro Takt, leiser und dunkler, wo der Betrachter liest oder schaut.
  • Ein pluck Karplus-Strong-Arpeggio in Achteln, zwei Oktaven höher.
  • kick auf den Bewegungsakzenten und Four-on-the-Floor im Build.
  • hat und sub nur in den Nachtszenen.
  • Ein finaler pad unter der Wortmarke.

Stimme

  • KI-Stimme: Edge TTS 7.3.1, hi-IN-MadhurNeural bei +8 % (hi-IN-SwaraNeural ist die weibliche Option). Sie wird in build/voice/ gecacht, und es wird nur Skripttext gesendet.
  • Eigene Stimme: voiceover(mode="auto") bevorzugt die Recorder-Aufnahme (audio/voice-take.json), dann audio/my-voice.* (eine Aufnahme, die an den Pausen von pipeline/ownvoice.py geschnitten wurde), dann die KI-Stimme. --voice ai|own erzwingt eine.
  • Zeilen: jede Zeile ist 2–6 Wörter und beginnt auf ihrem Beat. Messe jeden Clip: Er muss enden ≥ 0,05 s vor der nächsten Zeile, und die letzte vor fadeOut. Kürze die Wörter, wenn nicht. Hochpass 80 Hz,

...

[gekürzt für die Übersetzung]

Verwandte Skills