Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFrames CLI ツール — hyperframes init、lint、preview、render、transcribe、tts、doctor、browser、info、upgrade、compositions、docs、benchmark。プロジェクトのスキャフォールディング、コンポジションのリントや検証、スタジオでのプレビュー、動画レンダリング、音声文字起こし、TTS 生成、HyperFrames 環境のトラブルシューティングに使用します。

hyperframes-student-kit とは?

HyperFrames CLI は、動画制作パイプライン全体を1つのコマンドラインツールで統合するオールインワン CLI です。プロジェクトの初期スキャフォールディングから、HTML コンポジションのリント、ブラウザ上でのライブプレビュー、最終的な動画レンダリング、さらに音声の文字起こしやテキスト読み上げ (TTS) までをシームレスに実行できます。Node.js 22 以上と FFmpeg が必要で、`npx hyperframes` を介して動作します。開発者は `init` でベストプラクティスに沿ったファイル構成と AI コーディングスキルを自動生成し、`lint` で品質をチェック、`preview` でホットリロードによる迅速なフィードバックを得られます。`render` はドラフトから高品質まで複数の品質レベルをサポートし、Docker による再現可能な出力や GPU アクセラレーションにも対応。`doctor` や `browser` といったトラブルシューティングコマンドも提供し、環境設定の問題を診断できます。このスキルは特に Claude Code などの AI エージェントとの連携を念頭に設計されており、非対話モードを使って CI/CD やエージェントワークフローに組み込むことが可能です。

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

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

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

ドキュメント

HyperFrames CLI

すべての操作は npx hyperframes で実行します。Node.js >= 22 と FFmpeg が必要です。

ワークフロー

  1. スキャフォールディング — npx hyperframes init my-video
  2. 作成 — HTML コンポジションを作成(hyperframes スキルを参照)
  3. リント — npx hyperframes lint
  4. プレビュー — npx hyperframes preview
  5. レンダリング — npx hyperframes render

プレビューの前にリントを実行してください。data-composition-id の欠落、トラックの重複、未登録のタイムラインなどを検出します。

スキャフォールディング

npx hyperframes init my-video                        # 対話型ウィザード
npx hyperframes init my-video --example warm-grain   # サンプルを選択
npx hyperframes init my-video --video clip.mp4        # 動画ファイルを指定
npx hyperframes init my-video --audio track.mp3       # 音声ファイルを指定
npx hyperframes init my-video --non-interactive       # プロンプトをスキップ(CI/エージェント向け)

テンプレート: blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph。

init は正しいファイル構造を作成し、メディアをコピーし、Whisper で音声を文字起こし、AI コーディングスキルをインストールします。手動でファイルを作成する代わりに使用してください。

リント

npx hyperframes lint                  # カレントディレクトリ
npx hyperframes lint ./my-project     # 特定のプロジェクト
npx hyperframes lint --verbose        # info レベルの結果も表示
npx hyperframes lint --json           # 機械可読形式

index.html と compositions/ 内のすべてのファイルをリントします。エラー(修正必須)、警告(修正推奨)、情報(--verbose 時)を報告します。

プレビュー

npx hyperframes preview                   # カレントディレクトリを配信
npx hyperframes preview --port 4567       # カスタムポート(デフォルト 3002)

ファイル変更時にホットリロードします。自動的にブラウザでスタジオを開きます。

レンダリング

npx hyperframes render                                # 標準 MP4
npx hyperframes render --output final.mp4             # 出力ファイル名を指定
npx hyperframes render --quality draft                # 高速イテレーション
npx hyperframes render --fps 60 --quality high        # 最終納品用
npx hyperframes render --format webm                  # 透明 WebM
npx hyperframes render --docker                       # バイト一致の再現性
フラグオプションデフォルト備考
--outputパスrenders/name_timestamp.mp4出力パス
--fps24、30、603060fps はレンダリング時間が2倍
--qualitydraft、standard、highstandarddraft はイテレーション用
--formatmp4、webmmp4WebM は透明度をサポート
--workers1-8 または autoauto各ワーカーは Chrome を起動
--dockerフラグオフ再現可能な出力
--gpuフラグオフGPU アクセラレーションエンコード
--strictフラグオフリントエラーで失敗
--strict-allフラグオフエラーと警告の両方で失敗

品質ガイダンス: イテレーション中は draft、レビュー用は standard、最終納品用は high を使用してください。

文字起こし

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 既存のファイルをインポート
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

テキスト読み上げ (TTS)

npx hyperframes tts "ここにテキスト" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # すべての音声を表示

トラブルシューティング

npx hyperframes doctor       # 環境をチェック(Chrome、FFmpeg、Node、メモリ)
npx hyperframes browser      # バンドルされた Chrome を管理
npx hyperframes info         # バージョンと環境の詳細
npx hyperframes upgrade      # アップデートを確認

レンダリングに失敗した場合は、最初に doctor を実行してください。よくある問題: FFmpeg の欠落、Chrome の欠落、メモリ不足。

その他

npx hyperframes compositions   # プロジェクト内のコンポジション一覧
npx hyperframes docs           # ドキュメントを開く
npx hyperframes benchmark .    # レンダリングパフォーマンスのベンチマーク

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

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/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

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.

関連スキル