Communitygithub.com

Biznomad/claude-skills

HyperFramesコンポジション向けアセット前処理 — テキスト読み上げ(Kokoro)、音声/動画文字起こし(Whisper)、透明オーバーレイ用背景除去(u2net)。テキストからナレーション生成、字幕用音声文字起こし、透明オーバーレイ用の動画/画像背景除去、TTS音声やWhisperモデルの選択、またはこれらを連鎖(TTS→文字起こし→字幕)する場合に使用します。各コマンドは初回実行時に独自のモデルをダウンロードします。

claude-skills とは?

Biznomad/claude-skillsは、HyperFramesコンポジションで使用するアセットを前処理するAIスキルです。提供する3つのCLIコマンド(`tts`、`transcribe`、`remove-background`)は、ローカルで動作し、APIキーを必要としません。`tts`はKokoro-82Mモデルを使用し、日本語を含む多言語のテキスト読み上げを54種類の音声で生成できます。`transcribe`はOpenAI Whisperモデル(tinyからlarge-v3)を使用して単語レベルのタイムスタンプを持つJSONを出力し、非英語音声の自動翻訳を防ぐ注意点があります。`remove-background`はu2net_human_segモデルを使用して動画や画像の背景を除去し、透過WebMやProRes 4444形式で出力可能です。特に`--background-output`オプションを使用することで、被写体の背後にテキストやグラフィックスを配置する「テキスト-被写体間」のレイヤー分割を実現します。各コマンドは初回実行時にモデルをダウンロードし、`~/.cache/hyperframes/`にキャッシュします。このスキルは、Claude CodeやCodexなどのAIエージェントがHyperFramesプロジェクトでコンポジションを構築する際に、高品質なメディアアセットを効率的に生成するために設計されています。

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

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

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

プレビュー

スキル README より

ドキュメント

HyperFramesメディア前処理

コンポジション用アセットを生成する3つのCLIコマンド:tts(音声)、transcribe(タイムスタンプ)、remove-background(透過動画)。各コマンドは初回実行時にモデルをダウンロードし、~/.cache/hyperframes/以下にキャッシュします。出力をプロジェクトに配置し、コンポジションHTMLから参照します。オーディオ/ビデオ要素の規則については、hyperframesスキルを参照してください。

テキスト読み上げ(tts)

Kokoro-82Mを使用してローカルで音声を生成します。APIキーは不要です。

npx hyperframes tts "テキスト" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma --output narration.wav
npx hyperframes tts --list                       # 全54音声を表示

音声の選択

コンテンツに合わせて音声を選択します。デフォルトはaf_heartです。

コンテンツタイプ音声理由
製品デモaf_heart/af_nova温かみがあり、プロフェッショナル
チュートリアル / ハウツーam_adam/bf_emmaニュートラルで、わかりやすい
マーケティング / プロモーションaf_sky/am_michaelエネルギッシュまたは権威的
ドキュメントbf_emma/bm_george明瞭なイギリス英語、フォーマル
カジュアル / ソーシャルaf_heart/af_sky親しみやすく、自然

多言語

音声IDの最初の文字が言語をエンコードしています:a=アメリカ英語、b=イギリス英語、e=スペイン語、f=フランス語、h=ヒンディー語、i=イタリア語、j=日本語、p=ブラジルポルトガル語、z=中国語(北京語)。CLIはプレフィックスから音素化ロケールを自動検出します。音声がテキストと一致する場合、--langは不要です。

npx hyperframes tts "La reunión empieza a las nueve" --voice ef_dora --output es.wav
npx hyperframes tts "今日はいい天気ですね" --voice jf_alpha --output ja.wav

自動検出を上書きする場合(スタイル化されたアクセント)のみ--langを使用します。有効なコード:en-us、en-gb、es、fr-fr、hi、it、pt-br、ja、zh。英語以外の音素化にはシステム全体にespeak-ngが必要です(brew install espeak-ng / apt-get install espeak-ng)。

速度

  • 0.7-0.8 — チュートリアル、複雑なコンテンツ、アクセシビリティ
  • 1.0 — 自然なペース(デフォルト)
  • 1.1-1.2 — イントロ、トランジション、活気のあるコンテンツ
  • 1.5+ — めったに適切ではありません。注意してテストしてください。

長いスクリプト

数段落を超える場合は、.txtファイルに書き込んでパスを渡します。約5分以上の音声入力は、セグメントに分割すると効果的です。

要件

Python 3.8以上、kokoro-onnxとsoundfile(pip install kokoro-onnx soundfile)。モデルは初回使用時にダウンロードされます(約311 MB + 約27 MBの音声、~/.cache/hyperframes/tts/にキャッシュ)。

文字起こし(transcribe)

単語レベルのタイムスタンプを含む正規化されたtranscript.jsonを生成します。

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model small --language es
npx hyperframes transcribe subtitles.srt          # 既存のものをインポート
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

言語ルール(譲れません)

