Communitygithub.com

DigitalRavagers/Experiment

既存のRemotion(React)コンポジションのソースをHyperFrames(HTML + GSAP)に変換します。ユーザーが明示的にRemotionソースの移植・変換・移行を依頼した場合にのみ使用してください。

Experiment とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに機械的に変換するためのものです。RemotionのAPI(useCurrentFrame、Sequence、Spring、Audioなど)とHyperFramesの等価なパターン(タイムラインクロノロジー、GSAPトゥイーン、HTML要素)のマッピングをエンコードしており、典型的なコンポジションの約80%を忠実に変換できます。変換の価値提案は、Remotionの複雑な依存関係(Node.js、React、バンドラー)を排除し、静的なHTMLファイルとして埋め込みや配信を容易にすることです。このスキルは、useStateやuseEffect、async calculateMetadata、サードパーティのReact UIライブラリ、@remotion/lambdaなど、HyperFramesのシーク駆動モデルに適合しないパターンを検出するlintソーススクリプトを提供し、ブロッカーが検出された場合は実行時の相互運用パターンを推奨します。変換は一方向(Remotion→HyperFramesのみ)であり、逆向きのエクスポートやAfter Effects、Framer Motionなどの非Remotionソースはサポートされていません。スキルにはT1~T4の階層化テストコーパスが含まれており、変換の品質をSSIM(構造的類似性)スコアで検証できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

RemotionからHyperFramesへ

構築する前にルートを確認してください。 これは、既存のRemotion(React)コンポジションのソースをHyperFramesに移植する場合にのみ使用してください。新しいコンポジション(Remotionビデオに触発されたものであっても)を作成する場合は、作成ワークフロー//general-videoを使用してください。対象外(一方向、Remotionのみ):逆向きのエクスポート(HyperFrames→Remotionやその他のフレームワーク)はなく、非Remotionソース(After Effects、Framer Motion、プレーンなReact/CSS)には変換するRemotionソースがないため、/general-videoで再作成してください。不明な場合、またはRemotionが簡単に言及されているだけですか?最初に/hyperframesを読んでください。

概要

Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに変換します。ほとんどのRemotionイディオムには直接的なHyperFramesの同等物があります。変換は典型的なコンポジションの約80%で機械的に行われます。このスキルはマッピングをエンコードし、損失の多い20%をガードするために、HFのシーク駆動モデルに適合しないパターンの変換を拒否し、代わりにPR #214の実行時相互運用パターンを推奨します。

このスキルには、測定されたSSIMしきい値に対して変換を評価する階層化テストコーパス(T1~T4、合計4つのフィクスチャ)が付属しています。評価を実行せずに変換しないでください。「見た目が正しい」変換でも、検証済みのベースラインより0.05低いSSIMでレンダリングされる場合は、暗黙のうちに間違っています。

使用するタイミング

このスキルは、ユーザーが明示的にRemotionからの移行を依頼した場合にのみ使用してください。 トリガーフレーズの例:

  • 「RemotionプロジェクトをHyperFramesに移植して」
  • 「このRemotionコードをHyperFramesに変換して」
  • 「Remotionから移行して」
  • 「このRemotionコンポを翻訳して」
  • 「これをHyperFrames HTMLとして書き直して」

次の場合はこのスキルを使用しないでください。

  • (a) ユーザーが新しいHyperFramesコンポジションを作成している場合(類似のRemotionビデオを持っている場合やA/Bテストしている場合でも)。
  • (b) ユーザーが移行を依頼せずに、Remotionについて簡単に言及しているだけの場合。
  • (c) ユーザーが参考資料としてRemotionコードを共有しているだけで、変換を依頼していない場合。
  • (d) ユーザーが「Remotionのと同じビデオ」を依頼しているが、ソースの移行を明示的に依頼していない場合 — 新しいHyperFramesビルドとして扱います。

サポート外(拒否 — これはこのスキルの機能ではありません):

  • 逆方向。 HyperFramesコンポジションをRemotion(またはその他のフレームワーク)にエクスポートすることはワークフローではありません。変換はRemotion→HyperFramesのみです。その旨を明確に伝えてください。
  • 非Remotionソース。 After Effectsプロジェクト(.aep)、Framer Motion / プレーンReact / CSSアニメーション、またはその他のツールのソースはRemotionコンポジションではありません — 変換するRemotionソースがありません。/general-videoでネイティブに再作成するか、HyperFramesで表現できない場合は拒否してください。

疑わしい場合は、代わりに/general-video(一般的なHyperFrames作成フロー)を使用してネイティブのHyperFramesコンポジションを作成することをデフォルトにしてください。

ワークフロー

ステップ 1: ソースをリントする

Remotionソースディレクトリ上でscripts/lint_source.pyを実行します。リントは、クリーンに変換できないパターンを検出します。

  • ブロッカー(拒否 + 相互運用を推奨):useState、useReducer、空でない依存関係を持つuseEffect/useLayoutEffect、非同期calculateMetadata、サードパーティのReact UIライブラリ(MUI、Chakra、Mantine、antd、shadcn、Radix、NextUI)。
  • 警告(構造を削除して変換):@remotion/lambda設定、delayRender、useCallback、useMemo、カスタムフック。
  • 情報(メモ付きで変換):staticFile、interpolateColors。

