Communitygithub.com

Remotion zu HyperFrames

Übersetzt eine vorhandene Remotion (React-basierte) Videokomposition in eine HyperFrames HTML-Komposition. Nur verwenden, wenn der Benutzer explizit darum bittet, eine Remotion-Komposition zu portieren, zu konvertieren, zu migrieren, zu übersetzen oder als HyperFrames neu zu schreiben.

Was ist Remotion zu HyperFrames?

Dieses Skill führt eine mechanische Übersetzung von Remotion-Videokompositionen in HyperFrames (HTML + GSAP) durch, wobei es für etwa 80% typischer Kompositionen direkte Äquivalente liefert. Es erkennt nicht unterstützte Muster wie `useState`, `useEffect`-Seiteneffekte, asynchrones `calculateMetadata`, Bibliotheken Dritter und `@remotion/lambda` und empfiehlt stattdessen die Laufzeit-Interop-Lösung aus PR #214, um eine verlustbehaftete Übersetzung zu vermeiden. Der Skill umfasst einen abgestuften Testkorpus (T1–T4) mit validierten SSIM-Schwellenwerten, der die Übersetzungsqualität misst und Regressionen abfängt. Er wird bevorzugt, wenn der Benutzer explizit eine Migration von Remotion anfordert, und nicht bei neuen HyperFrames-Kompositionen oder beiläufigen Erwähnungen von Remotion.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/remotion-to-hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Remotion zu HyperFrames?

Überblick

Übersetzt Remotion (React-basierte) Videokompositionen in HyperFrames (HTML + GSAP)-Kompositionen. Die meisten Remotion-Idiome haben direkte HyperFrames-Äquivalente – die Übersetzung ist für ~80% typischer Kompositionen mechanisch. Dieses Skill kodiert die Zuordnung und schützt vor den verlustbehafteten 20%, indem es die Übersetzung von Mustern verweigert, die nicht in HFs suchbasiertes Modell passen, und stattdessen das Laufzeit-Interop-Muster aus PR #214 empfiehlt.

Das Skill wird mit einem abgestuften Testkorpus (T1–T4, 4 Fixtures insgesamt) ausgeliefert, der Übersetzungen anhand gemessener SSIM-Schwellenwerte bewertet. Übersetze nicht, ohne die Auswertung laufen zu lassen – eine Übersetzung, die „richtig aussieht“, aber 0,05 SSIM niedriger als die validierte Baseline liegt, ist stillschweigend falsch.

Wann verwenden

Verwende dieses Skill NUR, wenn der Benutzer explizit um eine Migration von Remotion bittet. Beispiel-Trigger-Phrasen:

  • „port my Remotion project to HyperFrames“
  • „convert this Remotion code to HyperFrames“
  • „migrate from Remotion“
  • „translate this Remotion comp“
  • „rewrite this as HyperFrames HTML“

Verwende dieses Skill NICHT, wenn:

  • (a) Der Benutzer eine neue HyperFrames-Komposition erstellt, selbst wenn er ein ähnliches Remotion-Video hat oder A/B-testet.
  • (b) Der Benutzer Remotion beiläufig erwähnt, ohne eine Migration zu fordern.
  • (c) Der Benutzer Remotion-Code als Referenzmaterial teilt, anstatt eine Übersetzung zu verlangen.
  • (d) Der Benutzer nach „dem gleichen Video wie mein Remotion-Eines“ fragt, ohne explizit um eine Migration des Quellcodes zu bitten – behandle dies als neue HyperFrames-Erstellung.

Im Zweifelsfall verwende stattdessen das hyperframes-Skill zum Erstellen einer nativen HyperFrames-Komposition.

Arbeitsablauf

Schritt 1: Lint der Quelle

