Communitygithub.com

Biznomad/agent-skills

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

agent-skills とは?

このスキルは、HyperFrames コンポジション用のマルチメディアアセットをローカルで前処理するための3つの CLI コマンドを提供します。1つ目は Kokoro-82M TTS エンジンを使ったテキスト読み上げ(tts)で、54の多言語音声と速度調整に対応しています。2つ目は Whisper を使用した文字起こし(transcribe)で、単語レベルのタイムスタンプを持つ transcript.json を生成します。3つ目は u2net_human_seg を用いた背景除去(remove-background)で、被写体を透明オーバーレイとして抽出し、さらに hole-cut プレートも生成できます。各コマンドは初回実行時にモデルを自動ダウンロードし、~/.cache/hyperframes/ にキャッシュされます。出力は HyperFrames のコンポジション HTML で直接参照可能で、TTS → 文字起こし → キャプションの連鎖処理もサポートしています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-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": "こんにちは", "start": 0.0, "end": 0.5 },
  { "id": "w1", "text": "世界。", "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(編集用)
w hyperframes remove-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 − mask です。切り抜きは背景が透明な被写体です。プレートは被写体があった場所に透明な穴が空いた元の周囲です。

ファイルアルファは…使用目的
-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; ...">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同じ人物の RGB ソースが2つ。デフォルトの --quality balanced(crf 18)では二重化はほとんど見えません。--quality fast(crf 30)ではかすかな色ずれ/エッジハローが見える可能性があります。マスター用に --quality best(crf 12)を使用。
同じ人物の_別テイク_に重ねる同じ被写体の別の映像別々の人物が重なっているように見えます。行わないでください。

テキスト背後被写体(プレゼンターの後ろに見出し):

<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; ...">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 を持つ要素)に対して opacity: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

これにより、ナレーション(narration.wav)と単語レベルのタイムスタンプ(transcript.json)の両方が得られます。transcript.json を hyperframes スキルのキャプションレンダラに渡すと、ナレーションと完全に同期したクローズドキャプションが生成されます。

パイプライン内の各ステップは独立して再実行可能です。ナレーションを編集した場合は transcribe を再実行するだけでキャプションを更新できます。

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

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

関連スキル