Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

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

Tony-Claude-Code-Skills とは?

HyperFrames CLI スキルは、ビデオ合成アプリケーションの開発ライフサイクル全体をサポートするコマンドラインインターフェースです。このスキルは、スキャフォールディング(`init`)、リンティング(`lint`)、ビジュアルインスペクション(`inspect`)、プレビュー、レンダリング、そして環境トラブルシューティング(`doctor`、`browser`、`info`、`upgrade`)といった、主要な開発ワークフローコマンドをカバーします。特に、`lint` はデータ属性の欠落やオーバーラップトラックを検出し、`inspect` はヘッドレス Chrome でレイアウト問題(テキストのはみ出し、クリッピングなど)を視覚的にチェックします。このスキルは、開発者や AI エージェントが HyperFrames プロジェクトを効率的に構築・デバッグ・レンダリングするために不可欠であり、Node.js >= 22 および FFmpeg が必要です。また、パラメータ化されたレンダリング機能により、変数を使って同じコンポジションを異なる値でレンダリングできます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-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 --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 を使用します。

リンティング

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 の後に使用します。特に吹き出し、カード、キャプション、タイトなタイポグラフィを持つコンポジションに適しています。以下を報告します:

  • 最近傍のビジュアルコンテナまたは吹き出しの外側に extends するテキスト
  • 自身の固定幅/高さボックスでクリッピングされたテキスト
  • コンポジションキャンバスの外側に extends するテキスト
  • クリッピングコンテナから escaped する子要素

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

互換性エイリアスとして npx hyperframes layout も引き続き利用可能で、同じビジュアルインスペクションパスを実行します。

プレビュー

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

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

プロジェクトをユーザーに戻す際は、ソースの 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/名前_タイムスタンプ.mp4出力パス
--fps24, 30, 603060fps はレンダリング時間が2倍に
--qualitydraft, standard, highstandarddraft はイテレーション用
--formatmp4, webmmp4WebM は透明度をサポート
--workers1-8 または autoauto各ワーカーが Chrome を起動
--dockerフラグoff再現可能な出力
--gpuフラグoffGPU アクセラレーションエンコーディング
--strictフラグoffリントエラーで失敗
--strict-allフラグoffエラーと警告の両方で失敗
--variablesJSON オブジェクト—data-composition-variables で宣言された変数値を上書き
--variables-fileパス—変数値を記述した JSON ファイル(--variables の代替)
--strict-variablesフラグoff--variables で未宣言のキーや型不一致があるとレンダリングに失敗

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

パラメータ化レンダリング: コンポジションは <html> ルートに data-composition-variables で変数を宣言します — エントリごとに {id, type, label, default} という JSON 宣言の配列でスキーマを定義します。スクリプトは window.__hyperframes.getVariables() を介して解決済みの値を読み取ります。CLI の --variables '{"title":"第4四半期レポート"}' は 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 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-Skills

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.

shengdabai/Tony-Claude-Code-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.

関連スキル