Communitygithub.com

nateherkai/hyperframes-student-kit

トーキングヘッド動画向けHyperFramesプロジェクトにおいて、モーショングラフィック・ビートの計画、作成、タイミング調整、スタイル適用、検証を行います。Codexが既存のHyperFramesビデオプロジェクトにビジュアルビート、グラスモーフィズムのローワーサード、くしゃくしゃ紙の全面テイクオーバー、トランスクリプト同期コールアウト、ペーシングカバレッジ、YouTubeリテンション向けグラフィック、またはレンダリング可能なオーバーレイを追加・改善するよう求められたときに使用します。

hyperframes-student-kit とは?

このスキルは、トーキングヘッド形式の長尺動画(YouTubeなど)向けに、ナレーションを視覚的に補完するモーショングラフィックビートを体系的に計画・生成・検証するためのものです。HyperFramesフレームワーク上で動作し、ビデオのトランスクリプトを解析して、視聴者の注意を維持し、重要な概念、統計、対比を強調するタイミングでグラフィックを配置します。主なビートタイプには、主張や統計を強調する「全面くしゃくしゃ紙(Paper Takeover)」と、説明中のトピックラベルやリストを表示する「グラスモーフィズムローワーサード(Glassmorphism Lower Third)」の2種類があります。スキルは、トランスクリプトの話題区間に基づいたタイミング調整、視覚的一貫性のためのCSSルールの遵守、HyperFramesの実装ルール(データ属性、GSAPタイムライン、リンターの実行など)への準拠を徹底します。また、ペーシングのヒューリスティックに従い、視聴者が離脱しやすいギャップを特定して適切なビートを挿入します。出力は、プロジェクトのAGENTS.mdや既存のデザインシステムを尊重し、編集後は常にHyperFramesリンターで検証します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-video-beats

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

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

ドキュメント

HyperFrames ビデオビート

このスキルを使用して、トーキングヘッド動画とトランスクリプトから、ナレーションをサポートし、話し手を不必要に隠さない、ペーシングされたモーショングラフィックのセットを作成します。

中核目標

視聴者の方向性を維持し、エンゲージメントを高めます。すべてのビートは次のいずれかに答える必要があります。

  • 視聴者は何を覚えておくべきか?
  • どの概念に視覚的な構造が必要か?
  • どの統計、対比、転換点が強調に値するか?
  • 視聴者が離脱しそうなほどペーシングが静かな場所はどこか?

ギャップがあるからといってグラフィックを追加してはいけません。ナレーションに、視覚的なサポートが有効なトピック、トランジション、証明点、メンタルモデルがあるからグラフィックを追加します。

最初のパス

  1. プロジェクトの指示(AGENTS.md、ローカルスキルドキュメント、プロジェクト固有のメモ)を読みます。
  2. ルートコンポジション、現在のビートスケジュール、共有CSS、およびトランスクリプトを検査します。
  3. ルートの data-start / data-duration エントリまたはマスター SHOW 配列からカバレッジマップを作成します。
  4. 要求された領域とカバーされていないギャップについて、トランスクリプトチャンクを抽出します。
  5. 任意のタイムスタンプではなく、ナレーションによってトピックスパンを識別します。
  6. 各トピックに、全画面のペーパービート、ローワーサードのグラスカード、または新しいビートなしのいずれが必要かを決定します。

高速なローカルコマンドを使用します。rg、Select-String、および小さなNode / PowerShellトランスクリプトスクリプトを優先します。

ビートタイプの決定

全画面くしゃくしゃ紙の使用

ナレーションが主要なテーゼ、リスト、セクションマーカー、引用、または統計に達し、それが一時的にフレーム全体になるべき場合に、ペーパーテイクオーバーを使用します。

適切な使用例:

  • フックの決着または「このビデオでは」概要
  • 主要セクションのトランジション
  • 大きな統計または研究結果
  • 記憶に残るテーゼライン
  • 短い引用またはマントラ
  • 視聴者に立ち止まって見てもらう必要がある対比

