Communitygithub.com

motion-qa

Überprüft die Standbilder eines Papercut-Films auf Übereinstimmung mit dem Style-DNA und dem Storyboard. Erstellt Kontaktabzüge zu mehreren Zeitpunkten, führt die vollständige Checkliste durch und schreibt eine Zusammenfassung. Nutze dies für „den Film QAen“, „prüfen, ob meine Szenen wie Papier aussehen“, „ist das bereit zum Veröffentlichen?“.

Was ist motion-qa?

Dieses Skill, motion-qa, ist ein spezialisiertes QA-Tool für die Erstellung von Papercut-Animationsfilmen, typischerweise in Verbindung mit Remotion- oder Kyfram-Projekten. Es automatisiert die visuelle Qualitätskontrolle, indem es Standbilder aus der Produktion zu bestimmten Zeitpunkten rendert und gegen zwei zentrale Referenzen prüft: das Style-DNA (im Style Guide dokumentiert) und das Storyboard. Der Entwickler führt das Skript pro Szene oder für den gesamten Film aus, erhält Kontaktabzüge mit mehreren Thumbnails und geht dann eine sehr detaillierte Checkliste durch, die Stilelemente (Papieroptik, Schatten), Kamerabewegungen, die Positionierung von Bannern und Untertiteln, visuelle Gags, die Synchronisation von Voiceover, Untertiteln und Ereignissen sowie die Einhaltung des HOOK-Blocks umfasst. Nach bestandener Prüfung erstellt das Skill eine Zusammenfassung der Lieferung, die angibt, welche Elemente Platzhalter sind (Stimme, Musik, SFX, Assets) und wie diese ersetzt werden können. Die Ausgabe von motion-qa wird zur strategischen Analyse an motion-strategy und für Korrekturen an motion-build oder motion-voice übergeben. Das Tool setzt ein korrekt eingerichtetes Projekt voraus (Remotion, Python mit numpy und Pillow) und erfordert, dass der Benutzer das Style-DNA und das Frame-Breakdown-Dokument gelesen hat.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Papercut QA

Vergleiche Standbilder hinsichtlich des Stils, nicht des Inhalts, mit dem Style-DNA und dem Storyboard. Führe es pro Szene während der Erstellung und einmal für den gesamten Film vor dem finalen Render durch.

Vorbereitung

  • Standard- oder Vollinstallation erforderlich. Standbilder benötigen ein eingerichtetes Projekt mit Remotion, und die Kontaktabzüge benötigen Python mit numpy und Pillow ($MOTION_PY). Fehlende Teile: ./install.sh --doctor, dann motion-setup.
  • Ein kyfram-Projekt benötigt kein Remotion: Rufe das kyfram-Skill auf, bevor du Kyfram-Szenenausgaben inspizierst oder korrigierst. qa.sh extrahiert seine Standbilder aus den zwischengespeicherten szenenweisen Segmenten (core/tools/kyfram_qa.py), rendere also einmal mit core/tools/render.sh vor der QA. Alles untenstehende gilt unverändert.
  • Bibliothek: $MOTION_LIB, sonst die MOTION_LIB=-Zeile in ~/.config/motion-explainer/config.env, sonst einmal nachfragen.
  • Zuerst lesen: Style-DNA in $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md Abschnitt 2, und das Hintergrundblatt style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Jedes Bild kostet etwa 0,7-1,5k Token, öffne also nur das, was der Schritt benötigt.
  • Für die Dichte: $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md („Pacing-Statistiken“ am Ende): Szenen durchschnittlich 2,8 s, 2-4 diskrete visuelle Ereignisse pro Szene, eines alle 0,4-0,8 s auf einem betonten Wort, etwa alle 0,6 s eine neue Untertitel-Seite. Kopiere die Dichte, nicht den Inhalt.

1. Standbilder rendern

Aus dem video/-Ordner des Projekts:

