Communitygithub.com

HyperFrames CLI

HyperFrames CLIを使用した開発ループ(init、add、catalog、capture、lint、check、snapshot、compare、grade-compare、preview、play、present、beats、keyframes、シングル/バッチレンダリング、publish、cloud、cloudrun、feedback、lambda、doctor、browser、info、upgrade、skills、compositions、docs、benchmark、telemetry、transcribe、auth、tts、remove-background)を提供します。ビルドやレンダリングの失敗診断にも使用します。validate、inspect、layoutは非推奨のエイリアスで、代わりにcheckを使用します。ローカル、HeyGenホスト型クラウド、AWS Lambda、Google Cloud Runでのレンダリングに対応しています。

HyperFrames CLI とは?

HyperFrames CLIは、動画合成とレンダリングのための包括的な開発ツールです。主な機能として、プロジェクトの初期化(init)、静的解析(lint、check)、スナップショット取得(snapshot)、プレビュー(preview)、レンダリング(render)などを提供し、開発ループを通じて効率的な動画制作をサポートします。チェックコマンドはlintを実行した後、ブラウザセッションでランタイムエラーやレイアウト問題を監査します。プレビューはストーリーボードと最終コンポジションプレビューの2種類があり、レンダリングには必ず最終承認が必要です。レンダリングオプションは多様で、ローカルの高速反復(draft品質)、最終出力(high品質)、Dockerを使用した再現性のあるレンダリング、変数駆動のバッチレンダリング、さらにHeyGen Cloud、AWS Lambda、Google Cloud Runを使用したクラウドレンダリングをサポートしています。エージェント向けには--jsonフラグや非対話型モードを提供し、CI/CDパイプラインとの統合も容易です。また、サブコンポジションのスモークテスト、スタジオ経由の編集、フィードバック報告など、高度な開発ワークフローをカバーしています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-cli

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

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

ドキュメント

HyperFrames CLI は何をしますか?

特にプロジェクトの指示がラッパーを提供していない限り、コマンドは npx hyperframes ... として実行します。ラッパーがある場合はそれに従ってください。CLIにはNode.js 22以降とFFmpegが必要です。

開発ループ

  1. スキャフォールディング: npx hyperframes init <project> またはサイトをキャプチャします。非TTYモードでは、--non-interactive --example=<name> を渡します。
  2. 作成: /hyperframes-core を使用してコンポジションを記述します。
  3. 編集しながら迅速なフィードバックを得る: 最初のHTMLパス後および構造変更後に npx hyperframes lint を実行します。
  4. 最終ゲートを実行する: npx hyperframes check を実行します。これにより、ブラウザを開く前にlintが再実行されます。冗長なスタンドアロンのlint呼び出しを前置しないでください。--snapshots を追加すると、注釈付きの概要フレームとクロップ領域の特定が可能です。
  5. サブコンポジションの検査: index.html が data-composition-src をマウントする場合、中間点のスナップショットをキャプチャし、マウントされた各シーンを検査します。
  6. 最終スタジオプレビューを開く: npx hyperframes preview を実行し、タイムラインプロジェクトURLをユーザーに渡し、修正するかレンダリングするかを尋ねます。
  7. 承認後にのみレンダリングする: 反復にはドラフト品質、納品には高品質を使用します。
  8. 出力を確認する: ファイルが存在し、空でなく、妥当な長さであることを確認します。
# 高速な反復チェック。作成中に必要に応じて繰り返します。
npx hyperframes lint

# 必須の最終ゲート。lintを含みます。
npx hyperframes check
npx hyperframes preview
npx hyperframes render --quality high --output out.mp4
test -s out.mp4
ffprobe -v error -show_format out.mp4

check は最初にlintを実行し、次に1つのブラウザセッションと1回のシークパスを使用して、ランタイムエラー、失敗したリクエスト、レイアウト、*.motion.json アサーション、およびWCAGコントラストを監査します。永続的な(persistent)発見は終了コードに影響します。一時的な(transient)入口または出口の発見は情報提供のみです。警告をゲートするには --strict を使用します。validate、inspect、layout は互換性のためにエイリアスとして残されていますが、新しい指示やスクリプトには使用しないでください。

2つの異なるプレビュー画面

これらの状態を混同しないでください:

画面開かれる条件目的
ストーリーボードコンポジションチェック前、storyboard: yes の場合のみ計画カードとワイヤーフレームスケッチを確認します。?view=storyboard#project/<name> を開きます。
最終コンポジションプレビューcheck 合格後レンダリング前に組み立てられたタイムラインを確認します。#project/<name> を開きます。

初期のボードは最終ビデオの承認ではありません。レンダリングには常に、hyperframes-core/references/review-loop.md で定義された最終承認が必要です。

サブコンポジションスモークテスト

静的監査ではすべてのマウント障害を捕捉できるわけではありません。プロジェクトがサブコンポジションを使用する場合、各ホストスロットに対して少なくとも1つの可視中間点をキャプチャします:

npx hyperframes snapshot --at <t1>,<t2>,<t3>

小さなスタイル未適用のコンテンツ、キャンバスサイズのアイコン、欠落したヒーロー要素、またはタイムライン登録のタイムアウトを、レンダリングをブロックするマウント不良として扱います。対応する修正については hyperframes-core/references/sub-compositions.md を参照してください。

