Communitygithub.com

HyperFrames CLI 開発ループ

HyperFrames CLI の開発ループを提供します。`npx hyperframes` によるスキャフォールディング(init)、検証(lint, inspect)、プレビュー、レンダリング、環境トラブルシューティング(doctor, browser, info, upgrade)を行います。音声アセット前処理(tts, transcribe, remove-background)のコマンドを実行する場合は、代わりに `hyperframes-media` スキルを呼び出してください。

HyperFrames CLI 開発ループ とは?

このスキルは HyperFrames CLI の開発ループ全体をカバーします。プロジェクトのスキャフォールディングから検証、プレビュー、レンダリング、トラブルシューティングまで、HyperFrames でのビデオ制作ワークフローを支援します。主要なコマンドは `npx hyperframes init`(スキャフォールディング)、`lint`(HTML の静的検証)、`inspect`(ヘッドレス Chrome による視覚的検査)、`preview`(ホットリロード付きプレビューサーバー)、`render`(MP4/WebM 出力)です。Node.js >= 22 と FFmpeg が必要で、`hyperframes` スキル(HTML 合成オーサリング)と `hyperframes-media` スキル(音声アセット前処理)と組み合わせて使用します。トラブルシューティング用の `doctor`、`browser`、`info`、`upgrade` コマンドも含まれています。

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

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

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

ドキュメント

HyperFrames CLI

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

ワークフロー

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

プレビュー前に lint と inspect を実行してください。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 --example blank --tailwind # Tailwind v4 ブラウザランタイムを使用
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 コーディングスキルをインストールします。手動でファイルを作成する代わりにこれを使用してください。

--tailwind を使用する場合は、クラスやテーマトークンを編集する前に tailwind スキルを呼び出してください。スキャフォールディングは Studio の Tailwind v3 設定ではなく、ブラウザランタイムを介した Tailwind v4.2 を使用します。

Lint

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

index.html と compositions/ 内のすべてのファイルを lint します。エラー(修正必須)、警告(修正推奨)、および情報(--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 パスではなく、Studio のプロジェクト 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/name_timestamp.mp4出力パス
--fps24, 30, 603060fps ではレンダリング時間が倍になります
--qualitydraft, standard, highstandarddraft はイテレーション用
--formatmp4, webmmp4WebM は透明度をサポート
--workers1-8 または autoauto各ワーカーが Chrome を起動
--dockerフラグオフ再現可能な出力
--gpuフラグオフGPU アクセラレーションエンコーディング
--strictフラグオフlint エラーで失敗
--strict-allフラグオフエラーと警告の両方で失敗
--variablesJSON オブジェクト—data-composition-variables で宣言された変数値を上書き
--variables-fileパス—変数値を含む JSON ファイル(--variables の代替)
--strict-variablesフラグオフ--variables で未宣言のキーや型の不一致でレンダリングを失敗させる

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

パラメータ化レンダリング: コンポジションは <html> ルートに data-composition-variables で変数を宣言します。これはスキーマを定義する JSON 宣言の配列(各エントリ: {id, type, label, default})です。スクリプトは window.__hyperframes.getVariables() を介して解決された値を読み取ります。CLI の --variables '{"title":"Q4 Report"}' は、id をキーとする JSON オブジェクト で、宣言されたデフォルト値を 1 回のレンダリングで上書きします。不足しているキーはデフォルト値が使用されるため、同じコンポジションを開発プレビューと本番の両方で変更せずに実行できます。(サブコンポジションホストは、data-variable-values を使用してインスタンスごとに上書きすることもできます。同じオブジェクト形状で、サブコンポジションの 1 つのマウントにスコープされます。完全なパターンについては hyperframes スキルを参照してください。)

アセット前処理

npx hyperframes tts、transcribe、remove-background はアセット(ナレーション音声、単語レベルの文字起こし、透明ビデオ)を生成し、コンポジションに配置します。各コマンドは初回実行時に独自のモデルをダウンロードします。音声選択、Whisper モデルルール(.en が非英語を翻訳する注意点)、出力形式の選択(VP9 アルファ WebM vs ProRes)、TTS → 文字起こし → キャプションのチェーンについては、hyperframes-media スキルを呼び出してください。

トラブルシューティング

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 14 individual skills — each has its own dedicated page.

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

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.

delorenj/skills

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.

delorenj/skills

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 dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

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 (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

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.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

関連スキル