Communitygithub.com

DigitalRavagers/Experiment

Portiere eine vorhandene Remotion (React)-Komposition nach HyperFrames HTML. Nur verwenden, wenn der Benutzer explizit darum bittet, eine Remotion-Quelle zu portieren/konvertieren/migrieren/übersetzen.

Was ist Experiment?

Diese Fähigkeit übersetzt vorhandene Remotion (React)-basierte Videokompositionen mechanisch in HyperFrames (HTML + GSAP)-Kompositionen. Etwa 80% typischer Remotion-Idiome haben direkte HyperFrames-Äquivalente, während die restlichen 20% (wie useState/useEffect, asynchrone calculateMetadata, Drittanbieter-React-Bibliotheken oder @remotion/lambda-Konfiguration) entweder blockiert oder mit Warnungen versehen werden. Die Übersetzung erfolgt in einem strukturierten Workflow: Linting der Quelle, Planung anhand einer API-Mapping-Referenz, Generierung einer flachen HTML-Struktur mit GSAP-Timelines und Validierung durch SSIM-basierte Diff-Tests gegen eine validierte Referenz (mit Schwellenwerten von 0,90–0,95 je nach Komplexitätstier). Die Fähigkeit unterstützt ausschließlich eine Richtung — Remotion → HyperFrames — und lehnt Anfragen für den umgekehrten Export oder nicht-Remotion-Quellen (After Effects, Framer Motion, reines React/CSS) ab, die stattdessen an den /general-video-Workflow verwiesen werden. Sie wird hauptsächlich mit Claude Code, Cursor und ähnlichen KI-Agenten-Plattformen verwendet, die über SKILL.md-Definitionen und ausführbare Skripte gesteuert werden.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Remotion zu HyperFrames

Bestätige den Weg, bevor du baust. Verwende dies nur, um eine vorhandene Remotion (React)-Kompositionsquelle nach HyperFrames zu portieren. Erstellung einer neuen Komposition (auch wenn sie von einem Remotion-Video inspiriert ist) → die Erstellungs-Workflows / /general-video. Nicht im Bereich (Einweg, nur Remotion): kein Rückwärtsexport (HyperFrames → Remotion oder irgendein Framework), und eine nicht-Remotion-Quelle (After Effects, Framer Motion, reines React/CSS) hat keine zu übersetzende Remotion-Quelle → neu erstellen über /general-video. Unsicher oder nur eine beiläufige Remotion-Erwähnung? Lies zuerst /hyperframes.

Übersicht

Übersetze 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. Diese Fähigkeit kodiert die Zuordnung und schützt vor den verlustbehafteten 20%, indem sie sich weigert, Muster zu übersetzen, die nicht in HFs seek-gesteuertes Modell passen, und stattdessen das Laufzeit-Interop-Muster aus PR #214 empfiehlt.

Die Fähigkeit wird mit einem gestaffelten Testkorpus (T1–T4, insgesamt 4 Fixtures) ausgeliefert, der Übersetzungen gegen gemessene SSIM-Schwellenwerte bewertet. Übersetze nicht, ohne die Auswertung laufen zu lassen — eine Übersetzung, die "richtig aussieht", aber 0,05 SSIM niedriger als die validierte Basislinie rendert, ist stillschweigend falsch.

Wann verwenden

Verwende diese Fähigkeit NUR, wenn der Benutzer explizit darum bittet, von Remotion zu migrieren. Beispiel-Trigger-Phrasen:

  • "portiere mein Remotion-Projekt zu HyperFrames"
  • "konvertiere diesen Remotion-Code zu HyperFrames"
  • "migriere von Remotion"
  • "übersetze diese Remotion-Komponente"
  • "schreibe dies als HyperFrames HTML um"

Verwende diese Fähigkeit NICHT, wenn:

  • (a) Der Benutzer eine neue HyperFrames-Komposition erstellt, selbst wenn sie ein ähnliches Remotion-Video haben oder A/B-testen.
  • (b) Der Benutzer Remotion beiläufig erwähnt, ohne eine Migration anzufordern.
  • (c) Der Benutzer Remotion-Code als Referenzmaterial teilt, anstatt um eine Übersetzung zu bitten.
  • (d) Der Benutzer nach "dem gleichen Video wie mein Remotion-Video" fragt, ohne explizit um eine Migration der Quelle zu bitten — behandle dies als einen neuen HyperFrames-Build.

