Communitygithub.com

libz-renlab-ai/TeamBrain

HyperFrames HTMLを使用して、動画コンポジション、アニメーション、タイトルカード、オーバーレイ、キャプション、ナレーション、オーディオリアクティブビジュアル、シーントランジションを作成します。

TeamBrain とは?

このスキルは、HyperFramesフレームワークを使用した動画制作のための包括的なワークフローを提供します。ユーザーの意図を理解し、デザインシステムを確立し、プロンプトを拡張してから実際のHTMLコンポジションを作成するという段階的なプロセスに従います。`design.md`からブランドカラーやフォントを読み込み、GSAPを使用したアニメーション、`data-*`属性によるタイミング制御、`data-composition-src`によるサブコンポジションのロードをサポートします。主な機能には、レイアウトをアニメーションより優先する「Layout Before Animation」アプローチ、決定論的なアニメーションのためのシード付きPRNGの使用、シーン間のクロスフェードやワイプなどのトランジションが含まれます。このスキルは、プロダクトローンチビデオ、ソーシャルメディア広告、タイトルカード、アニメーション付きキャプション、オーディオビートに同期したリアクティブビジュアルなど、幅広い動画制作タスクに適しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/hyperframes

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

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

プレビュー

スキル README より

ドキュメント

HyperFrames

HTMLが動画の唯一の情報源です。コンポジションは、タイミング用のdata-*属性、アニメーション用のGSAPタイムライン、そして外観用のCSSを持つHTMLファイルです。フレームワークがクリップの表示、メディア再生、タイムライン同期を処理します。

アプローチ

探索(探索的リクエストのみ)

方向性が決まっていないオープンエンドなリクエスト(「製品ローンチ動画を作って」「ブランド用に何か作って」)に対しては、色を選ぶ前に意図を理解します。

  • オーディエンス — 誰が見るのか? 開発者? 役員? 一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャル(15秒)、ウェブサイトのヒーロー、製品デモ、内部用?
  • 優先順位 — 最も重要なのは何か? モーションの品質? コンテンツの正確さ? ブランドの忠実性? スピード?
  • バリエーション — ユーザーは選択肢を望んでいるのか、それとも単一の最善のものを望んでいるのか?

具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、探索をスキップします。

探索的リクエストの場合は、単なる色の変更ではなく、異なるペーシング、エネルギーレベル、または構造的アプローチにおいて意味のある2〜3のバリエーションを提供することを検討します。1つは安全/予想通り、もう1つは野心的なものです。これを必須とせず、適切な場合に利用できるツールとして提供します。

ステップ1: デザインシステム

プロジェクトにdesign.mdまたはDESIGN.mdが存在する場合は、最初にそれを読み取ります(両方の大文字小文字を確認します。Linuxでは別のファイルです)。ブランドカラー、フォント、制約に関する唯一の情報源です。その正確な値を使用します(色を発明したり、フォントを代用したりしないでください)。任意の形式で問題ありません(YAMLフロントマター、散文、テーブル — 値を抽出するだけです)。

ローカルで見つからないフォント(fonts/ディレクトリに.woff2ファイルがない、組み込みフォントでない)が指定されている場合は、HTMLを記述する前にユーザーに警告します。「design.mdで[フォント名]が指定されていますが、フォントファイルが見つかりません。fonts/に.woff2ファイルを追加するか、最も近い組み込みの代替フォントにフォールバックします。」

design.mdが存在しない場合は、ユーザーに選択肢を提供します。

  1. ユーザーがスタイルやムードを指定した場合? → visual-styles.mdを読み、8つの名前付きプリセットから最も近いものを選びます。
  2. 視覚的にオプションを閲覧したい場合? → デザインピッカーを実行します。references/design-picker.mdを読み、完全なワークフローを確認します。これにより、ビジュアルピッカーページが提供されます。ユーザーはブラウザでムード、パレット、タイポグラフィ、モーションを設定し、生成されたdesign.mdをコピーして会話に貼り付けます。
  3. スキップして早く進みたい場合? → ムード、ライト/ダーク、ブランドカラー/フォントを尋ねます。次に、house-style.mdからパレットを選びます。

design.mdはブランドを定義します。動画コンポジションのルールは定義しません。 それらはreferences/video-composition.mdとhouse-style.mdから来ます。ブランドカラーは、ウェブUIの不透明度ではなく、動画に適したスケールで使用します。

ステップ2: プロンプト拡張

すべてのコンポジション(単一シーンの作品と些細な編集を除く)に対して常に実行します。このステップは、ユーザーの意図をdesign.mdとhouse-style.mdに基づいて具体化し、すべてのダウンストリームエージェントが同じように読み取る一貫した中間出力を生成します。

完全なプロセスと出力形式については、references/prompt-expansion.mdを参照してください。

ステップ3: 計画

