Communitygithub.com

Remotion nach HyperFrames

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

Was ist Remotion nach HyperFrames?

Dieses Skill ermöglicht die mechanische Übersetzung von Remotion-Videokompositionen (React) in HyperFrames (HTML + GSAP) und deckt etwa 80% typischer Kompositionen ab. Es erkennt gängige Remotion-Idiome und bildet sie auf HFs suchlaufgesteuerte Timeline ab, wobei es Muster erkennt, die nicht sauber übersetzbar sind – wie useState/useEffect-Seiteneffekte, async calculateMetadata, Drittanbieter-React-Komponentenbibliotheken oder `@remotion/lambda` – und stattdessen zur Laufzeit-Interop-Escape-Luke rät. Der Skill wird mit einem gestaffelten Testkorpus (T1–T4) validiert, der Übersetzungen anhand gemessener SSIM-Schwellenwerte bewertet. Er setzt eine strikte Policy ein, wann er aktiviert werden darf – nur bei explizitem Migrationswunsch; andernfalls wird der native `hyperframes`-Skill empfohlen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-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 nach HyperFrames?

Übersicht

Übersetze Remotion (React-basierte) Videokompositionen in HyperFrames (HTML + GSAP)-Kompositionen. Die meisten Remotion-Idiome haben direkte Entsprechungen in HyperFrames – die Übersetzung ist für ~80% typischer Kompositionen mechanisch. Dieses Skill kodiert die Zuordnung und schützt vor den verlustbehafteten 20%, indem es sich weigert, Muster zu übersetzen, die nicht in HFs suchlaufgesteuertes Modell passen, und stattdessen das Runtime-Interop-Muster aus PR #214 empfiehlt.

Das Skill wird mit einem gestaffelten Testkorpus (T1–T4, 4 Testfälle gesamt) ausgeliefert, der Übersetzungen anhand gemessener SSIM-Schwellenwerte bewertet. Nicht übersetzen, ohne die Auswertung durchzuführen — eine Übersetzung, die „gut aussieht“ aber 0,05 SSIM unter der validierten Basislinie liegt, ist stillschweigend falsch.

Wann verwenden

Verwende dieses Skill NUR, wenn der Benutzer explizit darum bittet, von Remotion zu migrieren. Beispielauslöser:

  • „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“

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 verlangen.
  • (c) Der Benutzer Remotion-Code als Referenzmaterial teilt, anstatt eine Übersetzung zu verlangen.
  • (d) Der Benutzer nach „demselben Video wie mein Remotion-Video“ fragt, ohne explizit um eine Migration der Quelle zu bitten – behandle dies als eine neue HyperFrames-Komposition.

Bei Zweifeln standardmäßig das native hyperframes-Skill zum Erstellen einer HyperFrames-Komposition verwenden.

Arbeitsablauf

Schritt 1: Lint der Quelle

Führe scripts/lint_source.py über das Remotion-Quellverzeichnis aus. Der Lint erkennt Muster, die sich nicht sauber übersetzen lassen:

  • Blocker (ablehnen + Interop empfehlen): useState, useReducer, useEffect/useLayoutEffect mit nicht-leeren Abhängigkeiten, async calculateMetadata, Drittanbieter-React-UI-Bibliotheken (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Warnungen (übersetzen nach Verwerfen des Konstrukts): @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 Warnungsfall: Das Skill verwirft den Import + die Aufrufe von renderMediaOnLambda(...), übersetzt aber den Rest der Komposition.

Schritt 2: Plane die Übersetzung

Lese references/api-map.md – das Verzeichnis jeder Remotion-API und ihrer HF-Entsprechung oder themenspezifischen Referenz. Identifiziere, welche Themenreferenzen du basierend auf dem, was die Quelle verwendet, benötigst:

Quelle enthältLade Referenz
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, was die spezifische Quelle benötigt.

Schritt 3: Erzeuge die HF-Komposition

Erzeuge index.html mit:

  • Einem Wurzel-Element <div id="stage">, das die data-composition-id, data-start="0", data-duration (in Sekunden), data-fps, data-width, data-height sowie ein data-* pro skalarem Prop trägt.
  • Einer flachen Liste von Szenen-<div>s mit data-start / data-duration / data-track-index.
  • Inline <style> für das Layout; CSS setzt den from-Zustand jeder animierten Eigenschaft.
  • Einem einzelnen <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 der HF-Laufzeitumgebung.

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

Schritt 4: Validieren

Führe das Evaluierungs-Harness aus – references/eval.md für die vollständige Anleitung. Schneller Pfad:

# Rendere die Remotion-Basislinie (nach npm install im Testfall)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# Rendere die HF-Übersetzung
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 die validierten Schwellenwerttabelle in eval.md). Wenn der Diff fehlschlägt, führe scripts/frame_strip.sh aus, um zu sehen, welche Frames abgewichen sind, und lies dann die entsprechende Timing-/Sequenzierungs-/Medien-Referenz erneut.

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

Schritt 5: Lücken dokumentieren

Alles, das nicht sauber übersetzt werden konnte (verworfene Lautstärke-Rampen, 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

  • Übersetze keine React-Zustandsmaschinen. Kompositionen, die Animationen über useState + useEffect steuern, sind in HyperFrames' suchlaufgesteuertem Modell keine deterministischen Frame-Capture-Ziele. Empfehle das Runtime-Interop-Muster.
  • Führe Remotions Rendering-Pipeline nicht neben HyperFrames aus. Das ist das Runtime-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 Deployment, nicht Animation. Das Skill verwirft es als Warnung und übersetzt den Rest. Siehe references/escape-hatch.md.)

Wie du deine eigene Übersetzung bewertest

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 Bestanden/Nicht-Bestanden-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 der Bearbeitung einer Referenz.

Validierte Basislinie (Stand 2026-04-27):

StufeForm der KompositionMittlerer SSIMSchwellenwert
T1Einzelelement-Fade-in0,9740,95
T2Mehrere Szenen + Spring + Audio + Bild0,9850,95
T3Datengesteuert, benutzerdefinierte Unterkomp.0,9530,90
T4Escape-Luke (8 Lint-Fälle)8/8 bestandenn.v.

Individual skills in this repo

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

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Verwandte Skills