Communitygithub.com

Biznomad/claude-skills — HyperFrames CLI

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

claude-skills — HyperFrames CLI とは?

HyperFrames CLI は、`npx hyperframes` で利用可能な包括的なコマンドラインインターフェースを提供するスキルです。主な機能として、プロジェクトのスキャフォールディング(`init`)、HTML コンポジションのリンティング(`lint`)、ビジュアルインスペクション(`inspect`)、プレビュー(`preview`)、レンダリング(`render`)、環境診断(`doctor`, `browser`, `info`, `upgrade`)を網羅しています。Node.js >= 22 と FFmpeg が必須環境で、Claude Code, Cursor, Codex などの AI エージェントと連携してビデオ制作ワークフローを自動化・高速化します。各コマンドは豊富なオプション(品質選択、フレームレート、フォーマット、Docker による再現可能出力、GPU アクセラレーション、変数パラメータライズなど)をサポートし、LLM のコンテキストウィンドウに最適化された JSON 出力も提供。アセット前処理(TTS、文字起こし、背景除去)に関しては、別の `hyperframes-media` スキルに誘導します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-skills/tree/HEAD/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 の後、特に吹き出し、カード、キャプション、タイトなタイポグラフィを含むコンポジションで使用します。以下を報告します:

  • テキストが最も近いビジュアルコンテナまたは吹き出しの外側に拡張
  • テキストが自身の固定幅/固定高さのボックスでクリップ
  • テキストがコンポジションキャンバスの外側に拡張
  • 子要素がクリッピングコンテナからエスケープ

エラーはレンダリング前に修正する必要があります。警告はエージェントレビューのために表面化されます。--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フラグoffリントエラーで失敗
--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 '{"title":"Q4 レポート"}' は、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 17 individual skills — each has its own dedicated page.

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

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

関連スキル