motion-explainer (Papierausschnitt-Erklärvideo)

Papierausschnitt-Erklärvideo (Papercut Explainer)

Ein ~20–45 s vertikales Erklärvideo, das wie geschichtetes Tonpapier wirkt, das zum Leben erweckt wird: körnige Papier-Requisiten mit Schlagschatten, starre Ausschnitt-Animation, eine langsame Kamerafahrt mit Stop-Motion-Papierwackeln, ein aufgeklebter Headline-Banner pro Takt und wortweise eingerissene Bildunterschriften. Erstellt mit Remotion, optionalen KI-generierten Textur-Assets und beliebigem TTS.

Jeder Takt besteht aus drei Spuren:

• Der Voiceover erzählt die Geschichte.
• Der aufgeklebte Banner fügt eine harte Tatsache hinzu, die der Voiceover auslässt.
• Ein neues Papier-Set illustriert die Worte des Voiceovers, mit einem groben Papierausschnitt-Nachbau der Produkt-UI, der die Demo zeigt.

Verwenden Sie den Stil und die Erzählweise, aber nicht den Inhalt der ausgearbeiteten Beispiele. Jedes Produkt, jedes Unternehmen und jede Zahl in den Beispielen ist erfunden. Die Stilregeln finden Sie in $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md (Abschnitt 2 ist die Style-DNA).

Vorbereitung (Preflight)

• Bibliothek. Lösen Sie $MOTION_LIB auf, sonst die Zeile MOTION_LIB= in ${XDG_CONFIG_HOME:-~/.config}/motion-explainer/config.env, sonst einmal nachfragen. Niemals einen festen Maschinenpfad hart codieren. Stufen 1 bis 4 benötigen keine Bibliothek.
• Installationsmodus. Überprüfen Sie ihn, bevor Sie eine Stufe versprechen (siehe Installationsmodi unten).
• Serie. Finden Sie den Serienordner (er enthält episodes/). Lesen Sie dessen SERIES.md, falls vorhanden.

Ausführungsmodi (zuerst nachfragen)

1. Komplettes Video (Vollreel), von der Idee bis zur MP4: Stufen 1 bis 8, dann Stufe 9 nach dem Posten.
2. Nur Skript: Strategie, Aufhänger, Skript (anhalten nach der Aufstellungstabelle).
3. Storyboard aus einem vorhandenen Skript: motion-storyboard. Fragen Sie nach dem Skript, den Fakten und dem HOOK-Block.
4. Style-Prompt für ein anderes Werkzeug: den entsprechenden Block aus $MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md ausgeben und anhalten.
5. Eine Szene reparieren oder neu erstellen: motion-build (Szenenschritt), dann motion-qa.

Datenerfassung (Intake) – nur nach Fehlendem fragen

• Quelle: normalerweise ein Link (Repository, Produktseite, Ankündigung). Alles Weitere wird daraus recherchiert.
• Die eine Aussage, die das Video beweist, und das Thema.
• Rollenrahmen: Wer oder was erledigt die Arbeit, wer berät oder genehmigt. Bestätigen Sie es mit dem Benutzer und erfinden Sie niemals Produktverhalten.
• CTA-Keyword und was der Betrachter erhält (das Ergebnis).
• Länge: Standard 22–30 s.
• Zielgruppenniveau (aus SERIES.md) und eventuelle Akzentfarbe oder Maskottchen.

Schreiben Sie die Antworten als BRIEF-Block oben in episodes/NN-slug/research/facts.md (Format in motion-strategy).

Stufen (Stages)