エージェントの規約

  • エージェントおよびCI呼び出しでは --json を優先します。サーバーモードの render、preview、play は通常のJSON出力を提供しません。preview --selection --json および preview --context --json はクエリモードの例外です。

  • doctor --json は常にゼロで終了します。そのペイロードでゲートします:

    npx hyperframes doctor --json | jq -e '.ok' >/dev/null
    
  • 非TTYモードは自動です。init ではそこに --example が必要です。TTY上で決定論的な動作を強制するには --non-interactive を使用します。

  • 同じ検証ループ内のすべてのコマンドには1つの HYPERFRAMES_RUN_ID を使用します。

  • 対応する警告、変数、またはCI条件がレンダリングをゲートする必要がある場合は、--strict、--strict-all、--strict-variables を使用します。

  • JSONパスはホームディレクトリを $HOME として秘匿します。秘匿を解除しようとしないでください。

  • チェックが通ったからといってレンダリングしてはいけません。最終プレビューで一時停止し、承認を待ちます。

スタジオ経由の編集

ユーザーが「この要素」や現在の選択について言及した場合、推測する代わりにスタジオに問い合わせます:

npx hyperframes preview --context --json --context-fields selection

利用可能な場合は selection.target.hfId を、それ以外の場合はそのセレクタとソースファイルを使用します。結果が no-selection を報告した場合は、ユーザーに要素をクリックして再実行するよう依頼します。必要なコンテキストスライスのみを要求し、--context-detail full は計算済みスタイルや編集可能なテキストメタデータにのみ使用します。完全な動作と障害コードは references/preview-render.md にあります。

レンダリングの選択肢

ニーズコマンド
高速なローカル反復npx hyperframes render --quality draft
最終ローカル納品npx hyperframes render --quality high --output out.mp4
再現可能なコンテナレンダリングnpx hyperframes render --docker --strict --output out.mp4
ローカル変数駆動バッチレンダリングnpx hyperframes render --batch rows.json --output "renders/{name}.mp4"
HeyGenホスト型ゼロインフラレンダリングnpx hyperframes cloud render
自己管理型分散AWSレンダリングnpx hyperframes lambda render <project> --width 1920 --height 1080 --wait
自己管理型分散GCPレンダリングnpx hyperframes cloudrun render <project> --width 1920 --height 1080 --wait

ユーザーがローカルのChrome、FFmpeg、AWSなしでホスト型レンダリングを希望する場合は、クラウドレンダリングを使用してください。AWSの所有権が要件である場合にのみLambdaを使用します。GCPの所有権が要件である場合にのみCloud Runを使用します。クラウドパスを実行する前に、対応するリファレンスを読んでください。

レンダリングの成功を確認した後、テレメトリが無効になっていない限り、またはユーザーがオプトアウトしない限り、1つのフィードバックレポートを送信します:

npx hyperframes feedback --rating <0-10> --comment "<具体的な結果または問題点>"

正常実行のフィードバックは簡潔に保ちます。バグや問題がある場合は、送信前に再現パケットをキャプチャします。症状の概要のみを送信しないでください。再実行可能なコマンドと作業ディレクトリ、期待される動作と実際の動作、正確なエラー、出力が完了したか/フォールバックしたか/失敗したか、回避策、再現プロジェクトのステータスを含めます。問題が再現しなかった場合はその旨を述べ、それでも最後に失敗したコマンドとログを含めます。--file-issue は同意がある場合にのみ使用します。同意がある場合、最小限の再現コードを公開URLに公開します。必須のパケット形式とプライバシー警告は references/preview-render.md にあります。

コマンドを実行する前に対応するリファレンスを読む

以下のリファレンスと所有スキルは必須のコマンド契約であり、オプションの背景資料ではありません。表のコマンドを実行する前に、対応する行を読んでください。

ニーズリファレンス
init、capture、skillsreferences/init-and-scaffold.md
lint、check、モーションサイドカー、snapshotreferences/lint-validate-inspect.md
compare、grade-compare、変数駆動 render --batchreferences/compare-and-batch.md
既存プロジェクトのスタジオビートグリッド用 beatsreferences/beats.md
preview、play、render、publish、スタジオコンテキスト、フィードバックreferences/preview-render.md
doctor、ブラウザ管理references/doctor-browser.md
auth、HeyGenホスト型クラウドレンダリング、テンプレート変数references/cloud.md
AWS Lambda デプロイとレンダリングreferences/lambda.md
Google Cloud Run デプロイとレンダリングreferences/cloudrun.md
info、upgrade、compositions、docs、benchmark、テレメトリ、メディア前処理references/upgrade-info-misc.md

コンポジション変数については、/hyperframes-core → references/variables-and-media.md も読んでください。hyperframes add および hyperframes catalog については、/hyperframes-registry を使用します。hyperframes present の前は /slideshow を、hyperframes keyframes の前は /hyperframes-keyframes を読んでください。TTS、文字起こし、キャプション、または背景除去の選択肢については、/media-use を使用します。

専門コマンドは、それぞれの所有ワークフローによって意図的に文書化されています:

npx hyperframes present <project-dir> --port 3004 --no-open
npx hyperframes beats <project-dir> --json
npx hyperframes keyframes <project-dir> --json

present はプレゼンターと観客の同期を備えたナビゲーション可能なデッキを提供します。beats は references/beats.md で定義されたスタンドアロンのスタジオビートグリッドユーティリティです。keyframes はシークセーフなアニメーションおよびモーションパスの診断を提供します。

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

関連スキル