Communitygithub.com

bobzhou-source/Parsifal-Demo

HyperFrames を使用して HTML、CSS、JavaScript のコンポジションから AI 動画を作成し、検証と MP4 へのレンダリングを行います。短いビデオイントロ、シネマティックトレーラー、プロモーション動画、字幕アニメーション、HUD/テクノロジービジュアル、Web 動画変換、モーショングラフィックスに最適です。

Parsifal-Demo とは?

このスキルは、デベロッパーが HTML、CSS、JavaScript を使ってプログラム的に動画を生成できる強力なツール、HyperFrames の使用を支援します。ビデオ制作のプロセスを、短いプロダクションブリーフの作成から始め、デフォルトのアスペクト比やフレームレートを設定し、`npx hyperframes init` でプロジェクトを初期化し、HTML コンポジションをコーディングします。主なワークフローは、`npx hyperframes lint` でレイアウトを検証し、`npx hyperframes inspect` でタイムスタンプを確認し、`npx hyperframes render` で最終的な MP4 をレンダリングします。このスキルは、ソーシャルメディア向けの縦型動画、製品プロモーション、HUD 風のテクノロジービジュアル、字幕アニメーションなど、反復的な開発環境を必要とするプロジェクトに特に有用です。GSAP タイムラインや `data-*` 属性を使って正確なタイミングとコンポジションを管理し、動画がレンダリングされ、検証されるまで完了しないため、従来の動画編集ツールでは難しい精度と制御が可能になります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bobzhou-source/Parsifal-Demo/tree/HEAD/packages/skills/hyperframes

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

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

ドキュメント

HyperFrames

このスキルは、ユーザーが Parsifal に対して HyperFrames を使用した動画作成を依頼した場合に使用します。例えば、30秒の縦型動画、短いイントロ、シネマティックなマイクロトレーラー、製品プロモーション、アニメーションキャプション、HUDスタイルのテクノロジービジュアル、Web サイトから動画への変換、または HTML/CSS/JS のモーショングラフィックスレンダリングなどが該当します。

HyperFrames は HTML を動画のソースオブトゥルースとして扱います。ビデオシーンを HTML コンポジションとして CSS レイアウトと JavaScript アニメーションで構築し、レイアウトを検証した上で、結果を MP4 にレンダリングします。

セットアップ

HyperFrames がインストールされていない、または公式スキルがない場合は、まずインストールします:

parsifal skills install official/creative/hyperframes

プロジェクト操作には npx hyperframes を使用します。HyperFrames には Node.js と FFmpeg が必要です。レンダリングまたはプレビューが失敗した場合は、以下を実行します:

npx hyperframes doctor

ワークフロー

  1. ユーザーのリクエストを短いプロダクションブリーフに変換します: 長さ、アスペクト比、ターゲットプラットフォーム、言語、スタイル、音楽やナレーションの必要性、最終的な出力パス。
  2. 不完全なブリーフの場合は、妥当なデフォルト値を設定します。縦型ショートビデオには 1080x1920、横型ビデオには 1920x1080、30 fps、MP4 出力を使用します。
  3. HyperFrames プロジェクトを作成するか、再利用します:
npx hyperframes init my-video --non-interactive
  1. コンポジションを HTML/CSS/JS で記述します。アニメーションを追加する前に、静的なヒーローフレームのレイアウトを正しくします。
  2. レンダリング前に検証します:
npx hyperframes lint
npx hyperframes inspect --samples 15
  1. 必要に応じてプレビューします:
npx hyperframes preview
  1. 最終的な動画をレンダリングします:
npx hyperframes render --output final.mp4 --quality standard

高速な反復には --quality draft を、ユーザーが洗練された出力を求める場合の最終納品には --quality high を使用します。

コンポジションルール

  • data-composition-id、data-width、data-height を持つルート要素を使用します。
  • タイムドクリップには data-start、data-duration、data-track-index を使用します。
  • GSAP タイムラインを同期的に window.__timelines に登録します。
  • CSS を最終レイアウト状態として使用し、その状態からアニメーションを開始または終了します。
  • メディアの再生は HyperFrames ランタイムに任せます。play()、pause()、またはメディアのシークを手動で呼び出さないでください。
  • シード付きジェネレーターを使用しない限り、Math.random() や Date.now() などの非決定的なアニメーションロジックは避けてください。
  • 無限リピートは使用しないでください。コンポジションの長さから有限のリピート回数を計算してください。
  • 検査したすべてのタイムスタンプで、テキスト、キャプション、UI パネル、HUD 要素がフレーム内に収まっていることを確認してください。

納品

完了したら、ユーザーに以下を伝えます:

  • レンダリングされた MP4 のパス;
  • プレビューサーバーが実行中の場合はプレビュー URL;
  • 長さ、アスペクト比、スタイル、ナレーション、音楽について行った前提;
  • 未解決の検証問題。

HTML を書いただけでは終了しないでください。HyperFrames のタスクは、lint と inspect でコンポジションがチェックされ、MP4 にレンダリングされた後にのみ完了します。ただし、ユーザーが明示的にソースファイルのみを要求した場合は除きます。

関連スキル