nateherkai/hyperframes-student-kit

Edit videos, reels, and YouTube Shorts with Codex or Claude Code. 14 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.

HyperFrames Student Kit – AI支援型動画編集実験環境

何であるか – 大規模言語モデルエージェント（Codex または Claude）の助けを借りて、自身の映像を編集できる再利用可能なオープンソースツールキットです。リポジトリには「スキル」（エージェント駆動のコマンド）、モーショングラフィックス資産、シーンテンプレート、および静止画の除去、ミスの検出、トランスクリプトに基づくタイミング調整、ビート同期検証、ショート形式のリール作成など、一般的な後処理タスクを自動化するヘルパースクリプトが含まれています。

なぜ重要か – LLMが動画編集アシスタントとして機能する具体的なワークフローを示しており、自然言語プロンプトを FFmpeg/GSAP 操作に変換します。このツールキットは、インフラをゼロから構築せずに AI ベースの編集を実験したい学生やクリエイター向けに設計されています。

コアコンポーネント

コンポーネント	提供内容
14の「スキル」	`edit-video`、`cut-silences`、`cut-mistakes`、`short-form-edit` など、各スキルにヘルパースクリプトと参考資料を備えた事前作成されたエージェントプロンプト。
406枚のドラフトモーショングラフィックスカード	GSAPベースのグラフィックス（2種類のビジュアルスタイル）で、CSSトークンと編集可能なスロットを備えています；メタデータは `style-library/registry.json` に保存されます。
シーンテンプレート	ダークなグラフペーパーバックグラウンドと左側のガラスポップアウトの2つの完全なシーンレイアウト。カードと組み合わせて使用可能です。
トランスクリプトとカットパイプライン	ElevenLabs Scribe、OpenAI Whisper、またはローカル Whisper とのオプション統合により、単語レベルのトランスクリプトを取得；無音部分のカット、ミスのマーク、エディット決定リスト（EDL）の生成を自動化するスクリプト。
ショートフォームワークフロー	長時間の録画を9:16のリールまたはYouTube Shortsに変換するエンドツーエンドのコマンド。フック/エンディングの計画、キャプションタイミングの検証、Bロール挿入、サウンドデザインのヒントを含みます。
デモおよび教育用プロジェクト	外部APIキーなしで動作する12の学生向け例題プロジェクトと、合成されたスターター構成。

対象ユーザー

学生および教育者：LLMエージェントとメディアパイプラインを組み合わせる方法を学びたい方。
コンテンツクリエイター：スクリプタブルでAIガイド付きの方法で映像をトリミング・仕上げたい方。
開発者：AIエージェント駆動の動画ツールの構築・拡張に興味がある方（リポジトリは即戦力の参考実装です）。

セットアップ手順（READMEから）

前提条件 – Node 22+、Git、FFmpeg（ffprobe を含む）、および PATH に Chrome/Chromium が設定されていること。

クローンとインストール

git clone https://github.com/nateherkai/hyperframes-student-kit.git
cd hyperframes-student-kit
npm ci               # 依存関係のインストール
npm run setup        # ツールの確認、.env テンプレートの作成
npm test             # サニティチェック

デモの実行

npm run demo
cd video-projects/demo
npx hyperframes lint
npx hyperframes preview   # 8秒のアニメーションを確認
npx hyperframes render --quality draft --output renders/demo.mp4

自身の映像を編集 – Codex または Claude Code でフォルダを開き、自然言語コマンドを発行します。例：
```
$edit-video  /path/to/my-recording.mp4
```
アシスタントは適切なスキル（cut-silences、cut-mistakes など）を呼び出し、ドラフト編集を生成します。
ショートフォームリールを作成 – short-form-edit スキルを使用し、以下のプロンプトを入力します：
```
/short-form-edit  /path/to/lecture.mp4  make a 9:16 Reel with hook, captions and beat-sync
```
ワークフローはレンダリング前にキャプションタイミング、シーンカバレッジ、映像の再利用を検証します。

オプションのAIサービス

ElevenLabs Scribe – クラウドトランスクリプション（デフォルトのヘルパー）。
Kie.ai – 補足的な動画／画像資産を生成。
OpenAI Whisper または ローカル Whisper – 代替のトランスクリプションバックエンド。使用するサービスにのみAPIキーを提供すればよく、合成スターターは完全にオフラインで動作します。

制限事項と考慮点

高品質なトランスクリプションや資産生成には外部APIに依存しています；それらが利用できない場合、ローカルワークフローのみとなり、これらのステップはスキップされます。
モーショングラフィックスカードとテンプレートはドラフト資産です；最終的な制作前にCSSトークンやテキストスロットをカスタマイズすることを想定しています。
アシスタントコマンド（$edit-video、/short-form-edit など）は Codex および Claude Code IDE拡張機能に紐づいています；それら環境外で使用するには、下位スクリプトを手動で実行する必要があります。
レンダリング品質は --quality フラグで制御されます；高品質レンダリングは時間がかかり、より多くのシステムリソースを必要とします。

クイックリファレンスリンク（リポジトリ内）

エージェント指示リファレンス – AGENTS.md
モーショングラフィックス用語集 – MOTION_PHILOSOPHY.md
スタイルライブラリガイド – style-library/GUIDE.md
ワークフロー紹介 – docs/WORKFLOW.md
プロンプトレシピ – docs/PROMPTS.md
ショートフォーム編集ガイド – docs/SHORT-FORM.md
ツールおよびAPIキー設定 – docs/TOOLS-AND-API-KEYS.md

結論 – HyperFrames Student Kit は、LLMエージェントが動画編集パイプラインを駆動する方法を実際に体験できるオープンソースの実験環境です。アセット、スクリプト、例題プロジェクトを備えており、自然言語コマンド数回で、原始的な映像から仕上げられたショートフォームコンテンツまでを生成できます。