ルール:

  • 短く保つ。通常4〜12秒。
  • まばらな黒文字を使用。
  • 真の統計番号または非常に重要な単語のみにアクセントカラーを使用。
  • ペーパーテイクオーバーで長い説明をカバーしない。
  • デフォルトで全画面テキストを遊び心あふれるもの、巨大なもの、または過度に太字にしない。

グラスモーフィズムローワーサードの使用

話し手を表示したままにし、グラフィックが現在のアイデアをサポートするべき場合に、グラスローワーサードを使用します。

適切な使用例:

  • 説明の足場
  • トピックラベル
  • 方程式スタイルのメンタルモデル
  • 小さなリスト
  • 「これが意味すること」の翻訳
  • 長いトーキングヘッド部分のペーシング埋め
  • 短縮された全画面または分割画面ビートの後のフォローアップカード

ルール:

  • ローワーサードは画面の下3分の1または下半分に配置。
  • 顔を覆うのを避ける。
  • 簡潔なテキスト:1つの見出しとオプションの短いサブライン、または2〜4項目のリスト。
  • 多くの小さなフラッシュよりも、トピックスパンごとに1つのカードを優先。
  • ユーザーがデザイン変更を要求しない限り、既存のグラスカードスタイルを維持。

ペーシングのヒューリスティック

長尺YouTubeトーキングヘッド動画の場合:

  • 動画の序盤:20〜30秒以上ビジュアルビートなしを避ける。
  • 本編:30〜45秒以上ビートなしを避ける。
  • 密度の高い説明セクション:ほぼすべてのトピックスパン、すべての文ではない頻度でローワーサードを使用。
  • 大きなペーパーテイクオーバーは、稀な句読点とし、デフォルトにしない。
  • 既存のビートが長すぎると感じて手動で短縮された場合、その選択を尊重し、その後ろに新しい短いカードを入れて埋める。

スケジュールをスキャンするときは、DOMの順序だけでなく、可視性スケジュールからの真のギャップを報告します。ルートタイムラインが SHOW 配列を使用している場合、それが通常、信頼できる可視範囲です。

タイミング方法

すべてのビートをトランスクリプトトピックに合わせます:

  1. トピックが始まる最初の単語またはフレーズを見つける。
  2. 可能であれば、そのアンカーの0.2〜0.6秒前にビートを開始する。
  3. トピックが終了するか、自然に引き継がれるまでビートを表示したままにする。
  4. 次のビートがすぐに始まる場合、引き継ぎが意図的でない限り、その0.1〜0.5秒前にクリアする。
  5. サブ要素の出現を話されたフレーズに合わせる。

次の失敗モードを避ける:

  • カードは正しいトピックに表示されるが、話し手がトピックについて20〜40秒話し続けている間、わずか5〜8秒しか持続しない。

次のようにする:

  • 1つのカードがトピック全体にわたって存在し、ナレーションが変化する場合、途中でサブラインまたはリスト項目が追加される。

コンテンツ作成

一瞥で理解できるように作成します。視聴者は1秒未満でカードを理解できる必要があります。

使用するもの:

  • 短い名詞句
  • 直接的なラベル
  • カードあたり1つのメンタルモデル
  • 意味がある場合のみ数字
  • 動作を明確にする場合の動詞

避けるもの:

  • ボイスオーバー全体の繰り返し
  • 長い文
  • あいまいな誇大宣伝用語
  • 強調しすぎの単語
  • グラフィック内でビデオの使い方を説明すること

良いパターン:

ボトルネック
実際のワークフローにAIが十分に組み込まれていない。
問題は才能ではなく、採用である。
橋渡し
スキル + ワークフロー = 40時間節約
このビデオで
-> 研究
-> 統計
-> 取れる道筋
-> 実際に重要なこと

ビジュアルスタイルルール