HTMLを記述する前に、高レベルで考えます。

  1. 何を — 視聴者は何を体験すべきか? 物語の弧、重要な瞬間、感情的なビートを特定します。
  2. 構造 — いくつのコンポジション? どれがサブコンポジションでどれがインラインか? どのトラックが何を運ぶか(ビデオ、オーディオ、オーバーレイ、キャプション)。
  3. リズム — 実装する前にシーンのリズムを宣言します。どのシーンがクイックヒットで、どれがホールドか、どこにシェーダーが配置され、どこでエネルギーがピークになるか。パターンに名前を付けます:fast-fast-SLOW-fast-SHADER-hold。references/beat-direction.mdを読み、リズムテンプレートを確認します。
  4. タイミング — どのクリップが期間を決定するか? トランジションはどこに配置されるか? ペーシングは?
  5. レイアウト — まず最終状態を構築します。以下の「アニメーションより先にレイアウト」を参照してください。
  6. アニメーション — 次に、以下のルールを使用してモーションを追加します。

依頼されたものを構築します。 「タイトルカード」のリクエストは、「タイトルカード+3つの補助シーン+背景音楽+キャプション」のリクエストではありません。すべてのシーン、すべての要素、すべてのトゥイーンは、その存在意義を獲得する必要があります。追加のシーンや要素が作品を真に向上させる場合は、それらを提案しますが、追加はしません。

小さな編集(色の修正、タイミングの調整、1つの要素の追加)の場合は、ルールに直接進みます。

アニメーションより先にレイアウト

すべての要素を、最も可視性の高い瞬間(完全に入場し、正しく配置され、まだ退場していないフレーム)に配置すべき場所に配置します。これを最初に静的なHTML+CSSとして記述します。GSAPはまだ使用しません。

これが重要な理由: 要素をアニメーションの開始状態(画面外、スケール0、不透明度0)に配置し、そこからランディングすべき位置にトゥイーンすると、最終的なレイアウトを推測していることになります。重なりは動画がレンダリングされるまで見えません。最終状態を最初に構築することで、モーションを追加する前にレイアウトの問題を確認して修正できます。

プロセス

  1. 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に表示される瞬間。これが構築するレイアウトです。
  2. そのフレームの静的なCSSを記述します。.scene-contentコンテナは、width: 100%; height: 100%; padding: Npx; と display: flex; flex-direction: column; gap: Npx; box-sizing: border-box を使用して、シーン全体を埋める必要があります。パディングを使用してコンテンツを内側に押し込みます — コンテンツコンテナに position: absolute; top: Npx を決して使用しないでください。絶対配置されたコンテンツコンテナは、コンテンツが残りのスペースよりも高い場合にオーバーフローします。position: absolute は装飾要素のみに予約します。
  3. gsap.from() で入場を追加します — 画面外/非表示からCSSの位置へアニメーションします。CSSの位置が真実であり、トゥイーンはそこに到達するための経路を記述します。(data-composition-srcを介してロードされたサブコンポジションでは、gsap.fromTo() を優先します — references/motion-principles.mdの耐荷重GSAPルールを参照してください。)
  4. gsap.to() で退場を追加します — CSSの位置から画面外/非表示へアニメーションします。

例

/* scene-contentがシーンを埋め、パディングがコンテンツを配置 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* コンテナは任意のシーンサイズ (1920x1080, 1080x1920など) に適合します。
   パディングがコンテンツを配置します。Flex + gapがスペーシングを処理します。 */

間違い — ハードコードされた寸法と絶対配置:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// ステップ 3: それらの位置にアニメーションで入場
 tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
 tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
 tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

 // ステップ 4: それらの位置からアニメーションで退場
 tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
 tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
 tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

要素が時間的に空間を共有する場合

あるエリアで要素Aが退場してから要素Bが入場する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置を持つ必要があります。タイムラインの順序によって、それらが視覚的に共存することは決してないことが保証されます — ただし、レイアウトステップをスキップすると、タイミングエラーによって誤って重なるケースを見逃すことになります。

意図的な重なりと見なされるもの

レイヤー効果(テキストの後ろのグロー、シャドウ要素、背景パターン)やzスタックデザイン(カードスタック、深度レイヤー)は意図的なものです。レイアウトステップは、意図しない重なり(2つの見出しが互いの上に重なる、統計がラベルを覆う、コンテンツがフレームからはみ出す)を捉えるためのものです。

データ属性

すべてのクリップ

属性必須値
idはい一意の識別子
data-startはい秒数またはクリップID参照("el-1"、"intro + 2")
data-durationimg/div/コンポジションには必須秒数。ビデオ/オーディオはメディアの長さがデフォルト。
data-track-indexはい整数。同じトラックのクリップは重複できません。
data-media-startいいえソースへのトリムオフセット(秒)
data-volumeいいえ0-1(デフォルト1)

data-track-index は視覚的なレイヤリングに影響しません — CSS z-index を使用してください。

コンポジションクリップ