Führe 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/useLayoutEffect mit nicht-leeren Abhängigkeiten, asynchrones calculateMetadata, React-UI-Bibliotheken von Drittanbietern (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Warnungen (nach Verwerfen des Konstrukts übersetzen): @remotion/lambda-Konfiguration, delayRender, useCallback, useMemo, benutzerdefinierte Hooks.
  • Info (mit Notiz übersetzen): staticFile, interpolateColors.

Wenn ein Blocker ausgelöst wird, stoppe. Lese references/escape-hatch.md und gib die Empfehlungsnachricht aus. Warnungen stoppen die Übersetzung nicht – verwerfe das störende Konstrukt in Schritt 3 und notiere die Lücke in TRANSLATION_NOTES.md. Die @remotion/lambda-Konfiguration ist der kanonische Warnfall: Das Skill verwirft den Import + renderMediaOnLambda(...)-Aufrufe, übersetzt aber den Rest der Komposition.

Schritt 2: Übersetzung planen

Lese references/api-map.md – das Verzeichnis jeder Remotion-API und ihres HF-Äquivalents oder themenspezifischen Referenz. Identifiziere, welche Themenreferenzen du basierend auf der Quelle benötigst:

Quelle enthältReferenz laden
Composition, defaultProps, schema, calculateMetadataparameters.md
Sequence, Series, Loop, AbsoluteFill, Freezesequencing.md
useCurrentFrame, interpolate, spring, Easing, interpolateColorstiming.md
Audio, Video, Img, IFrame, staticFile, delayRendermedia.md
TransitionSeries, @remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>, Font.loadFont, @font-facefonts.md

Lade nicht alle – lade nur das, was die spezifische Quelle benötigt.

Schritt 3: HF-Komposition generieren

Erzeuge index.html mit:

  • Wurzel-<div id="stage">, das die data-composition-id, data-start="0", data-duration (in Sekunden), data-fps, data-width, data-height der Komposition sowie ein data-*-Attribut pro skalarem Prop trägt.
  • Eine flache Liste von Szenen-divs mit data-start / data-duration / data-track-index.
  • Inline-<style> für Layout; CSS setzt den from-Zustand jeder animierten Eigenschaft.
  • Ein einzelnes <script>-Tag am Ende, das eine pausierte gsap.timeline({paused: true}) enthält. Jede Remotion-useCurrentFrame()-Ableitung wird zu einem Tween auf dieser Timeline am richtigen Offset.
  • window.__timelines["<composition-id>"] = tl; registriert die Timeline bei HFs Laufzeit.

Benutzerdefinierte React-Subkomponenten werden als wiederholtes HTML mit der Prop-Schnittstelle als Vorlage inline eingefügt (siehe parameters.md für das pro-Instanz data-*-Muster).

Schritt 4: Validieren

Führe die Auswertungsharness 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 --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 eval.mds Tabelle validierter Schwellenwerte). Wenn der Diff fehlschlägt, führe scripts/frame_strip.sh aus, um zu sehen, welche Frames abweichen, und lies dann die entsprechende Timing-/Sequencing-/Media-Referenz erneut.

Wichtig: Beide Renderings müssen dasselbe Pixelformat verwenden. Setze Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") in der Remotion-Quelle remotion.config.ts – sonst misst der Diff Encoder-Unterschiede (~0,05 SSIM-Einbuße), nicht die Übersetzungstreue.

Schritt 5: Lücken dokumentieren

Alles, was sich nicht sauber übersetzen ließ (fallengelassene Lautstärkerampen, angenäherte benutzerdefinierte Präsentationen, ersetzte Schriftarten), erhält eine TRANSLATION_NOTES.md, die neben der HF-Ausgabe geschrieben wird. Siehe references/limitations.md für das Format.

Was dieses Skill explizit NICHT tut

  • React-Zustandsmaschinen übersetzen. Kompositionen, die Animationen über useState + useEffect steuern, sind in HyperFrames' suchbasiertem Modell keine deterministischen Frame-Capture-Ziele. Empfehle das Laufzeit-Interop-Muster.
  • Remotions Render-Pipeline neben HyperFrames ausführen. Das ist das Laufzeit-Interop-Muster aus PR #214 – eine separate Lösung für Kompositionen, die das Lint dieses Skills nicht bestehen.

(@remotion/lambda ist kein Blocker – Lambda-Konfiguration betrifft Deployment, nicht Animation. Das Skill verwirft es als Warnung und übersetzt den Rest. Siehe references/escape-hatch.md.)

Wie du deine eigene Übersetzung bewerten kannst

Führe den Testkorpus-Orchestrator aus:

./assets/test-corpus/run.sh

Er führt T1, T2, T3 (Rendern + Diff) und T4 (Lint-Validierung) aus, gibt eine pro-Stufe Bestehen/Nichtbestehen-Tabelle aus und erzeugt einen aggregierten JSON-Bericht. Verwende dies, um zu überprüfen, ob das Skill bei einem sauberen Checkout Ende-zu-Ende funktioniert – und als Regressionstest nach Bearbeitung einer Referenz.

Validierte Baseline (Stand 2026-04-27):

StufeKompositionsformMittlerer SSIMSchwellenwert
T1Einzelelement-Einblendung0,9740,95
T2Mehrere Szenen + Spring + Audio + Bild0,9850,95
T3Datengetrieben, benutzerdefinierte Subkomponenten, Count-up0,9530,90
T4Escape-Hatch (8 Lint-Fälle)8/8 bestandenn/a

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Verwandte Skills