まずローカルデザインシステムに従います。このプロジェクトファミリーでは、次を使用します:

  • シリアスなプロフェッショナルなタイポグラフィ。
  • ペーパービートでは黒のプライマリテキスト。
  • アクセントブルーは、主要な統計番号またはまれなパワーワードのみ。
  • 既存のダークフロストスタイルのグラスカード。
  • 話し手の顔を覆わないローワーサードカード。

ペーパービートの場合:

  • キッカー、ラベル、矢印、ソース、引用、サポートテキストには黒を使用。
  • フォントのウェイトは控えめに。
  • ユーザーが明示的に要求しない限り、特大の遊び心のあるタイプは避ける。
  • くしゃくしゃ紙のモーションを決定的にする。

グラスカードの場合:

  • .glass-card dim lower-third または最も近い既存のクラスを再利用。
  • 下部中央の配置を優先。
  • カードはコンパクトに。
  • アイデアが構造的な場合は、方程式/リストヘルパーを使用。

HyperFrames 実装ルール

プロジェクトの AGENTS.md と HyperFrames リントルールに従います:

  • マウントされたすべてのタイミング要素には、data-start、data-duration、data-track-index が必要。
  • 可視のタイミングルートマウント要素には、プロジェクトで使用される期待されるクリップ/レイヤークラスが必要。
  • サブコンポジションは、window.__timelines に一時停止された GSAP タイムラインを登録する必要があります。
  • 各サブコンポジションタイムラインを tl.set({}, {}, SLOT); で固定します。
  • 決定的なロジックのみを保持します。
  • レンダリングをフリーズさせる可能性のある方法で、ビデオ要素の寸法やメディアプロパティをアニメーション化しないでください。
  • HTML を編集した後、npx hyperframes lint を実行します。

ビートを追加するとき:

  1. compositions/beats/NNN-short-name.html を作成します。
  2. index.html にルートマウントを追加します。
  3. マスター可視性スケジュールが存在する場合は、それを追加または更新します。
  4. サブコンポジションの SLOT をマウントされた期間に一致させます。
  5. プロジェクトが意図的に複数のオーバーレイトラックを使用しない限り、同じトラックの重複がないことを確認します。

カバレッジスキャン

編集後、マスタースケジュールをスキャンします:

  • 可視開始時刻でソートされたビートのリスト。
  • ターゲットしきい値を超えるギャップを出力。
  • トランスクリプトがサポート可能な概念を持っている場所にのみ、ビートを追加または再タイミングします。

このプロジェクトパターンでは、厳格なスキャンしきい値として30秒、本編で許容される最大しきい値として45秒を使用します。

検証

終了する前:

  1. HyperFrames リンターを実行します。
  2. すべてのエラーを修正します。
  3. 既知でブロッキングではない場合、警告を個別に言及します。
  4. ユーザーがレンダリング可能な出力を要求した場合、適切にレンダリングまたはスモークレンダリングします。
  5. ユーザーに正確なファイルパスと変更されたタイムスタンプを提供します。

実用的なデフォルト

プロジェクトコンテキストがそうでないと指示しない限り、次のデフォルトを使用します:

  • 全画面ペーパー概要:8〜10秒。
  • 全画面ペーパー統計:5〜8秒。
  • グラスローワーサード説明:12〜30秒。
  • 長いトピックグラスカード:25〜45秒、サブ要素をずらして表示。
  • ビート開始リードイン:0.2〜0.6秒。
  • ギャップスキャンしきい値:30秒。
  • ローワーサード幅:約68〜72vw、最大約1240〜1280px。

保存すべきもの

レビュー中に発見されたユーザーの好みの決定を保存します:

  • ユーザーがビートが長すぎると言った場合、一般的なカバレッジルールを満たすためだけにそれを復元しない。
  • グラスカードスタイルが承認された場合、再設計する代わりにそれを再利用する。
  • タイポグラフィが承認された場合、それを安定させ、ローカルのサイズ/ウェイトのみを調整する。
  • 話し手の顔が重要な場合、中央画面カードよりもローワーサードカードを優先する。

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

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

nateherkai/hyperframes-student-kit

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.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

関連スキル