属性必須値
data-composition-idはい一意のコンポジションID
data-startはい開始時間(ルートコンポジション:"0"を使用)
data-durationはいGSAPタイムラインの長さより優先
data-width / data-heightはいピクセル寸法(1920x1080 または 1080x1920)
data-composition-srcいいえ外部HTMLファイルへのパス

コンポジション構造

data-composition-src を介してロードされたサブコンポジションは、<template> ラッパーを使用します。スタンドアロンコンポジション(メインのindex.html)は <template> を使用しません — data-composition-id のdivを直接 <body> に配置します。スタンドアロンファイルに <template> を使用すると、すべてのコンテンツがブラウザから隠され、レンダリングが壊れます。

サブコンポジションの構造:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- コンテンツ -->
    <style>
      [data-composition-id="my-comp"] {
        /* スコープ付きスタイル */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // トゥイーン...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

ルートでロード:<div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

ビデオとオーディオ

ビデオは muted playsinline でなければなりません。オーディオは常に別の <audio> 要素です:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

タイムライン契約

  • すべてのタイムラインは { paused: true } で開始されます — プレーヤーが再生を制御します
  • すべてのタイムラインを登録します:window.__timelines["<composition-id>"] = tl
  • フレームワークはサブタイムラインを自動的にネストします — 手動で追加しないでください
  • 期間は data-duration から取得され、GSAPタイムラインの長さからは取得されません
  • 期間を設定するために空のトゥイーンを作成しないでください

ルール(譲歩不可)

決定論的: Math.random()、Date.now()、または時間ベースのロジックは使用しないでください。擬似ランダム値が必要な場合は、シード付きPRNG(例:mulberry32)を使用してください。

GSAP: 視覚的なプロパティ(opacity、x、y、scale、rotation、color、backgroundColor、borderRadius、transform)のみをアニメーションします。visibility、display をアニメーションしたり、video.play() / audio.play() を呼び出したりしないでください。

アニメーションの競合: 複数のタイムラインから同じ要素の同じプロパティを同時にアニメーションしないでください。

repeat: -1 禁止: 無限リピートのタイムラインはキャプチャエンジンを壊します。コンポジションの期間から正確なリピート数を計算します:repeat: Math.ceil(duration / cycleDuration) - 1。

同期タイムライン構築: async / await、setTimeout、またはPromise内でタイムラインを構築しないでください。キャプチャエンジンは、ページロード後に window.__timelines を同期的に読み取ります。フォントはコンパイラによって埋め込まれるため、すぐに利用可能です — フォントのロードを待つ必要はありません。

絶対にしてはいけないこと:

  1. window.__timelines の登録を忘れる
  2. オーディオにビデオを使用する — 常にミュートされたビデオ + 別の <audio>
  3. ビデオをタイミング付きのdiv内にネストする — タイミングなしのラッパーを使用する
  4. data-layer(data-track-indexを使用)または data-end(data-durationを使用)を使用する
  5. ビデオ要素の寸法をアニメーションする — ラッパーdivをアニメーションする
  6. メディアでplay/pause/seekを呼び出す — フレームワークが再生を所有します
  7. data-composition-id なしでトップレベルのコンテナを作成する
  8. 任意のタイムラインまたはトゥイーンで repeat: -1 を使用する — 常に有限リピートにする
  9. タイムラインを非同期に構築する(async、setTimeout、Promise 内)
  10. 後続のシーンからのクリップ要素に gsap.set() を使用する — それらはページロード時にDOMに存在しません。代わりに、クリップの data-start 時間以降のタイムライン内で tl.set(selector, vars, timePosition) を使用してください。
  11. コンテンツテキストで <br> を使用する — 強制改行は実際にレンダリングされたフォント幅を考慮しません。自然に折り返されるテキストに <br> を追加すると、不要な改行が発生し、重なりの原因になります。代わりに max-width を使用してテキストを折り返してください。例外:各単語が意図的に別々の行にある短い表示タイトル(例:130pxでの「THE\nIMMORTAL\nGAME」)。

シーントランジション(譲歩不可)

マルチシーンコンポジションは、以下のすべてのルールに従う必要があります。いずれか1つに違反すると、コンポジションは壊れます。

  1. **...

[翻訳のために一部省略]

Individual skills in this repo

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

libz-renlab-ai/TeamBrain

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.

libz-renlab-ai/TeamBrain

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.

libz-renlab-ai/TeamBrain

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames — for example "port my Remotion project to HyperFrames", "convert this Remotion code to HyperFrames", "migrate from Remotion", "translate this Remotion comp", or "rewrite this as HyperFrames HTML". Do NOT use when (a) the user is authoring a NEW HyperFrames composition, even if they have or are A/B-testing a similar Remotion video; (b) the user mentions Remotion in passing without asking for migration; (c) the user shares Remotion code as reference material rather than asking for a translation; (d) the user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build. When in doubt, default to authoring a native HyperFrames composition with the `hyperframes` skill instead. Skill detects unsupported patterns (use...

libz-renlab-ai/TeamBrain

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.

libz-renlab-ai/TeamBrain

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

関連スキル