#	Stufe	Skill	Liest	Schreibt
1	Strategie	motion-strategy	SERIES.md, die Quelle	BRIEF in research/facts.md, SERIES.md
2	Aufhänger	motion-hook	BRIEF	HOOK-Block oben in video/STORYBOARD.md
3	Skript	motion-script	BRIEF, HOOK	research/facts.md, narration/script.json, Aufstellungstabelle in STORYBOARD.md
4	Storyboard	motion-storyboard	script.json, STORYBOARD.md	Kamera-/Cuttabelle, Szenenblöcke, SFX-Plan in STORYBOARD.md
5	Gerüst und Plan	motion-build	STORYBOARD.md	das Projekt, episode.json
6	Stimme und Timing	motion-voice	script.json, voice/voice.json	narration/ Takes, public/vo/captions.json, src/plan.json
7	Szenen, Sound, Rendern	motion-build	plan.json, STORYBOARD.md	src/scenes/*, tools/cues.json, out/*.mp4
8	Qualitätssicherung	motion-qa	Standbilder, STORYBOARD.md	Korrekturen, die Zusammenfassung der Auslieferung
9	Nach dem Posten	motion-strategy (Autopsie), motion-build (Ernte)	Plattformzahlen, das Projekt	research/analytics/, Bibliothekswerbungen

Projektdateien

Die Pipeline lebt in Dateien, nicht im Chat. Jede Stufe liest die obigen Dateien und schreibt ihre eigenen, sodass eine neue Sitzung ab jeder Stufe fortsetzen kann.

<serie>/
  SERIES.md                  optional: Zielgruppe, Stimme, Palette, Maskottchen, Keyword-Log
  voice/voice.json           optional: Stimmeinstellungen (Kopie library/voice/voice.example.json)
  video-assets/           optional: Overlay-Texturen und Requisiten
  research/analytics/        optional: Wettbewerbsstudien und Autopsien
  episodes/NN-slug/
    research/facts.md        BRIEF + Fakten mit Quellen
    narration/script.json    [{"id": "l1_hook", "text": "..."}, ...]
    video/
      episode.json           Szenen, Banner, Aufhänger, Lücken, Hintergrundmusik, Schnitte
      STORYBOARD.md          HOOK, Aufstellungstabelle, Kamera-/Cuttabelle, Szenenblöcke

Bibliothekskataloge: style/$MOTION_STYLE/remotion/CATALOG.md (jede Komponente des Kits) und $MOTION_LIB/core/audio/CATALOG.md (jeder SFX und jede Hintergrundmusik). Sie werden generiert, daher kann ein frischer Checkout fehlen oder veraltete enthalten. Führen Sie python3 $MOTION_LIB/core/tools/catalog.py aus, um sie neu zu erstellen. Agenten lesen die Kataloge, nicht den Kit-Quellcode.

Vor dem Schreiben wiederverwenden: Eine Kit-Komponente, ein Requisitensatz oder eine Szenenvorlage ist besser als neuer Zeichencode. Wählen Sie SFX und Hintergrundmusik nach Namen aus.

Installationsmodi (Install modes)

• Minimal (nur Skills): Strategie, Aufhänger, Skript, Storyboard, Style-Prompts. Kein Rendering.
• Standard: Minimal + Bauen und Rendern mit einer Platzhalterstimme (stumm oder macOS say) über $MOTION_LIB/core/tools/placeholder_vo.py, Standbild-QA, SFX und Hintergrundmusik-Audio, die vollständige MP4.
• Voll: Standard + lokales Qwen3-TTS-Voiceover und wortweise Untertitel aus echtem Audio.

Überprüfung (nur lesen):

. "$(grep '^MOTION_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/motion-explainer/config.env" | cut -d= -f2-)/env.sh"   # füllt MOTION_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$MOTION_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'

Die ersten drei Zeilen bestehen bedeutet Standard. Der zusätzlich bestehende Import von qwen_tts bedeutet Voll. Wenn eine Stufe mehr benötigt, als die Installation bietet, sagen Sie dies in einer Zeile, führen Sie ./install.sh --doctor aus dem Repository-Stammverzeichnis aus und übergeben Sie an motion-setup, anstatt zu improvisieren. Finden Sie das Stammverzeichnis mit readlink auf den installierten Skill-Ordner (unter .claude/skills, .agents/skills, .config/opencode/skills oder einem anderen Arbeitsumgebungs-Skills-Ordner) oder MOTION_HOME in der Konfigurationsdatei.

Allgemeine Regeln für alle Stufen

• Strategiehinweise haben Vorrang vor Stilhinweisen: 22–30 s und keine nachrichtenartigen Aufhänger.
• Parallelisieren Sie unabhängige Arbeiten (Szenengruppen, Hintergründe und Requisiten, Neu-Renderings) mit Agenten auf einmal.
• Nur rendern, wenn danach gefragt wird. Vorschau im Remotion Studio.

Gemeinsame Referenzen

• $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md: Style-DNA, Zeichnen im Papierausschnitt-Stil, Palette, Schriftarten, Textur, Kamera und Wackeln, Bewegungs-Timings, Untertitel, Sound.
• $MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md: tragbare Prompts für andere Agenten und Generatoren.
• $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: Die 12 Animationsprinzipien, abgebildet auf Kit-Komponenten und Helfer, mit einer Notiz zur Verwendung in jeder Stufe.
• $MOTION_LIB/style/$MOTION_STYLE/remotion/RECIPES.md: Remotion-Komponenten-Skizzen, für den Fall, dass es keine Bibliothek gibt.
• $MOTION_LIB/style/$MOTION_STYLE/docs/asset-prompts.md: Was generiert versus was im Code gebaut werden soll, mit Prompt-Vorlagen.
• $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md: Ein ausgearbeitetes ~28 s Beispiel mit 0,2 s Auflösung. Kopieren Sie dessen Ereignisdichte, nicht den Inhalt.

Übergabe (Hand-off)

Beginnen Sie bei Stufe 1 für ein komplettes Video oder bei der Stufe, die der Ausführungsmodus angibt. Führen Sie nach der Datenerfassung motion-strategy aus; es liest SERIES.md und das BRIEF und übergibt an motion-hook. Jeder Stufen-Skill nennt den nächsten.