ユーザーが明示的にオーディオが英語であると指定した場合を除き、.enモデルは絶対に使用しないでください。 .enモデル(small.en、medium.en)は、非英語のオーディオを文字起こしする代わりに翻訳して英語にします。これにより、元の言語が静かに破壊されます。

  1. 言語が既知で、英語以外 → --model small --language <コード>(.enサフィックスなし)
  2. 言語が既知で、英語 → --model small.en
  3. 言語が不明 → --model small(.enなし、--languageなし)— whisperが自動検出

デフォルトモデルはsmallであり、small.enではありません。

モデルサイズ

モデルサイズ速度いつ使用するか
tiny75 MB最速クイックプレビュー、パイプラインテスト
base142 MB高速短いクリップ、明瞭なオーディオ
small466 MB中程度デフォルト — ほとんどのコンテンツ
medium1.5 GB低速重要なコンテンツ、ノイズの多いオーディオ、音楽
large-v33.1 GB最遅プロダクション品質

ボーカル付き音楽:最低mediumから開始。制作されたトラックは、多くの場合、手動でのSRT/VTTインポートが必要です。キャプション品質チェック(すべての文字起こし後に必須)のためのクリーニングJS、再試行ルール、OpenAI/Groq APIインポートパスについては、hyperframes/references/transcript-guide.mdを参照してください。

出力形式

コンポジションは、単語オブジェクトのフラットな配列を消費します。idフィールド(w0、w1、...)は、キャプション上書き時の安定した参照のために正規化中に追加されます。下位互換性のためにオプションです。

[
  { "id": "w0", "text": "Hello", "start": 0.0, "end": 0.5 },
  { "id": "w1", "text": "world.", "start": 0.6, "end": 1.2 }
]

背景除去(remove-background)

動画または画像から背景を除去し、被写体(通常は人物 — アバター、プレゼンター、トーキングヘッド)がコンポジション内で透明なオーバーレイとして配置されるようにします。

npx hyperframes remove-background subject.mp4 -o transparent.webm  # デフォルト:VP9アルファWebM
npx hyperframes remove-background subject.mp4 -o transparent.mov   # ProRes 4444(編集用)
rm background portrait.jpg -o cutout.png       # 単一画像の切り抜き
npx hyperframes remove-background subject.mp4 -o subject.webm \
  --background-output plate.webm                                   # 1パスで両方のレイヤー
npx hyperframes remove-background subject.mp4 -o transparent.webm --device cpu
npx hyperframes remove-background --info                           # 検出されたプロバイダー

u2net_human_seg(MIT)を使用します。初回実行時に約168 MBの重みが~/.cache/hyperframes/background-removal/models/にダウンロードされます。

レイヤー分離(--background-output)

--background-output(または-b)を渡すと、切り抜きと一緒に2つ目の透明ビデオを出力します:同じソースRGB、アルファはマスクではなく255 − マスクです。切り抜きは背景が透明な被写体です。プレートは、被写体があった場所が透明な穴になった元の周囲の映像です。

ファイルアルファは…使用方法
-o subject.webmマスク — 被写体不透明、背景透明フォアグラウンドレイヤー、最前面に配置
--background-output plate.webm反転 — 周囲不透明、被写体領域透明最下層レイヤー。このレイヤーと被写体の間にテキストまたはグラフィックスを配置

両方の出力は同じ--qualityプリセットを共有し、単一の推論パスから実行されます。エンコードコストは約2倍になりますが、セグメンテーションコストは変わりません。動画入力と.webm/.mov出力でのみ有効です。

穴あきプレートであり、インペイントされたクリーンプレートではありません。 plate.webmの被写体領域は完全に透明です。その下に何か不透明なものを合成して穴を埋めてください。--background-outputが適切なツールかどうかの単一のテスト:被写体があった場所を、被写体のシルエットを通して何かが見えることはありますか?

使用例適切なツール
切り抜きとプレートの間のテキスト/グラフィックス(このコマンドが存在する理由)穴あき(--background-output)
無関係なシーンへの被写体subject.webmのみ。プレートは無視
人物_なし_の部屋を、他のコンテンツなしで単独で表示するクリーンプレート — インペインタ(LaMa、ProPainter、E2FGVI)が必要。このコマンドではありません。
被写体を別の被写体に置き換えるクリーンプレート — 上記と同じ

ユーザーが「人物を削除した部屋」を求めていて、それを単独で表示するつもりの場合、--background-outputを使用しないでください。代わりにインペインタが必要であることを伝えてください。

典型的なレイヤー構成(標準的な穴あきユースケース):

<!-- z=1 反転アルファプレートは被写体領域以外をすべて埋める -->
<video
  src="plate.webm"
  data-start="0"
  data-duration="6"
  data-track-index="0"
  muted
  playsinline
></video>

<!-- z=2 グラフィックス / テキストは2つのレイヤーの間に入る -->
<h1 id="headline" style="z-index:2; ...">MAKE IT IN HYPERFRAMES</h1>

