Communitygithub.com

claude-video-motion

HyperFrames を使った決定論的動画生成スキル — HTML/CSS コンポジションを Chrome/FFmpeg でキャプチャし、MP4/WebM/MOV/PNG として出力。フォーマット、解像度、FPS、長さを明示的に指定し、レンダリングはユーザー承認制です。

claude-video-motion とは?

このスキルは、HyperFrames エンジンを使った決定論的動画生成に特化しています。HTML/CSS でコンポジションを記述し、Chrome でレンダリング、FFmpeg でエンコードすることで、MP4、WebM、MOV、PNG などのメディアファイルを出力します。 **主な特長:** - **決定論的出力**:同一環境、同一コード、同一アセットから常に同一バイト列を生成。バージョンロック(Chrome、FFmpeg、HyperFrames、フォント、アセット、コーデック、フラグ)が前提です。 - **フォーマット・解像度・FPS・長さは必須指定**:デフォルト値はありません。ユーザーが明示的に指定する必要があります(例:Reels/TikTok/Shorts 向け縦 1080×1920 30fps)。 - **レンダリングはユーザー承認制**:レンダリングには実時間とリソースがかかるため、クロームや FFmpeg の依存確認を含め、事前にユーザーの承認を得る必要があります。 - **アセット管理**:音楽・効果音はユーザー承認の上でダウンロードし、ライセンスを記録。ナレーションはテキストのみ生成し、ユーザーが外部サービス(ElevenLabs など)で生成したファイルを提供します。 **非適用例:** - ウェブサイト内で使う動画(ヒーロー、背景、証言など) - インタラクティブなアニメーションUI **対応プラットフォーム:**Claude Code、ディレクトリベースのスキル構成(SKILL.md をエントリーポイントとし、参照ファイル群と連携)。依存関係(Node、Chrome、FFmpeg、hyperframes パッケージ)はユーザー環境にインストールされている必要があります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/octaviosilva2/claude-video-motion/tree/HEAD/skill/frontend-video

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

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

ドキュメント

ゲート — すべてのコンポジションの前に

リテラルトリガー:成果物はレンダリングされたメディアファイルである。 MP4、WebM、MOV、PNG。 成果物のフォーマットであり、見た目ではない。

このスキルは以下の場合には有効にしない:

  • ウェブサイト内で使用する動画 — ヒーロー、背景、証言など。通常のウェブアセット。
  • 「動画のように見える」が操作可能なアニメーションUI — これは通常のフロントエンドウェブ。

区別は成果物のフォーマットにあります。結果がブラウザで開き、クリックに応答するものであれば、このスキルの対象ではありません。

フォーマット、解像度、FPS、長さにはデフォルトがない

これら4つにはいずれもデフォルト値がありません。「1080p 30fps が一般的だから」と選ぶことは、まさにゲートが防止しようとしていることです。4つすべてをユーザーに問い合わせてからコンポジションを開始してください(AskUserQuestion を使用)。その際、成果物の用途に合わせた推奨を提示します(例:Reels/TikTok/Shorts 向けは縦 1080×1920)。

運用コスト — 着手前に確認する

HyperFrames は インポートではありません:これはプロダクションプロセスです。Node、Chrome、FFmpeg がインストールされている必要があり、キャプチャは負荷が高いです。

ルートを約束する 前に、インフラが存在することを確認してください。レンダリング時に FFmpeg が見つからないということは、コンポジション全体を書き終えた後に判明することを意味します。

依存関係のインストール(Node、FFmpeg、Chrome、hyperframes パッケージ)はユーザーの判断に委ねられます。 不足しているものとそのインストールコマンドを明示し、ユーザーの承認を待ってください。

レンダリングは決して自動化しない

レンダリングの実行は、ユーザーからの明示的な承認なしには行われません。 レンダリングはマシン時間を消費し、メディア生成が伴う場合は実際の費用が発生します。

アセットが不足し、代替案として生成する場合:不足しているものと生成するものを明示し、そこで止まってください。

使用方法

frontend-video/
├── SKILL.md                ← このファイル。常に読まれる唯一のファイル
└── referencias/
    ├── hyperframes.md      ゲート、フォーマット/FPS/長さ、決定論的時間、
    │                       アダプター、キャプション、レンダリング承認
    ├── direcao-visual.md   根拠のあるトークン、汎用防止、分解されたリファレンス
    ├── assets.md           出典、ライセンス、最適化 — ここではアセットが成果物
    └── validacao.md        メディアに適用可能なゲート
あなたのタスク参照先
フォーマット、解像度、FPS、長さの決定hyperframes.md §3
コンテンツ、フォント、キャプション、権利hyperframes.md §4
決定論的時間、再現可能な出力、シーンアダプターhyperframes.md §5
アクセシビリティとパフォーマンスhyperframes.md §6
レンダリングの承認hyperframes.md §7
コンポジションの美的方向性direcao-visual.md
画像、フォント、音楽、効果音、ナレーションのライセンスassets.md
成果物の確定validacao.md

常に無視するもの: SEO、インデックス可能なDOM、ナビゲーションのジャーニー、アプリケーションの状態 — 決定論的メディアにはこれらのいずれも存在しません。ランタイムウェブを最終成果物とすることも該当しません:ここではブラウザはキャプチャツールであり、宛先ではありません。

音楽、効果音、ナレーション

  • 音楽と効果音: ユーザーの承認を得てからダウンロードしてください。ファイルごとに。 ライセンスが意図された用途(商用の場合はその旨)を許可している必要があります。各トラックの出典、作者、ライセンスを記録してください。詳細は assets.md を参照。
  • ナレーション: このスキルは音声を生成しません。ナレーションのテキストを短いブロックで書き、ユーザーが自分の音声サービス(例:ElevenLabs)で生成し、ファイルを提供するよう依頼してください。音声の生成には費用がかかります:ブロックを明示し、そこで止まってください。

再現性 — 「決定論的」が実際に要求するもの

エンジンは時間でコンポジションを検索可能にします。これだけでは同一出力は保証されません。

バイト単位で再現可能なファイルを約束するには、以下のすべてを固定する必要があります:HyperFrames、Chrome、FFmpeg、フォント、アセット、コーデックとフラグ、解像度、FPS、長さ、環境。このロックなしに同じコミットであっても、約束を許可しません。

監査済みのソース:リポジトリ heygen-com/hyperframes、コミット af1cb1c10da33bade100db8233435c7591b7c0bc、そのコミットでのメインパッケージ 0.8.17、ルートと CLI で Apache-2.0 ライセンス。2026-08-28 確認。このリポジトリの exemplo-p01/ は 0.8.166 でレンダリングされ、package.json でバージョンが固定されています。あなたのプロジェクトでもバージョンを固定し、コンポジションがシートでカバーされていない機能に依存する場合は再監査してください。

常に有効なルール

  1. 実際のコンテンツ、決して架空のものではない — 最終的なように見えるプレースホルダーは禁止。
  2. キャプションとコントラスト は成果物の一部であり、追加オプションではない。
  3. 検証は実際の出力に対して行う、プレビューではない。プレビューが表示する内容と最終ファイルが含む内容は、コーデック、色、タイミングが異なる。
  4. 自作のシーンコードは、自身の後片付けに責任を持つ。 コンポジション内の Three/WebGL シーンは、他の場所と同様にティアダウンが必要。

関連スキル