Communitygithub.com

Remotion → HyperFrames 変換

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

Remotion → HyperFrames 変換 とは?

このスキルは、Remotion で作成された動画コンポジションを、HyperFrames の HTML+GSAP ベースのコンポジションに機械的に変換するためのものです。約80%の典型的なコンポジションは直接変換可能ですが、useState や useEffect の副作用、非同期 calculateMetadata、サードパーティ製 React コンポーネントライブラリ、@remotion/lambda など、HyperFrames のシーク駆動モデルに適合しないパターン(損失が大きい20%)を検出し、変換を拒否してランタイム相互運用パターンを推奨します。変換ワークフローは5段階で構成され、ソースのリント、変換計画の立案、HF コンポジションの生成、SSIM 閾値による評価検証、変換ギャップの文書化を含みます。スキルには T1~T4 の階層化されたテストコーパスが付属し、検証済みベースラインとの SSIM 差が閾値を超えた場合、どのフレームで差が生じたかを特定するためのスクリプトも提供されます。このスキルは主に Claude Code や Codex などの AI エージェント上で動作するよう設計されており、Remotion から HyperFrames への移行を明示的に求めるユーザーリクエストにのみ応答します。

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

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

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

ドキュメント

Remotion → HyperFrames

概要

Remotion(React ベース)の動画コンポジションを HyperFrames(HTML + GSAP)のコンポジションに変換します。ほとんどの Remotion イディオムには直接対応する HyperFrames の同等機能があり、典型的なコンポジションの約80%は機械的に変換可能です。このスキルはそのマッピングをコード化するとともに、損失が大きい20%のパターンについては変換を拒否し、代わりに PR #214 のランタイム相互運用パターンを推奨することで対応します。

このスキルには 階層化テストコーパス(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 スキルを使用してネイティブの 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

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

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

index.html を出力します:

  • ルート `<div id=

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-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/agent-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/agent-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/agent-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/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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/agent-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/agent-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/agent-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/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-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/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-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/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

関連スキル