Communitygithub.com

HyperFrames CLI

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

HyperFrames CLI とは?

HyperFrames CLI スキルは、AIエージェント(Claude Code、Cursor、Codexなど)が HyperFrames ビデオ制作プロジェクトを効率的に管理・操作するための統合コマンドラインインターフェースを提供します。Node.js >= 22 と FFmpeg が必要で、`npx hyperframes` を実行することで全ての操作が行えます。主なワークフローとして、`init` によるプロジェクトスキャフォールディング、`lint` による静的検証(data-composition-id の欠落、トラックの重複、未登録タイムラインの検出)、`inspect` によるビジュアル検査(テキストのはみ出しやクリッピングの検出)、`preview` によるホットリロード対応のプレビュー、`render` による最終出力(MP4/WebM、品質設定、パラメータ化レンダリング対応)を提供します。さらに、`doctor` による環境診断(Chrome、FFmpeg、Node、メモリ)、`browser` によるバンドル Chrome の管理、`info` によるバージョン情報の表示、`upgrade` によるアップデート確認といったトラブルシューティングコマンドも含まれています。AIエージェントはこのスキルを通じて、開発ループの各段階で適切なコマンドを実行し、エラーを修正し、最終的なビデオ出力を生成することができます。

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

Linting

npx hyperframes lint                  # カレントディレクトリ
npx hyperframes lint ./my-project     # 特定のプロジェクト
npx hyperframes lint --verbose        # 情報レベルの検出結果
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 を追加してください。繰り返しの静的問題はデフォルトで折りたたまれ、JSON 出力は LLM のコンテキストウィンドウのためにコンパクトに保たれます。オーバーフローが出入りアニメーションのために意図的な場合は、要素または祖先に 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, highstandardイテレーション時は draft
--formatmp4, webmmp4WebM は透明度をサポート
--workers1-8 または autoauto各ワーカーが Chrome を起動
--dockerフラグoff再現可能な出力
--gpuフラグoffGPU 加速エンコーディング
--strictフラグofflint エラーで失敗
--strict-allフラグoffエラーと警告の両方で失敗
--variablesJSON オブジェクト—data-composition-variables で宣言された変数値を上書き
--variables-fileパス—変数値を含む JSON ファイル(--variables の代替)
--strict-variablesフラグoff--variables で未宣言のキーまたは型不一致でレンダリングを失敗させる

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

パラメータ化レンダリング: コンポジションは <html> ルートに data-composition-variables を使用して変数を宣言します。これはスキーマを定義する宣言の JSON 配列(エントリごとに {id, type, label, default})です。内部のスクリプトは window.__hyperframes.getVariables() を介して解決された値を読み取ります。CLI の **`--variables '{

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-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.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

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

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-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.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

関連スキル