Communitygithub.com

govindgoel2001/video-editing-toolkit

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

video-editing-toolkit とは?

HyperFrames CLIは、動画編集プロジェクトを効率的に管理・開発するための包括的なコマンドラインツールキットです。Node.js 22以上とFFmpegを必要とし、`npx hyperframes` コマンドを通じてすべての操作を実行します。主な機能として、プロジェクトのスキャフォールディング(`init`)、HTMLコンポジションのリンティング(`lint`)、ヘッドレスChromeによる視覚的レイアウト検査(`inspect`)、ホットリロード対応のスタジオプレビュー(`preview`)、動画/WebMレンダリング(`render`)、Whisperベースの文字起こし(`transcribe`)、テキスト読み上げ(`tts`)、環境診断(`doctor`)などがあります。このツールは、テキストの吹き出しやコンテナからの溢れ、キャンバス外への描画など、視覚的なレイアウト問題を自動検出し、LLMコンテキストウィンドウに最適化されたJSON出力を提供します。AIエージェントやCIパイプラインとの連携を前提に設計されており、`--non-interactive` モードや `--strict` フラグなど、自動化に適したオプションを豊富に備えています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-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 inspect
  5. プレビュー — npx hyperframes preview
  6. レンダリング — npx hyperframes render

プレビューの前にリントと視覚検査を実行してください。lint は、data-composition-id の欠落、トラックの重複、未登録のタイムラインを検出します。inspect は、レンダリングされたコンポジションをヘッドレスChromeで開き、タイムラインをシークして、吹き出しやコンテナからはみ出したテキスト、またはキャンバス外のテキストを報告します。

スキャフォールディング

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        # 情報レベルの結果も表示
npx hyperframes lint --json           # 機械可読形式

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

視覚検査

npx hyperframes inspect                 # タイムライン全体のレンダリングレイアウトを検査
npx hyperframes inspect ./my-project    # 特定のプロジェクト
npx hyperframes inspect --json          # エージェント可読な結果
npx hyperframes inspect --samples 15    # より細かいタイムライン走査
npx hyperframes inspect --at 1.5,4,7.25 # 特定のヒーローフレームのタイムスタンプを指定

これは lint と validate の後に使用します。特に、吹き出し、カード、キャプション、タイトなタイポグラフィを含むコンポジションに有効です。以下を報告します:

  • テキストが最も近い視覚コンテナや吹き出しの外側にはみ出している
  • テキストが自身の固定幅/高さのボックスでクリップされている
  • テキストがコンポジションキャンバスの外側にはみ出している
  • 子要素がクリッピングコンテナからはみ出している

エラーはレンダリング前に修正する必要があります。警告はエージェントのレビュー用に表示されます。--strict を追加すると警告でも失敗します。繰り返し発生する静的な問題はデフォルトで集約されるため、LLMコンテキストウィンドウ向けにJSON出力がコンパクトに保たれます。出入りアニメーションで意図的にオーバーフローさせている場合は、対象要素またはその祖先に data-layout-allow-overflow を設定してください。監査対象外の装飾要素には data-layout-ignore を設定します。

npx hyperframes layout は、同じ視覚検査を実行する互換性エイリアスとして引き続き利用可能です。

プレビュー

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

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

プロジェクトをユーザーに引き継ぐ際は、ソースの index.html パスではなく、スタジオのプロジェクトURLを使用してください:

http://localhost:<port>/#project/<project-name>

プレビュー出力の実際のポートとプロジェクトディレクトリ名を使用してください。たとえば、codex-openai-video で npx hyperframes preview --port 3017 を実行した場合は、http://localhost:3017/#project/codex-openai-video を報告します。

index.html はソースコードコンテキストとしてのみ扱ってください。実装ファイルとしてリンクすることは問題ありませんが、プロジェクトやプレビュー画面としてラベル付けしないでください。

レンダリング

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/名前_タイムスタンプ.mp4出力パス
--fps24, 30, 603060fpsはレンダリング時間が倍増
--qualitydraft, standard, highstandarddraftはイテレーション用
--formatmp4, webmmp4WebMは透明度をサポート
--workers1-8 または autoauto各ワーカーがChromeを起動
--dockerフラグoff再現可能な出力
--gpuフラグoffGPUアクセラレーションエンコード
--strictフラグoffリントエラーで失敗
--strict-allフラグoffエラーと警告で失敗

品質ガイダンス: イテレーション中は 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 "Text here" --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 6 individual skills — each has its own dedicated page.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

関連スキル