いずれかのブロッカーが発生した場合、停止してください。references/escape-hatch.mdを読み、推奨メッセージを表示してください。警告は変換を停止しません — ステップ3で問題のある構造を削除し、TRANSLATION_NOTES.mdにギャップを記録してください。@remotion/lambda設定は標準的な警告ケースです。スキルはインポートとrenderMediaOnLambda(...)呼び出しを削除しますが、コンポジションの残りの部分は変換します。

ステップ 2: 変換を計画する

references/api-map.mdを読んでください。これは、すべてのRemotion APIとそのHF同等物、またはトピックごとのリファレンスの索引です。ソースで使用されているものに基づいて、必要なトピックリファレンスを特定してください。

ソースに含まれるものロードするリファレンス
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

すべてをロードしないでください。特定のソースに必要なものだけをロードしてください。

ステップ 3: HFコンポジションを生成する

index.htmlを次の内容で出力します。

  • コンポジションのdata-composition-id、data-start="0"、data-duration(秒単位)、data-fps、data-width、data-height、およびスカラープロップごとに1つのdata-*を持つルート<div id="stage">。
  • data-start / data-duration / data-track-indexを持つシーンdivのフラットリスト。
  • レイアウト用のインライン<style>。CSSは、アニメーション化されたすべてのプロパティのfrom状態を設定します。
  • 一番下の単一の<script>タグ。これには、一時停止された1つのgsap.timeline({paused: true})が含まれています。すべてのRemotion useCurrentFrame()派生は、適切なオフセットでこのタイムライン上のトゥイーンになります。
  • window.__timelines["<composition-id>"] = tl; は、タイムラインをHFのランタイムに登録します。

カスタムReactサブコンポーネントは、プロップインターフェースをテンプレートとして使用して、繰り返しHTMLとしてインライン化します(インスタンスごとのdata-*パターンについてはparameters.mdを参照)。

ステップ 4: 検証する

評価ハーネスを実行します — references/eval.mdに完全なガイドがあります。クイックパス:

# Remotionベースラインをレンダリング(フィクスチャでnpm installした後)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# HF変換をレンダリング
cd ../hf-src && npx hyperframes render --output ../hf.mp4

# SSIM差分
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff

しきい値:ソースの複雑さティアのp05より約0.02低い値(eval.mdの検証済みしきい値テーブルを参照)。差分に失敗した場合は、scripts/frame_strip.shを実行して、どのフレームが乖離したかを確認し、関連するタイミング/シーケンス/メディアリファレンスを読み直してください。

重要:両方のレンダリングは、一致するピクセル形式を使用する必要があります。Remotionソースのremotion.config.tsでConfig.setVideoImageFormat("png") + Config.setColorSpace("bt709")を設定してください。そうしないと、差分は変換の忠実性ではなく、エンコーダーの違い(約0.05 SSIM低下)を測定することになります。

ステップ 5: ギャップを文書化する

クリーンに変換されなかったもの(音量ランプの削除、近似されたカスタムプレゼンテーション、置き換えられたフォント)は、HF出力の横にTRANSLATION_NOTES.mdとして書き込まれます。形式についてはreferences/limitations.mdを参照してください。

このスキルが明示的に行わないこと

  • Reactステートマシンの変換。 useState + useEffectを介してアニメーションを駆動するコンポジションは、HyperFramesのシーク駆動モデルにおける決定論的なフレームキャプチャターゲットではありません。実行時相互運用パターンを推奨します。
  • RemotionのレンダリングパイプラインをHyperFramesと一緒に実行すること。 それはPR #214の実行時相互運用パターンです — このスキルのリントに失敗するコンポジションのための別のソリューションです。

(@remotion/lambdaはブロッカーではありません。Lambda設定はデプロイメントであり、アニメーションではありません。スキルはそれを警告として削除し、残りの部分を変換します。references/escape-hatch.mdを参照。)

自分の変換を評価する方法

テストコーパスオーケストレーターを実行します:

./assets/test-corpus/run.sh

T1、T2、T3(レンダリング + 差分)とT4(リント検証)を実行し、ティアごとの合格/不合格テーブルを出力し、集約JSONレポートを出力します。これを使用して、クリーンなチェックアウトでスキルがエンドツーエンドで動作していることを確認し、リファレンスを編集した後のリグレッションチェックとして使用します。

検証済みベースライン(2026年4月27日時点):

ティアコンポジション形状平均SSIMしきい値
T1単一要素のフェードイン0.9740.95
T2マルチシーン + スプリング + オーディオ + 画像0.9850.95
T3データ駆動、カスタムサブコンポーネント、カウントアップ0.9530.90
T4エスケープハッチ(8つのリントケース)8/8合格n/a

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.

関連スキル