Communitygithub.com

Remotion → HyperFrames 変換スキル

既存のRemotion(Reactベース)動画コンポジションをHyperFrames(HTML + GSAP)コンポジションに翻訳します。ユーザーが明示的にRemotionからHyperFramesへの移行を依頼した場合のみ使用してください。

Remotion → HyperFrames 変換スキル とは?

このスキルは、Remotionで作成された動画コンポジションをHyperFrames(HTML + GSAP)形式に機械的に翻訳するためのツールです。Remotionの一般的なイディオムの約80%は直接的なHyperFramesの同等機能にマッピング可能ですが、残りの20%はシーク駆動モデルに適合しないため、適切なエスケープハッチ(ランタイム相互運用パターン)を推奨します。スキルはT1〜T4の4つのテストフィクスチャを含み、SSIM(構造的類似度)閾値に基づいて翻訳品質を評価します。翻訳は「lint→計画→生成→検証→ギャップ文書化」の5ステップで実行され、useStateやuseEffectなどのReactステート管理パターン、非同期calculateMetadata、サードパーティReactコンポーネントライブラリなどのブロッカーを検出した場合は翻訳を拒否し、相互運用パターンを推奨します。RemotionとHyperFramesの両方でピクセルフォーマットを統一しないと、エンコーダの違いにより最大0.05 SSIMの低下が生じるため、注意が必要です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-skills/tree/HEAD/remotion-to-hyperframes

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

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

ドキュメント

Remotion → HyperFrames 変換スキル は何をしますか?

概要

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

このスキルには階層化テストコーパス(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スキルを使用してネイティブなHyperFramesコンポジションを作成することをデフォルトにしてください。

ワークフロー

ステップ1: ソースのLint

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

  • ブロッカー(翻訳拒否 + 相互運用を推奨): 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

すべてを一度に読み込まず、特定のソースに必要なものだけを読み込んでください。

ステップ3: HFコンポジションの生成

index.htmlを出力します:

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

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

ステップ4: 検証

evalハーネスを実行します — 完全なガイドは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のランタイム相互運用パターンです — このスキルのLintに失敗するコンポジションのための別のソリューションです。

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

自身の翻訳を採点する方法

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

./assets/test-corpus/run.sh

T1, T2, T3(レンダリング+差分)とT4(Lint検証)を実行し、階層ごとの合格/不合格テーブルを表示し、集計JSONレポートを出力します。これを利用して、クリーンチェックアウトでのスキルのエンドツーエンド動作を確認し、リファレンスを編集した後の回帰チェックとしても使用します。

検証済みベースライン(2026-04-27時点):

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

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.

関連スキル