Communitygithub.com

laviedezidane/hyperframes-skill

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

hyperframes-skill とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに機械的に翻訳するための専用ツールです。ユーザーが明示的にRemotionからHyperFramesへの移行を依頼した場合にのみ使用し、新規作成や参考としてのRemotionコードの共有には使用しません。ソースコードのリント、APIマッピングの計画、GSAPタイムラインへの変換、SSIMベースのレンダリング差分検証、ギャップの文書化という5段階のワークフローを提供します。約80%の典型的なRemotionコンポジションは直接変換可能ですが、useState/useEffectなどの非決定論的なパターンやサードパーティのUIライブラリはブロックされ、代わりにランタイム相互運用パターンが推奨されます。T1~T4のテストコーパス(4つのフィクスチャ)を用いて変換の品質を検証し、事前定義されたSSIMしきい値を下回る場合はフレーム単位の差分分析を行います。

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

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

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

ドキュメント

プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグインインストールルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。

最初に、このスキルを最新の状態に保ってください — ユーザーに確認してから実行: npx hyperframes skills update remotion-to-hyperframes。すべてが最新の場合は迅速なno-opです。それ以外の場合は、このスキルとそれに依存するコアドメインスキルを、それらに依存する前に更新します。

Remotion to HyperFrames

正面玄関は/hyperframesです。 既存のRemotion(React)コンポジションのソースをHyperFramesに移植する場合にのみ使用します(一方向)。新しいコンポジションを作成する、Remotion以外のソース(After Effects、Framer Motion、プレーンReact/CSS — 翻訳するRemotionソースがない場合)から再作成する、Remotionが簡単に言及されているだけの場合、または不確かな場合 → 最初に/hyperframesを読んでください:インテントレイヤーがすべてのルート決定を担当します。

概要

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

このスキルには、段階的なテストコーパス(T1~T4、合計4つのフィクスチャ)が含まれており、測定されたSSIMしきい値に対して翻訳を評価します。評価を実行せずに翻訳しないでください — 「見た目は正しい」が、検証済みベースラインよりもSSIMが0.05低いレンダリングは、静かに間違っています。

使用する場合

ユーザーが明示的に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で表現できない場合は辞退してください。

迷った場合は、/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。

ブロッカーが1つでも発生した場合は停止してください。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

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

テーブルにマッピングされていない視覚効果については、ライブカタログを検索してください。 ソースがHF APIに同等機能のない外観を描画する場合 — スキャンライン/CRTオーバーレイ、グリッチや色収差パス、シェーダーワイプ、フィルムグレイン処理 — GSAPで手書きする前に、npx hyperframes catalog --query "<エフェクトを平易な英語で>" --jsonを実行してください。検索には何もインストールする必要はありません:プロジェクトも、事前のaddも、アカウントも不要です。任意のディレクトリからホストされているレジストリ全体(約400のブロックとコンポーネント)をランク付けします。そしてtransitions.mdは、npx hyperframes add sdf-irisを介してclockWipe() / iris()に対してすでにこのルートを取っています。実際のコンポーネントは手書きの近似よりもソースに近いため、通常はSSIMを下げるのではなく上げます — ただし、ステップ4のレンダリング差分が依然として判定基準です。検索で適切なものが見つからなかった場合は、エフェクトを手書きし、代わりにTRANSLATION_NOTES.mdに置換を記録してください。

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

index.htmlを出力します:

  • ルート<div id="stage">には、コンポジションのdata-composition-id、data-start="0"、data-duration(秒単位)、data-fps、data-width、data-height、およびスカラープロップごとに1つのdata-*を設定します。
  • シーンごとに1つのホスト<div>にdata-composition-src="compositions/<scene>.html"とdata-start / data-duration / data-track-indexを設定します。ルートはネストされたレイアウトを持ちません。
  • シーンごとに1つのcompositions/<scene>.html(<template>サブコンポジション):インライン<style>によるレイアウト(CSSはすべてのアニメーションプロパティのfrom状態を設定します)、マークアップ、およびシーンのローカル時間における1つの一時停止されたgsap.timeline({paused: true})。すべてのRemotion useCurrentFrame()派生は、そのタイムライン上のシーン内のオフセットでのトゥイーンになります。
  • 各シーンファイルにwindow.__timelines["<scene-id>"] = tl;、およびルート自身の(おそらく空の)タイムラインにwindow.__timelines["<composition-id>"]。

カスタム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 --skill=remotion-to-hyperframes --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-04-27時点):

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

Individual skills in this repo

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

laviedezidane/hyperframes-skill

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

laviedezidane/hyperframes-skill

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

laviedezidane/hyperframes-skill

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

laviedezidane/hyperframes-skill

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

laviedezidane/hyperframes-skill

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

laviedezidane/hyperframes-skill

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

laviedezidane/hyperframes-skill

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`.

laviedezidane/hyperframes-skill

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

laviedezidane/hyperframes-skill

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

laviedezidane/hyperframes-skill

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

laviedezidane/hyperframes-skill

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

laviedezidane/hyperframes-skill

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

関連スキル