NICHT UNTERSTÜTZT (ablehnen — das ist nicht, was diese Fähigkeit tut):

  • Die umgekehrte Richtung. Das Exportieren einer HyperFrames-Komposition zurück nach Remotion (oder in ein anderes Framework) ist kein Workflow — die Übersetzung ist nur Remotion → HyperFrames. Sage das klar.
  • Nicht-Remotion-Quellen. Ein After Effects-Projekt (.aep), eine Framer Motion / reines React / CSS-Animation oder eine andere Tool-Quelle ist keine Remotion-Komposition — es gibt keine zu übersetzende Remotion-Quelle. Erstelle sie nativ über /general-video neu oder lehne ab, wenn HyperFrames sie nicht darstellen kann.

Im Zweifelsfall erstelle stattdessen eine native HyperFrames-Komposition mit /general-video (dem allgemeinen HyperFrames-Erstellungs-Workflow).

Workflow

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 Dependencies, asynchrones calculateMetadata, React-UI-Bibliotheken von Drittanbietern (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Warnungen (übersetzen nach Entfernen des Konstrukts): @remotion/lambda-Konfiguration, delayRender, useCallback, useMemo, benutzerdefinierte Hooks.
  • Info (mit Hinweis übersetzen): staticFile, interpolateColors.

Wenn ein Blocker ausgelöst wird, stoppe. Lese references/escape-hatch.md und zeige die Empfehlungsnachricht an. Warnungen stoppen die Übersetzung nicht — entferne das problematische Konstrukt in Schritt 3 und notiere die Lücke in TRANSLATION_NOTES.md. @remotion/lambda-Konfiguration ist der kanonische Warnungsfall: Die Fähigkeit entfernt den Import + renderMediaOnLambda(...)-Aufrufe, übersetzt aber den Rest der Komposition.

Schritt 2: Planung der Übersetzung

Lese references/api-map.md — den Index jeder Remotion-API und ihres HF-Äquivalents oder themenspezifischen Referenz. Identifiziere, welche Themenreferenzen du basierend auf dem, was die Quelle verwendet, 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, was die spezifische Quelle benötigt.

Schritt 3: Generiere die HF-Komposition

Erzeuge index.html mit:

  • Root <div id="stage"> mit den data-composition-id, data-start="0", data-duration (in Sekunden), data-fps, data-width, data-height des Kompositions sowie einem data-* pro skalarer Eigenschaft.
  • Einer flachen 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.
  • Einem einzelnen <script>-Tag am Ende, das eine pausierte gsap.timeline({paused: true}) enthält. Jede useCurrentFrame()-Ableitung von Remotion wird zu einem Tween auf dieser Timeline zum richtigen Offset.
  • window.__timelines["<composition-id>"] = tl; registriert die Timeline bei der HF-Laufzeit.

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ühre das Eval-Harness aus — references/eval.md für die vollständige Anleitung. Schneller Pfad:

# Remotion-Basislinie 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 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-/Medienreferenz erneut.

Kritisch: Beide Renderings müssen ein übereinstimmendes Pixelformat verwenden. Setze Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") in der Remotion-Quelle remotion.config.ts — andernfalls 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ß (verworfene Lautstärkerampen, approximierte benutzerdefinierte Präsentationen, substituierte Schriftarten), erhält eine TRANSLATION_NOTES.md, die neben der HF-Ausgabe geschrieben wird. Siehe references/limitations.md für das Format.

Was diese Fähigkeit explizit NICHT tut

  • Übersetze React-Zustandsmaschinen. Kompositionen, die Animationen über useState + useEffect steuern, sind keine deterministischen Frame-Capture-Ziele in HFs seek-gesteuertem Modell. Empfehle das Laufzeit-Interop-Muster.
  • Führe die Remotion-Render-Pipeline neben HyperFrames aus. Das ist das Laufzeit-Interop-Muster aus PR #214 — eine separate Lösung für Kompositionen, die den Lint dieser Fähigkeit nicht bestehen.

(@remotion/lambda ist kein Blocker — Lambda-Konfiguration ist Deployment, nicht Animation. Die Fähigkeit 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

Dies führt T1, T2, T3 (Render + Diff) und T4 (Lint-Validierung) aus, gibt eine Tabelle mit Bestehen/Nichtbestehen pro Stufe aus und erzeugt einen aggregierten JSON-Bericht. Verwende dies, um zu überprüfen, ob die Fähigkeit auf einem sauberen Checkout durchgängig funktioniert — und als Regressionstest nach der Bearbeitung einer Referenz.

Validierte Basislinie (Stand 27.04.2026):

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

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

DigitalRavagers/Experiment

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Verwandte Skills