Communitygithub.com

samyakiasonline-ctrl/hyperframe

既存のRemotion(React)コンポジションのソースをHyperFrames HTMLに移植します。RemotionからHyperFramesへの明示的な移植・変換・移行の要請がある場合のみ使用します。

hyperframe とは?

このスキルは、Remotion(Reactベース)のビデオコンポジションをHyperFrames(HTML + GSAP)のコンポジションに翻訳するためのものです。Remotionのほとんどのイディオムには直接対応するHyperFramesの同等機能があり、一般的なコンポジションの約80%は機械的に翻訳可能です。このスキルは、HFのシーク駆動モデルに適合しないパターンを拒否することで、残りの20%の品質低下を防ぎます。サポートされるプラットフォームはClaude Code、Cursor、CodexなどのAIエージェントで、Remotion→HyperFramesの一方向のみの変換をサポートします。ワークフローは5つのステップで構成されています。ソースのリント、翻訳計画の策定、HFコンポジションの生成、レンダリング差分の検証、そしてギャップの文書化です。スキルはT1~T4の階層化されたテストコーパス(合計4つのフィクスチャ)を搭載しており、測定されたSSIMしきい値に対して翻訳を評価します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/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のシーク駆動モデルに適合しないパターンを翻訳を拒否することで品質低下の20%を防ぎ、代わりにPR #214のランタイム相互運用パターンを推奨します。

このスキルは、階層化されたテストコーパス(T1~T4、合計4つのフィクスチャ)を搭載しており、測定されたSSIMしきい値に対して翻訳を評価します。evalを実行せずに翻訳しないでください — 「見た目は正しい」が検証済みベースラインより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で表現できない場合は辞退してください。

迷ったら/hyperframesに戻ってください。インテントレイヤーがルートを選択します。

ワークフロー

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

Remotionソースディレクトリに対してscripts/lint_source.pyを実行します。リントはクリーンに翻訳できないパターンを検出します:

  • ブロッカー(拒否 + 相互運用を推奨): useState、useReducer、空でないdepsを持つ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

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

テーブルにマッピングされていない視覚効果については、ライブカタログを検索してください。 ソースがHF APIに同等機能のないルックを描画する場合 — スキャンライン/CRTオーバーレイ、グリッチや色収差パス、シェーダーワイプ、フィルムグレイン処理 — GSAPで手書きする前に npx hyperframes catalog --query "<効果を平易な英語で>" --json を実行してください。検索には何もインストールする必要はありません:プロジェクトも、事前のaddも、アカウントも不要です。任意のディレクトリからホストされた全レジストリ(約400ブロックとコンポーネント)をランク付けします。transitions.mdはすでにこのルートをclockWipe()/iris()に対してnpx hyperframes add sdf-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のシーク駆動モデルにおける決定論的なフレームキャプチャターゲットではありません。ランタイム相互運用パターンを推奨します。
  • HyperFramesと並行してRemotionのレンダリングパイプラインを実行しません。 それは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マルチシーン + スプリング + オーディオ + 画像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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in 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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

関連スキル