Communitygithub.com

motion-script

Verwandle einen Link in ein Papercut-Reel-Skript. Recherchiert eine Liste von Quellen, schreibt das 75-95 Wörter umfassende Skript auf die 10-Beat-Struktur, eine Banner-Faktenspur, eine Inszenierungstabelle mit einem Set pro Banner und den Humor-Durchgang. Verwende für 'Schreibe das Skript', 'Recherchiere dieses Repo für ein Reel'.

Was ist motion-script?

Dieses Skill automatisiert die Erstellung eines vollständigen Papercut-Reel-Skripts aus einem gegebenen Link oder einer Quelle. Es erstellt nicht nur das Voiceover-Skript, sondern generiert gleichzeitig eine Faktenspur (Banner), eine Bühnenbildtabelle (Sets) und einen Humor-Durchgang. Der gesamte Prozess basiert auf einer 10-Beat-Struktur mit einer Wortanzahl von 75-95 Wörtern für eine Dauer von 22-30 Sekunden. Das Skill ist für Claude Code, Cursor, Codex und ähnliche KI-Agenten optimiert und erfordert die vorherige Ausführung von `motion-strategy` oder `motion-hook`, um die nötigen Briefing- und Hook-Informationen bereitzustellen. Der Workflow umfasst die Recherche von Fakten und UI-Elementen, die Auswahl eines Erzählmodus (Open-Source-Alternative, News-Launch, Feature-Enthüllung), die Erstellung des Skripts, der Banner, der Inszenierungstabelle und schließlich die Humor-Passage. Das Ergebnis wird in den Dateien `research/facts.md`, `narration/script.json` und `STORYBOARD.md` abgelegt und an das nächste Skill `motion-storyboard` übergeben.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-script

In Ihrer bevorzugten KI fragen

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

Dokumentation

Papercut-Skript

Recherche, Skript, Banner-Spur, Inszenierung und Gags werden gemeinsam geschrieben, da jeder Schritt die anderen beeinflusst. Das vollständige System mit der Phrasendatenbank und zwei durchgespielten Beispielen befindet sich in references/storytelling.md. Die Gag- und Formatdatenbanken: references/comedy.md.

Jeder Beat hat drei Spuren, die unterschiedliche Aufgaben erfüllen:

  • Voiceover (als Untertitel-Tags dargestellt): erzählt die Geschichte, locker und in der zweiten Person, ändert sich mit jedem Satz.
  • Banner: fügt die harte Tatsache, Zahl oder ehrliche Einschränkung hinzu, die das Voiceover auslässt, ändert sich alle 1,8-3 s.
  • Set: stellt buchstäblich ein konkretes Nomen aus dem Voiceover dar, wobei die Produkt-UI die Demo macht, ändert sich mit dem Banner.

Preflight

  • Installation: Das Minimum reicht aus. Setze $MOTION_LIB nur, wenn du das Hintergrundblatt (style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg) bei der Set-Auswahl benötigst. Jedes Bild kostet etwa 0,7-1,5k Tokens, öffne daher nur das, was der Schritt braucht.
  • Benötigt den BRIEF am Anfang von episodes/NN-slug/research/facts.md und den HOOK-Block am Anfang von episodes/NN-slug/video/STORYBOARD.md. Fehlt einer: Führe zuerst motion-strategy oder motion-hook aus.
  • Die Recherche benötigt Web-Fetch oder -Suche und ein Browser-Tool für Screenshots. Ohne diese: Frage den Benutzer nach Screenshots und Fakten.

1. Recherche und grobe UI

  • Sammle Fakten aus der Quelle mit einer Quelle für jede: Name, Hersteller, Zahlen, Preis, Anforderungen, Einschränkungen, Konkurrenzzahlen. Markiere alles Unsichere.
  • Erfasse die wichtigsten Screens (2-4), echte Labels und Schaltflächentexte, die Akzentfarbe und Heldenbilder. Das Video baut eine grobe Version der UI als Papercut-Requisten nach, keinen Screen-Recording (siehe references/storytelling.md Abschnitt 5).
  • Bestätige den Rollenrahmen aus dem BRIEF. Erfinde niemals Produktverhalten. Siehe den Hinweis zum Rollenrahmen in $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md.
  • Schreibe die Liste nach research/facts.md unter den BRIEF. Jede Zahl im Skript, in den Bannern und in der UI muss darauf zurückgeführt werden können.

2. Wähle den Modus

ModusWann
Open-Source-AlternativeEine kostenlose oder lokale Alternative zu einem kostenpflichtigen Produkt
News-Launch / lohnenswertEine neue kostenpflichtige Stufe, ein Modell oder eine Funktion eines großen Unternehmens
Feature-Enthüllung / AnleitungEine versteckte Einstellung oder ein Befehl, der die Funktionsweise eines Tools verändert

Hook-Formeln und die Mitte jedes Modus: references/storytelling.md Abschnitt 6. Wende das Hook-Update an: Öffne die Lücke und den Einsatz, nicht die Nachricht.

3. Skript auf der Struktur

Schreibe 75-95 Wörter für 22-30 s, etwa 3,5-4 Wörter pro Sekunde, im gewählten Format, mit einem neuen Set alle 1,5-3 s. Die 10 Beats:

  1. Hook (0-3 s), bereits durch motion-hook festgelegt
  2. Beweis oder Spannung
  3. Umdeutung („Anstatt also... kannst du...“)
  4. Namensenthüllung („Es heißt...“, niemals vor dem Hook)
  5. Funktionsweise, eine konkrete Demo
  6. Steigerung („Und X ist erst der Anfang, denn...“ plus ein Stack von genau drei)
  7. Höhepunkt („Und das Beste:“ plus die größte Zahl)
  8. Haken (der ehrliche Gegenpunkt)
  9. Auszahlung („was bedeutet...“)
  10. Call-to-Action („Gut, dass ich [Kostenlos] gemacht habe. Für den Link, kommentiere KEYWORD.“)