<!-- z=3 切り抜きが被写体をヘッドラインの上にフロートさせる -->
<div class="cutout-wrap" style="position:absolute;inset:0;z-index:3">
  <video
    src="subject.webm"
    data-start="0"
    data-duration="6"
    data-track-index="1"
    muted
    playsinline
  ></video>
</div>

これは、以下のテキスト-被写体間パターンと機能的に同等ですが、プロジェクトに元のpresenter.mp4を必要としません。プレートがそれを置き換えます。これは、2つの透明レイヤーだけを出荷し、ユーザーがそれらの間に任意のコンテンツをドロップできるようにしたい場合に便利です。

出力フォーマット

フォーマットいつ
.webm(VP9 + アルファ)デフォルト。コンポジションはこれを<video>経由で直接再生します。
.mov(ProRes 4444)DaVinci/Premiere/FCPでの編集用。ファイルサイズが大きい。
.png単一画像の切り抜き(静止被写体、背景の上にレイヤー)。

ChromeはVP9アルファをネイティブにデコードするため、.webmは他のミュート自動再生ビデオと同様にコンポジションに組み込めます。<video>トラックの規則についてはhyperframesスキルを参照してください。

品質プリセット

--quality fast|balanced|bestはVP9エンコーダのCRFのみを制御します。セグメンテーション品質は固定です。

プリセットCRFいつ
fast30繰り返し作業、より小さいファイル、緩い色の一致
balanced18デフォルト。ほとんどの用途で視覚的に同一
best12マスター / 最終配信用。最大ファイル、最も厳密な一致

合成パターン — 適切なものを選ぶ

切り抜きwebmは、ソースmp4のRGBの再エンコードされたコピーです。この選択は、何をその後ろに配置するかによって結果に影響します。

パターン切り抜きの後ろにあるもの結果
異なるシーンの上に切り抜き(最も一般的)静止画像、グラデーション、または無関係な動画見栄えが良い。切り抜きのRGBが被写体の唯一のソースです。二重化やエッジハローはありません。これがremove-backgroundのために構築された機能です。
切り抜きを自身のソースmp4の上に配置(テキスト-被写体間)切り抜きが生成された元のmp4と同じ同じ人物の2つのRGBソース。デフォルトの--quality balanced(crf 18)では二重化はほとんど見えません。--quality fast(crf 30)では、かすかな色ずれ/エッジハローが見られます。マスターには--quality best(crf 12)を使用してください。
同じ人物の_別のテイク_の上に切り抜き同じ被写体の映像まるで2人の別々の人物が重なっているように見えます。これは行わないでください。

テキスト-被写体間(プレゼンターの後ろのヘッドライン):

<video
  src="presenter.mp4"
  id="bg"
  data-start="0"
  data-duration="6"
  data-track-index="0"
  muted
  playsinline
></video>
<h1 id="headline" style="z-index:2; ...">MAKE IT IN HYPERFRAMES</h1>
<div class="cutout-wrap" style="position:absolute;inset:0;z-index:3;opacity:0">
  <video
    src="presenter.webm"
    data-start="0"
    data-duration="6"
    data-track-index="1"
    muted
    playsinline
  ></video>
</div>

2つの重要なルール:

  1. 切り抜きビデオをタイミングのない<div>でラップし、ラッパーの不透明度をアニメーション化します。ビデオ要素自体はアニメーション化しないでください。フレームワークはアクティブなクリップ(data-start/data-durationを持つ要素)に不透明度1を強制するため、ビデオの不透明度を直接アニメーション化すると静かに上書きされます。ラッパーにはdata-*属性がないため、CSS/GSAPによって制御されます。
  2. 両方のビデオでdata-start="0"とdata-media-start="0"を使用すると、フレームワークがt=0から同期してデコードします。切り抜きを遅れてマウントする(data-start=3.3)と、シーク+ウォームアップが発生し、ベースmp4から1フレームずれた状態で着地します。カットで1フレームの位置ずれとして見えます。

次に、GSAPでカット時にラッパーの不透明度を反転させます:tl.set(cutoutWrap, { opacity: 1 }, 3.3)。

TTS → 文字起こし → キャプション

録音済みのナレーションがない場合、ナレーションを生成し、それを文字起こしして字幕用の単語レベルのタイムスタンプを取得します:

npx hyperframes tts script.txt --voice af_heart --output narration.wav
npx hyperframes transcribe narration.wav   # → transcript.json

出力 transcript.json は音声と一致するタイムスタンプを持ちます。これをコンポジションに渡して、各単語にキャプションをオーバーレイします。hyperframes スキルの <hype-captions> 要素の規約を参照してください。

バックグラウンド除去 GPU サポート

remove-background は、利用可能な場合、GPU(CUDA / MPS)を自動的に使用します。CPU を強制するには --device cpu を渡します。また、--info を使用すると、現在のシステムでどのプロバイダーが検出されたかを確認できます。

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

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

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.

関連スキル