$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • Verwende 4-6 Zeitpunkte pro Prüfung. Für eine Szene ist NTH etwa ihre Länge in Frames geteilt durch 4. Lasse FROM-TO für den gesamten Film weg und erhöhe NTH.
  • Die Ausgabe ist out/qa/NAME_0.jpg (und _1, _2 für längere Bereiche), maximal 45 Frames pro Blatt. Lies das Blatt; halte die Blätter klein.
  • Ein QA-Befehl pro Szene und niemals zwei Render gleichzeitig. Halte Korrekturen auf zwei Durchgänge pro Szene.
  • Prüfe gegen das Storyboard: Frame 0 der Szene, ihre wichtigen Ereignisse auf ihren Wörtern, nichts abgeschnitten, nichts bedeckt das Banner oder die Untertitel-Bänder.

2. Checkliste

  • Jedes Objekt liest sich als Papier: Körnung, raue Kante, Schlagschatten, gestapelte Schattierung, keine Konturen oder Verläufe.
  • Die Weltkamera bewegt sich gleichmäßig. Nur das Banner und die Beschriftungen flimmern (gestuft, subtil).
  • Das Banner ist fixiert und geklebt, 3-7 Wörter, eine Tatsache pro Wort, wiederholt nie das VO. Die Banner allein ergeben ein Faktendatenblatt.
  • Jedes Set veranschaulicht ein konkretes Wort in seiner VO-Zeile, Zahlen sind physische Requisiten, und es gibt ein Callback-Set vor dem CTA.
  • Jede Zahl und jedes UI-Label leitet sich von der Faktenliste ab. Das Skript enthält mindestens eine ehrliche Einschränkung und einen Funktionsstapel von genau drei.
  • Untertitel: ein Tag pro Wort, geneigt, erscheinen mit Einsatz, Seiten von 1-3, im Bereich 68-80%, nie auf einem Gesicht.
  • Sättigung nur bei Figuren, Untertiteln und Signalen.
  • Ein visuelles Ereignis auf jedem betonten Wort, mit ständig laufender Ambient-Bewegung.
  • Schnitte bei Bannerwechseln (Sets 1,5-3 s in Touren und Nachrichten, bis zu 5 s in einem Metaphernbeat), untere 20% frei.
  • Der HOOK-Block (SAY / WRITE / SHOW / ALIGN) ist exakt wie geschrieben auf dem Bildschirm: Frame 0 zeigt den SHOW-Moment in Aktion mit dem WRITE-Titel darauf, und die erste VO-Zeile ist SAY.
  • Jede Szene hat eine Kamerafahrt, höchstens einen Seitenwechsel oder Riss, einen Klebebandabzug oder eine Peitsche in den CTA, und jeder Übergang hat seinen SFX.
  • Humor im Bild sichtbar: ein einheitliches Format, ein Kostüm-Requisit pro Idee, ein Beat des Kampfes, das Requisit von Frame 0 kehrt verändert im CTA-Set zurück, und jeder Gag ist in unter 1 s lesbar und bedeckt nie das Banner, die Untertitel oder die Schlüsselzahl.
  • Wortschatz in VO und Banner stimmt mit dem Zielgruppenniveau in SERIES.md überein.
  • Voiceover, Untertitel und Ereignisse sind synchron (Scrub das Studio bei jedem Schnitt).

Bei einem fehlgeschlagenen Punkt korrigiere die Szenendatei (oder das Kit in der Bibliothek, niemals src/lib/ im Projekt) und führe die eine Szene erneut aus. Baue eine Szene mit motion-build wieder auf.

3. Liefern

Öffne die Studio-Vorschau, liste die Szenen mit ihren Zeitangaben auf und gib an, was Platzhalter ist: Stimme, Musik, SFX, Assets. Wenn die Stimme ein Platzhalter ist, gib an, wie man sie neu vertont (motion-voice). Nach der Veröffentlichung gehen die Zahlen an motion-strategy für die Autopsie.

Prinzipienprüfung

Scrub eine Szene mit 5 fps und prüfe gegen $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: Antizipation vor jeder großen Bewegung (2), alles erleichtert (6), etwas hinterherziehend nach Einschlägen (5), ein Brennpunkt-Requisit (3), ein übertriebener Beat (10), gestapelte Schattierung und ein durchgehender Schatten (11).

Übergabe

Korrekturen gehen zurück an motion-build (Szene oder Sound) oder motion-voice (Sync). Ein sauberer Durchlauf beendet den Film: Rendere mit $MOTION_LIB/core/tools/render.sh, wenn der Benutzer darum bittet.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

Verwandte Skills