Verkürze Beats, anstatt das Voiceover zu beschleunigen. Regeln:

  • Zweite Person, Kontraktionen, kurze Nebensätze verbunden durch „und“, „weil“, „was bedeutet“. Wortschatz auf dem Niveau des Publikums in SERIES.md.
  • Nenne eine große Marke im ersten Satz, auch wenn das Thema etwas anderes ist.
  • Jede Zahl ist konkret und belegt. Ein Feature-Stack, immer drei Elemente.
  • Mindestens eine echte Einschränkung, im VO oder in den Bannern. Das CTA-Schlüsselwort ist ein kurzes Wort, das mit dem Thema verbunden ist.
  • Die letzte Zeile wiederholt das Schlüsselwort oder die Zahl des Hooks und gibt dann das Schlüsselwort.

Schreibe es nach narration/script.json als [{"id": "l1_hook", "text": "..."}, ...], eine Zeile pro Satz oder Nebensatzgruppe. Die Zeile l1_hook ist SAY aus dem HOOK-Block. Markiere das eine oder die zwei Wörter, auf die sich jede Zeile stützt (die Zahl, das Wendewort, das Urteil) in der Inszenierungstabelle; motion-voice verwendet sie.

4. Banner-Spur

10-18 Banner, 3-7 Wörter, ALLES GROSS, ein Fakt pro Banner, etwa eines alle 2-3 s. Sie wiederholen niemals das VO: Allein gelesen ergeben sie ein Faktblatt. Enthalte eine Überschriftenstatistik, eine Preisübersetzung, eine Glaubwürdigkeitstatsache, Verfügbarkeit, mindestens eine ehrliche Einschränkung, mindestens eine Vertrauens- oder Sicherheitstatsache, Feature-Behauptungen, mindestens einen Konkurrenzvergleich und ein Angebots-/Entscheidungsbanner vor dem CTA. Typen und Beispiele: references/storytelling.md Abschnitt 3.

5. Inszenierungstabelle

Eine Zeile pro Banner, geschrieben in STORYBOARD.md unter dem HOOK-Block:

t (s) | VO-Wörter darunter | BANNER | SET (Raum + Hintergrundfarbe) | HELDEN-PROP (ein visuelles Wortspiel aus dem konkreten Nomen des VO) | PRODUKT-UI-Moment | MASKOTTCHEN-Aktion und Kostüm-Prop | GAG

  • Ein neues Set für jedes Banner, sich abwechselnde Hintergrundfarben. Das Set illustriert ein Wort in der VO-Zeile, nicht das Banner.
  • Zahlen werden zu physischen Requisiten: Preisschilder, Waagen, Multiplikatorwände, Messgeräte, Tachometer, Wettrennen. Konkurrenten erscheinen als gepinnte Karten, niemals als Held.
  • Das Maskottchen ist der Stellvertreter des Zuschauers und reagiert. Die Produkt-UI ist ein grober Nachbau auf einem Papier-Monitor oder Laptop mit fiktiven Interaktionen.
  • Ein Rückruf auf ein früheres Set vor dem CTA. Das CTA-Set zeigt ein Kommentarfeld, das das Schlüsselwort tippt.
  • motion-storyboard fügt die Kamera- und Übergangsspalten hinzu.

6. Humor-Durchgang (nach dem Skript, bevor die Inszenierung endgültig ist)

Füge die GAG-Spalte hinzu. Das Voiceover bleibt ernst; nur das Bild ist albern.

  1. Ein Format für das gesamte Reel.
  2. Ein Gag pro Banner, der den Punkt darstellt, aus references/comedy.md.
  3. Ein Kostüm-Prop pro Idee. Das eigene Objekt des Maskottchens bleibt an und bekommt ein weiteres Prop obendrauf.
  4. Ein Beat mit einem kämpfenden Maskottchen, bei der Hakenzeile.
  5. Ein Prop in Szene 0, das verändert im CTA-Set zurückkehrt (ICH BIN RAUS wird KOSTENLOS).
  6. Ein absurder, unerklärter Hintergrundmoment.
  7. Höchstens ein Meme, nachgebaut im eigenen Stil der Serie, niemals ein echter Clip, Standbild oder Audio.

Kein Gag darf das Banner, die Untertitel oder die Schlüsselzahl verdecken, und jeder muss in weniger als 1 s zu erfassen sein.

Gate

  • 75-95 Wörter, 22-30 s, eine echte Einschränkung, ein Stack von genau drei.
  • Jede Zahl und jedes Banner sind auf facts.md zurückführbar; Banner allein ergeben ein Faktblatt.
  • Die letzte Zeile wiederholt das Schlüsselwort oder die Zahl des Hooks.
  • Humor-Durchgang abgeschlossen: Kostüm pro Idee, ein kämpfender Beat, ein zurückkehrendes Prop, ein absurder Moment, höchstens ein Meme.

Übergabe

Als nächstes kommt motion-storyboard. Es liest narration/script.json und den HOOK-Block und die Inszenierungstabelle in episodes/NN-slug/video/STORYBOARD.md. Für einen Skript-nur-Durchlauf: Halte hier an und gib dem Benutzer diese Dateien. Der Copy-Paste-Storytelling-Prompt für ein anderes Tool ist references/storytelling.md Abschnitt 7.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills