Communitygithub.com

sherlock-126/video_ai

これはHyperFramesのエントリースキルです。動画、アニメーション、モーショングラフィックなどの作成・編集・レンダリングリクエストはすべてここから始めてください。適切なワークフローにルーティングします。

video_ai とは?

このスキル(sherlock-126/video_ai)は、HyperFramesエコシステムにおけるエントリーポイントとして機能します。ユーザーが動画やアニメーションに関連するリクエスト(例:「動画を作って」「アニメーションを」「モーショングラフィックを」など)を行った場合、まずこのスキルが読み込まれ、リクエストの意図と入力タイプに基づいて適切な下位ワークフロー(/product-launch-video, /faceless-explainer, /website-to-video, /pr-to-video, /embedded-captions, /graphic-overlays, /motion-graphics, /general-video, /remotion-to-hyperframes)へルーティングします。また、各HyperFramesドメインスキル(/hyperframes-core, /hyperframes-animation, /hyperframes-creative, /hyperframes-media, /hyperframes-cli, /hyperframes-registry)への機能マップも提供し、ユーザーが目的に応じて適切なスキルを選択できるようにします。さらに、HyperFramesのアーキテクチャ上の制約(決定論的レンダリング、既存動画へのオーバーレイのみ、Remotionからの一方向インポート、入力として存在しないものは生成不可)を明確に定義し、スコープ外のリクエストを早期に特定して適切に処理します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントで利用可能であり、プロジェクトにCLAUDE.mdやAGENTS.mdがない場合でも、動画制作ワークフローを確実に開始するために最初に読むべきドキュメントとして設計されています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sherlock-126/video_ai/tree/HEAD/skills/hyperframes

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

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

ドキュメント

HyperFrames — 最初に読んでください

HyperFramesタスクはすべてここから始めてください — 特にプロジェクトエージェント設定(CLAUDE.md / AGENTS.md / .cursorrules)がない場合。以下に機能マップと動画ルーターがあります。

機能マップ — どのスキルがどの意図に対応するか

やりたいこと…参照先
動画を作る(URL、概要、トピック、GitHub PR、既存映像、アニメーション化する単一要素から)下記の動画ルーター(§ 動画ルーティング)
HTMLコンポジションを作成・編集する — data-* 契約、クリップ、トラック、サブコンポジション、変数/hyperframes-core
アニメーション — アトミックモーションルール、シーンブループリント、トランジション、ランタイムアダプター(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
クリエイティブディレクション — design.md、パレット、タイポグラフィ、ナレーション、ビート計画、オーディオリアクティブ/hyperframes-creative
メディア前処理 — TTS音声、BGM、文字起こし、背景除去、キャプション/hyperframes-media
CLI開発ループ — init、lint、validate、inspect、preview、render、publish、doctor/hyperframes-cli
レジストリブロック/コンポーネントのインストール(hyperframes add)/hyperframes-registry

コンポジションのオーサリング契約(各時間指定要素には data-start / data-duration / data-track-index が必要、時間指定要素には class="clip" が必要、GSAPタイムラインは一時停止され window.__timelines に登録される、決定論的ロジックのみ — Date.now() / Math.random() / ネットワーク不可)はここには重複しません — /hyperframes-core にあります。コンポジションHTMLを書く前にそれを読んでください。

HyperFramesができないこと — 先にこれを確認してください

HyperFramesはHTMLコンポジションを作成し、コードからMP4にレンダリングします。このモデルには厳しい外縁があります。これらの縁を超えるリクエストはルーティングの選択肢ではなく、スコープ外です。そのため、ワークフローに進もうとする代わりに、断る(または適切なツールを指す)必要があります。これらはアーキテクチャに起因するものであり、個々のリクエストから決まるものではありません:

  • レンダリングは決定論的で自己完結しています。 すべての値、アセット、テキストはオーサリング時に焼き付けられます。レンダリング時にはネットワーク呼び出しやライブデータ取得は行いません(基本ルール: Date.now() / Math.random() / ネットワーク不可)。「レンダリング時に数値をライブ更新する」は対象外です — データはオーサリング時に一度取得して焼き付けるか、断ってください。
  • 既存動画にはオーバーレイのみ、編集はしません。 HyperFramesはソースクリップの上にフレームを合成します — /embedded-captions はキャプション層を追加し、/graphic-overlays はデザインされたグラフィックカード(ローワーサード、データコールアウト、タイトル)を追加します — クリップはそのまま下で再生されますが、エンコードされたビデオストリームを後処理することはありません。映像自体(タイミング、色、フレーミング、順序、オーディオ)を変更することはNLEスタイルの編集であり、スコープ外です。
  • Remotionのインポートは一方向です。 /remotion-to-hyperframes は_Remotionフレームワーク_のソースをHyperFramesに変換します。逆方向(HyperFrames → Remotion、または他のフレームワークへ)はありません(スコープ外)。また、非RemotionのReact/Webアニメーションソースには変換すべきRemotionソースがありません — /general-video で再作成してください。
  • 持っていない入力は生成できません。 画面/セッション録画、カメラキャプチャ、AIトーキングヘッド/リップシンクアバター生成はできません。映像やアセットがまだ存在しない場合、HyperFramesはそれを生成できません — ユーザーに提供を依頼するか(または適切なキャプチャツールを使用して)ください。

それ以外 — URL、概要、トピック、PR、注釈付き映像、またはアニメーション化する単一要素からの動画 — はすべてスコープ内です。以下でルーティングしてください。


動画ルーティング

このセクションは最上位のワークフローのみを認識します。ワークフロー内部のフェーズ、ドメインスキル(hyperframes-* — 上記の機能マップ参照)、または技術リファレンスは読み込みません。

決定表

入力タイプ(意図)が主軸です。出力長さは上限であり、ゲートではありません。 一致する入力に対して、特化ワークフローは 約3分まで を処理します — どのワークフローに入るかは、意図(入力タイプ、テキストの場合は主題)によって決まり、長さではありません。長さが意味を持つのは上限のみです: 本当に長い作品(3〜5分のチュートリアル、5分以上の深掘り)は別のレジスタであり、/general-video にルーティングされます。約3分以内の帯域内では、3番目の軸が2つのテキスト駆動ワークフローを分割します — 主題: マーケティング対象の製品 対 説明対象のトピック(下記ステップ3の曖昧性解消ルール参照)。

長さ / 入力製品ローンチ(URL / 概要 / スクリプト)一般ウェブサイト / URLGitHub PR / コード変更トピック / 記事 / メモ(製品なし、URLなし)既存動画(トーキングヘッド)†
約3分以内/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3〜5分チュートリアル/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5分以上深掘り/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
静止画 / ループ/general-video/general-video/general-video/general-video/general-video

現在のカバレッジ: 約3分以内の帯域には、製品ローンチ / 一般ウェブサイト / GitHub PR / トピック 入力向けの専用ワークフローがあります(URLは_種類_で分割され、次に_意図_で分割 — ステップ3参照)。また、既存動画列は任意の長さでカバーされています — /embedded-captions(キャプション/字幕)または /graphic-overlays(デザインされたグラフィックオーバーレイ)により、意図で分割されます(ステップ2参照)。他のすべてのセルは /general-video — 汎用HTMLコンポジションオーサリングフロー(入力・長さ非依存): 約3分を超えるすべて(3〜5分 / 5分以上の行)およびすべての静止画 / ループ形式。ルーターは作成可能な動画で行き止まりになることはありません。唯一の本当の「一般/該当なし」の回答は、HyperFrames自体の範囲外のリクエスト(例: 完成動画ファイルのNLEスタイル編集 — 再タイミング、再着色、再フレーミング、並べ替え、オーディオ編集)です。

† 既存映像は意図で分割され、長さでは分割されません。 キャプション/字幕 → /embedded-captions; デザインされたグラフィックオーバーレイ/パッケージング — ローワーサード、データコールアウト、タイトルカード、プルクオート → /graphic-overlays。どちらもクリップにオーバーレイし、クリップはそのまま下で再生されます。どちらも映像自体を編集しません。

ジャンルショートカット(表に優先)。短い(約10秒未満)、ナレーションなし、デザイン主導のモーショングラフィック — キネティックタイポグラフィ、統計/チャートヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャページハイライト — は入力に関係なく /motion-graphics にルーティングされます。これは出力ジャンルであり、入力タイプではないため、依頼が明らかにモーション優先でナレーションがない場合(ステップ2参照)、上記の入力タイプ表よりも優先されます。長い、またはナレーション付きの処理は入力タイプでルーティングされるか、/general-video になります。

既存コンポジションの移行(特殊ケース)

上記の表は入力から動画を作成するためのものです。これとは別に1つのワークフローがあります: ユーザーが明示的に既存の Remotion (React) コンポジション をHyperFramesに移植/変換/移行するよう依頼した場合 → /remotion-to-hyperframes。これはソース変換であり、入力からの作成ではないため、入力×長さのセルはありません。明示的な移行言語(「Remotionプロジェクトを移植して」「このRemotionコンポを変換して」「これをHyperFramesに書き直して」)がある場合のみここにルーティングしてください — Remotionへの軽い言及はトリガーではありません。デフォルトでは作成表または /hyperframes-core にルーティングします。

ルーティング手順

  1. 入力タイプ + 目標長さを決定します。 ルーティングでは動画が何についてか — その主題と入力を知る必要があります。主題自体が未指定の場合(例: URL、名前付き製品、トピック、または作業対象アセットなしで「私たちのものについて動画を作って」)、または入力タイプが不明な場合は、どのワークフローに入る前に質問してください — まず明確にし、ワークフロースキルを呼び出してから質問しないでください。ワークフローにコミットすること自体がルーティングの決定だからです。最大2つの明確化質問をしてください:
    • 「入力は何ですか? — 製品(URLまたは概要)、一般ウェブサイト/URL、GitHub PR/コード変更、説明するトピックや記事、またはキャプションを追加する既存のトーキングヘッド動画?」
    • 「目標の長さは? — 約3分以下、またはそれ以上(3〜5分のチュートリアル / 5分以上の深掘り)?」
    • 仕様のデフォルト — 述べる、質問しない(これらはルートに影響しないため、ルーティングをブロックしないでください): アスペクト比 16:9(エンジンは9:16縦長もサポート — ユーザーがTikTok/Reels/Shortsなどの縦長配信先を指定した場合のみ切り替え)、ナレーション/キャプション言語 = ユーザーの言語。ユーザーが異議を唱えた場合のみ確認してください。選択されたワークフローはステップ0で独自の詳細を再確認します。
  2. 最初に入力タイプ(意図)で選択します。長さは上限であり、ゲートではありません。
    • 短いデザイン主導のモーショングラフィック(ジャンルショートカット、入力表に優先) — モーション自体がメッセージ: キネティックタイポグラフィ、統計/数字カウントアップ、チャートヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャページハイライト。通常約10秒未満、ナレーション/音声なし → /motion-graphics。これは出力ジャンルであり、入力タイプではない — 依頼が明らかにクイックでナレーションなしのデザイン主導モーションピースである場合、入力に関係なくここにルーティングします。同じ素材のより長い、またはナレーション付きの処理はこれではありません(入力タイプでルーティングするか、/general-video)。
    • 既存のトーキングヘッド動画(ユーザーがクリップを持っており、それに何かを追加したい) → 意図で分割、任意の長さ(入力タイプが長さに勝つ): キャプション/字幕(話し言葉を読みやすいテキストとして) → /embedded-captions; デザインされたグラフィックオーバーレイ — ローワーサード、データコールアウト、タイトル情報カード、プルクオート、グラフィックパッケージ編集 → /graphic-overlays。(映像_自体_の編集 — 再タイミング、再着色、再フレーミング、並べ替え、オーディオ — はNLEスタイルでありスコープ外; § HyperFramesができないこと を参照。)
    • GitHub PR / コード変更(github.com/<owner>/<repo>/pull/<N> リンク、owner/repo#N 参照、または「このPR」) → /pr-to-video(約3分まで)。
    • それ以外(製品URL / 概要 / トピックテキスト): 意図がステップ3でワークフローを選択し、約3分まで を処理します — 短い15〜30秒のプロモーションと約100秒の説明動画はどちらも意図でルーティングされ、長さではルーティングされません。目標が明らかに約3分より長い場合(3〜5分のチュートリアル、5分以上の深掘り)のみ /general-video(長さ非依存のフォールバック — ステップ4参照)にルーティングします。本当に長い作品を強制的に約3分以内のワークフローに入れないでください — 意図が帯域内で決定し、/general-video が残りをカバーします。
  3. 約3分以内のURL / テキスト入力の曖昧性を解消します(意図分割)。 2つの分割:
    • URLの種類 + 意図 — URLはもはや自動的にPLVになりません。_種類_が最初に決定し、次に_意図_が決定します: GitHub PR リンク(.../pull/<N>、owner/repo#N、「このPR」) → /pr-to-video; それ以外のウェブサイトURLは意図で分割 — 特定の製品やSaaSのマーケティング/ローンチ/プロモーション → /product-launch-video; 一般サイト → 動画(サイトツアー、ポートフォリオ/ブログ/ランディングページのショーケース、サイトのビジュアルからのソーシャルクリップ、または単に「このサイトを動画にしたい」) → /website-to-video。両方ともヘッドレスChromeでクロールします。PR URLは gh で読み取ります。サイトURLが製品ローンチか一般サイト動画かが本当に不明確な場合、1つの質問をしてください。
    • 製品 vs トピック(テキスト、URLなし) — 決定的な質問は動画が何についてかであり、入力形式ではありません:
      • 特定の製品/企業/SaaS/アプリ/ウェブサイトがマーケティング、ローンチ、またはプロモーションされている → /product-launch-video。
      • コンセプト/トピック/記事/仕組みが説明されており、製品もURLもない → /faceless-explainer。
      • タイブレーカー: 「プロモート/ローンチ/販売/私たちの製品」という表現 → PLV。「説明/教える/どう動くか / Xとは何か」で製品なし → faceless。facelessの出荷スタイルは常に pin-and-paper。
      • URLが貼られていなくても、名前付きサイトはPLVです。 製品やそのウェブサイトに言及するスクリプト(「私たちのサイトはacme.ioです」「<ブランド>をプロモートして」)は、クリック可能なリンクがなくてもPLVにルーティングされます — PLVはサイトをウェブ検索し、ブランドアセットをクロールできます(ユーザーがオプトアウトしない限り → キャプチャなしプリセットモード)。URLを貼らなかったからといって、それがfaceless/キャプチャなしの仕事になるわけではありません。提供されたスクリプトに対する逐語対再構成の選択はPLV内部のものであり、ルートを変更することはありません。
      • 矛盾する手がかり → 推測せず質問してください。 提供されたソースが製品の自社マーケティング(そのランディングページ、_自社プラットフォーム_に関するプロモーションブログ)であるにもかかわらず、ユーザーが明示的にプロモーションを削除するよう依頼した場合 — 基礎にあるコンセプトの_中立的な_説明であり、広告ではない — それを本当に曖昧として扱います(動画は…

関連スキル