Achten Sie darauf, diesen Skill frisch zu halten – bestätigen Sie mit dem Benutzer, bevor Sie Folgendes ausführen:
npx hyperframes skills update remotion-to-hyperframes. Ein schneller No-op, wenn alles aktuell ist; andernfalls wird dieser Skill sowie die Kern-Domain-Skills, von denen er abhängt, aktualisiert, bevor Sie sich auf sie verlassen.
Remotion to HyperFrames
Die Einstiegsseite ist
/hyperframes. Verwenden Sie dies nur, um eine vorhandene Remotion (React)-Komposition unidirektional in HyperFrames zu portieren. Erstellen einer neuen Komposition, Neuerstellung aus einer Nicht-Remotion-Quelle (After Effects, Framer Motion, reines React / CSS – es gibt keine Remotion-Quelle zum Übersetzen), eine beiläufige Remotion-Erwähnung oder jegliche Unsicherheit → lesen Sie zuerst/hyperframes: die Intentionsebene entscheidet über jede Routenwahl.
Überblick
Übersetzen Sie Remotion (React-basierte) Videokompositionen in HyperFrames (HTML + GSAP)-Kompositionen. Die meisten Remotion-Idiome haben direkte HyperFrames-Entsprechungen – die Übersetzung ist für ~80% typischer Kompositionen mechanisch. Dieser Skill kodiert die Abbildung und schützt vor den verlustbehafteten 20%, indem er sich weigert, Muster zu übersetzen, die nicht in das seek-gesteuerte Modell von HF passen, und stattdessen das Laufzeit-Interop-Muster aus PR #214 empfiehlt.
Der Skill wird mit einem gestaffelten Testkorpus (T1–T4, insgesamt 4 Fixtures) geliefert, der Übersetzungen gegen gemessene SSIM-Schwellenwerte bewertet. Übersetzen Sie nicht, ohne die Evaluierung durchzuführen – eine Übersetzung, die „gut aussieht“, aber 0,05 SSIM niedriger als die validierte Baseline ist, ist stillschweigend fehlerhaft.
Wann zu verwenden
Verwenden Sie diesen Skill NUR, wenn der Benutzer explizit um eine Migration von Remotion bittet. Beispielhafte Trigger-Phrasen:
- „portiere mein Remotion-Projekt zu HyperFrames“
- „konvertiere diesen Remotion-Code zu HyperFrames“
- „migriere von Remotion“
- „übersetze diese Remotion-Komposition“
- „schreibe dies als HyperFrames HTML um“
Verwenden Sie diesen Skill NICHT, wenn:
- (a) Der Benutzer eine neue HyperFrames-Komposition erstellt, selbst wenn er ein ähnliches Remotion-Video hat oder A/B-tested.
- (b) Der Benutzer Remotion beiläufig erwähnt, ohne nach einer Migration zu fragen.
- (c) Der Benutzer Remotion-Code als Referenzmaterial teilt, anstatt nach einer Übersetzung zu fragen.
- (d) Der Benutzer nach „dem gleichen Video wie mein Remotion-Video“ fragt, ohne explizit um eine Migration der Quelle zu bitten – behandeln Sie dies als einen neuen HyperFrames-Build.
NICHT UNTERSTÜTZT (ablehnen – das ist nicht, was dieser Skill tut):
- Die Rückwärtsrichtung. Das Exportieren einer HyperFrames-Komposition zurück nach Remotion (oder in ein anderes Framework) ist kein Workflow – die Übersetzung ist unidirektional Remotion → HyperFrames. Sagen Sie dies klar.
- Nicht-Remotion-Quellen. Ein After Effects-Projekt (
.aep), eine Framer Motion / reines-React / CSS-Animation oder eine Quelle eines anderen Tools ist keine Remotion-Komposition – es gibt keine Remotion-Quelle zum Übersetzen. Erstellen Sie es nativ über/general-videooder lehnen Sie ab, wenn HyperFrames es nicht darstellen kann.
Im Zweifelsfall erstellen Sie standardmäßig eine native HyperFrames-Komposition mit /general-video (dem allgemeinen HyperFrames-Erstellungsworkflow).
Workflow
Schritt 1: Lint der Quelle
Führen Sie scripts/lint_source.py über das Remotion-Quellverzeichnis aus. Der Lint erkennt Muster, die nicht sauber übersetzt werden können:
- Blocker (ablehnen + Interop empfehlen):
useState,useReducer,useEffect/useLayoutEffectmit nicht-leeren Abhängigkeiten, asynchronescalculateMetadata, React-UI-Bibliotheken von Drittanbietern (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI). - Warnungen (übersetzen nach dem Entfernen des Konstrukts):
@remotion/lambda-Konfiguration,delayRender,useCallback,useMemo, benutzerdefinierte Hooks. - Info (übersetzen mit Hinweis):
staticFile,interpolateColors.
Wenn ein Blocker ausgelöst wird, stoppen Sie. Lesen Sie references/escape-hatch.md und geben Sie die Empfehlungsnachricht aus. Warnungen stoppen die Übersetzung nicht – entfernen Sie das anstößige Konstrukt in Schritt 3 und notieren Sie die Lücke in TRANSLATION_NOTES.md. @remotion/lambda-Konfiguration ist der kanonische Warnungsfall: der Skill entfernt den Import + die renderMediaOnLambda(...)-Aufrufe, übersetzt aber den Rest der Komposition.
Schritt 2: Planung der Übersetzung
Lesen Sie references/api-map.md – den Index jeder Remotion-API und ihrer HF-Entsprechung oder themenspezifischen Referenz. Identifizieren Sie, welche Themenreferenzen Sie basierend auf dem, was die Quelle verwendet, benötigen:
| Quelle enthält | Referenz laden |
|---|---|
Composition, defaultProps, schema, calculateMetadata | parameters.md |
Sequence, Series, Loop, AbsoluteFill, Freeze | sequencing.md |
useCurrentFrame, interpolate, spring, Easing, interpolateColors | timing.md |
Audio, Video, Img, IFrame, staticFile, delayRender | media.md |
TransitionSeries, @remotion/transitions | transitions.md |
@remotion/lottie | lottie.md |
@remotion/google-fonts/<Family>, Font.loadFont, @font-face | fonts.md |
Laden Sie nicht alle – laden Sie nur die, die die spezifische Quelle benötigt.
Durchsuchen Sie den Live-Katalog nach visuellen Effekten, die die Tabelle nicht abbildet. Wenn die Quelle einen Look mit keinem HF-API-Äquivalent malt – eine Scanline/CRT-Überlagerung, einen Glitch- oder chromatischen Aberrationsdurchlauf, einen Shader-Überblendung, eine Filmkorn-Behandlung – führen Sie npx hyperframes catalog --query "<der Effekt, auf Deutsch>" --json aus, bevor Sie es manuell in GSAP schreiben. Die Suche benötigt nichts installiert: kein Projekt, kein vorheriges add, kein Konto. Sie durchsucht das gesamte gehostete Register (~400 Blöcke und Komponenten) von jedem Verzeichnis aus, und transitions.md geht diesen Weg bereits für clockWipe() / iris() über npx hyperframes add sdf-iris. Eine echte Komponente ist näher an der Quelle als eine handgemachte Näherung, daher erhöht sie normalerweise den SSIM, anstatt ihn zu senken – aber der Render-Diff in Schritt 4 ist immer noch der Schiedsrichter. Schreiben Sie den Effekt manuell, wenn die Suche nichts Passendes zurückgibt, und notieren Sie die Ersetzung in TRANSLATION_NOTES.md.
Schritt 3: Generieren der HF-Komposition
Erzeugen Sie index.html mit:
- Wurzel
<div id="stage">mit derdata-composition-id,data-start="0",data-duration(in Sekunden),data-fps,data-width,data-heightder Komposition, plus einemdata-*pro skalarem Prop. - Ein Host
<div>pro Szene mitdata-composition-src="compositions/<scene>.html"unddata-start/data-duration/data-track-index. Die Wurzel enthält kein verschachteltes Layout. - Eine
compositions/<scene>.htmlpro Szene (eine<template>-Unterkomposition): ihr Inline<style>für das Layout (CSS setzt denfrom-Zustand jeder animierten Eigenschaft), ihr Markup und einegsap.timeline({paused: true})in der lokalen Zeit der Szene. Jede Ableitung vonuseCurrentFrame()wird zu einem Tween auf dieser Timeline am Offset innerhalb der Szene. window.__timelines["<scene-id>"] = tl;in jeder Szenendatei undwindow.__timelines["<composition-id>"]für die eigene (möglicherweise leere) Timeline der Wurzel.
Benutzerdefinierte React-Unterkomponenten werden als wiederholtes HTML unter Verwendung des Prop-Interfaces als Vorlage inline eingefügt (siehe parameters.md für das pro-Instanz data-*-Muster).
Schritt 4: Validierung
Führen Sie das Evaluierungs-Harness aus – references/eval.md für die vollständige Anleitung. Schneller Pfad:
# Remotion-Baseline rendern (nach npm install im Fixture)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4
# HF-Übersetzung rendern
cd ../hf-src && npx hyperframes render --skill=remotion-to-hyperframes --output ../hf.mp4
# SSIM-Diff
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff
Schwellenwert: ~0,02 unter p05 der Komplexitätsstufe der Quelle (siehe validierte Schwellenwerttabelle in eval.md). Wenn der Diff fehlschlägt, führen Sie scripts/frame_strip.sh aus, um zu sehen, welche Frames abweichen, und lesen Sie dann die entsprechende Timing-/Sequenzierungs-/Medienreferenz erneut.
Kritisch: Beide Renderings müssen dasselbe Pixelformat verwenden. Setzen Sie Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") in der remotion.config.ts der Remotion-Quelle – andernfalls misst der Diff Encoder-Unterschiede (~0,05 SSIM-Verlust), nicht die Übersetzungstreue.
Schritt 5: Lücken dokumentieren
Alles, was nicht sauber übersetzt wurde (fallengelassene Lautstärkerampen, angenäherte benutzerdefinierte Präsentationen, ersetzte Schriftarten) wird in einer TRANSLATION_NOTES.md neben der HF-Ausgabe dokumentiert. Siehe references/limitations.md für das Format.
Was dieser Skill explizit NICHT tut
- Übersetzen von React-Zustandsmaschinen. Kompositionen, die Animationen über
useState+useEffectsteuern, sind keine deterministischen Frame-Capture-Ziele im seek-gesteuerten Modell von HyperFrames. Empfehlen Sie das Laufzeit-Interop-Muster. - Ausführen der Remotion-Render-Pipeline neben HyperFrames. Das ist das Laufzeit-Interop-Muster aus PR #214 – eine separate Lösung für Kompositionen, die den Lint dieses Skills nicht bestehen.
(@remotion/lambda ist kein Blocker – Lambda-Konfiguration ist Bereitstellung, nicht Animation. Der Skill behandelt es als Warnung und übersetzt den Rest. Siehe references/escape-hatch.md.)
So bewerten Sie Ihre eigene Übersetzung
Führen Sie den Testkorpus-Orchestrator aus:
./assets/test-corpus/run.sh
Er führt T1, T2, T3 (Rendern + Diff) und T4 (Lint-Validierung) aus, gibt eine Bestehen/Nichtbestehen-Tabelle pro Stufe aus und erstellt einen aggregierten JSON-Bericht. Verwenden Sie dies, um zu überprüfen, ob der Skill auf einem sauberen Checkout End-to-End funktioniert – und als Regressionstest nach der Bearbeitung einer Referenz.
Validierte Baseline (Stand: 27.04.2026):
| Stufe | Form der Komposition | Mittlerer SSIM | Schwellenwert |
|---|---|---|---|
| T1 | Ein-Element-Einblendung | 0.974 | 0.95 |
| T2 | Mehrere Szenen + Spring + Audio + Bild | 0.985 | 0.95 |
| T3 | Datengesteuert, benutzerdefinierte Subkomponenten, Count-Up | 0.953 | 0.90 |
| T4 | Escape-Hatch (8 Lint-Fälle) | 8/8 bestanden | n/a |