yuv-viral-video は何をしますか?
YUV.AIのシグネチャーバイラルショートパイプラインです。2つのスキルが連携して動作します:
video-use— ElevenLabs Scribeを使ってソースを文字起こしし、単語単位のカットを選択し、セグメントを抽出・結合してbase.mp4を生成します。これがカットと基本レイアウトレイヤーです。hyperframes— ベース動画をバックグラウンドとして使用し、HTML/CSS/GSAPで視覚合成レイヤーを追加します。本物のbackdrop-filterを使ったリキッドグラスカード、back.outのバネのようなイージングを使ったGSAPモーショングラフィックス、単語ごとのカラオケキャプション、シーン遷移を実装し、Chromiumを介してMP4にレンダリングします。
両方を使用する必要があります。 独自のPILベースのカードを作成したり、ぼかしをPNGにプリベイクしたり、独自のffmpegコンポジターを作成したりしないでください。hyperframesスキルは、ハリウッド品質の視覚レイヤーを実現するために特別に存在します。
コンパニオンスキル(開始前にこれらを読んでください)
両方のコンパニオンスキルはローカルにインストールされており、セッション開始時にClaude Codeによって自動検出されます。これらのガイドラインを読み込み、適用する必要があります — このスキルはそれらの上に重なるエディトリアルレイヤーであり、置き換えるものではありません。
| スキル | パス | 担当範囲 |
|---|---|---|
video-use | ~/.claude/skills/video-use/SKILL.md(シンボリックリンク → ~/Developer/video-use) | 文字起こし(ElevenLabs Scribe)、単語単位のカット、カラーグレーディング、ffmpegの正確性(セグメントごとの抽出 → -c copy 連結、30msのオーディオフェード、setpts=PTS-STARTPTS+T/TB オーバーレイ、出力タイムラインのSRTオフセット、トランスクリプトのキャッシュ)。edl.jsonを作成する前に、**「ハードルール(プロダクションの正確性 — 交渉不可)」**セクションを読んでください。ヘルパーは~/Developer/video-use/helpers/にあり、python helpers/<name>.pyとして呼び出します。 |
hyperframes | ~/.claude/skills/hyperframes/SKILL.md | HTMLを信頼できる情報源とする動画合成、data-*タイミング属性、CSS駆動の表示、フレーム精度のライブラリクロックアニメーション(GSAP、Lottie、Motion One)。コンポジションindex.htmlを作成する前に、コンパニオンドキュメントhouse-style.md、data-in-motion.md、patterns.md、visual-styles.mdを読んでください。 |
hyperframes-cli | ~/.claude/skills/hyperframes-cli/SKILL.md | hyperframes init / lint / preview / render / transcribe / tts コマンド。CLIはグローバルにもインストールされているため($PATH上のhyperframes)、npxはオプションです。 |
gsap | ~/.claude/skills/gsap/SKILL.md | GSAPアニメーションの全語彙。このドキュメントのback.out(1.7)バネのようなイージングルールは適用されたパターンの1つです。素材が必要とする場合は、gsapの完全なツールキットを使用してください。 |
website-to-hyperframes | ~/.claude/skills/website-to-hyperframes/SKILL.md | ワンショット: URLをスクレイピング → hyperframesコンポジション。ソースに再現する価値のある画面上のUIがある場合に便利です。 |
優先順位(このドキュメントとコンパニオンスキルが矛盾する場合)
- プロダクションの正確性(カット、エンコード、ffmpegフラグ、ffmpegフィルターの順序、トランスクリプトの処理) → コンパニオンスキルが優先されます。
video-useが「字幕はすべてのオーバーレイの後、フィルターチェーンの最後に適用される」と述べており、このドキュメントがそれについて言及していないか異なる場合、video-useの指示に従ってください。hyperframes APIの規約、data-*属性、フレームアダプターパターンについても同様です。 - エディトリアルスタイル(フォント、ガラスカード、「顔を決して覆わない」、
_V<N>バージョニング、アーキタイプレイアウトの決定、MrBeastのペース、コンテンツ作成禁止ルール) → このドキュメントが優先されます。 コンパニオンスキルは意図的にスタイルに依存しません。YUV.AIのハウススタイルはこちらにあります。 - 戦略の確認:
video-useのハードルール11は「実行前に平易な英語で計画を確認する」と述べています。YUV.AIスタイルのバイラルショートの場合、これは意図的に一時停止されています — スタイルはこのドキュメントのハードルールに完全に捉えられているため、エージェントはクリエイティブな方向性の質問でブロックするのではなく、最初のパスを実行し、フィードバックから繰り返し改善する必要があります。(バイラル以外のvideo-useセッションでは、コンパニオンスキルのルールに従ってください。) - カットエッジのパディング:
video-useは30~200msを許可しています。このドキュメントはその範囲内でYUV.AIのデフォルトとして50msの先頭/80msの末尾を選択します。両方とも正しく、より狭い値はスタイルの選択です。
共有設定
両方のスキルは、~/Developer/video-use/.envからELEVENLABS_API_KEYを読み取ります。一度設定すれば、両方のスキルで機能します。このスキルのディレクトリにキーを複製しないでください。
保存場所
デフォルト: ~/Documents/yuv-projects/videos/<slug>/ — バイラル動画プロジェクトは常にここに保存し、レンダリング結果を見つけられるようにします。<slug>は短く、トピックまたはソースファイル名から派生させます。
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# ここでプロジェクトを初期化します。
hyperframes init <slug> --video <source.mp4> --non-interactive
cd <slug>
最終レンダリングは~/Documents/yuv-projects/videos/<slug>/renders/final_*_V<N>.mp4(9:16と16:9の両方)に保存されます。レンダリングのたびに、ユーザーに動画の場所を伝えてください。
スタイル設定(必須のデフォルト — yuv-design-systemから継承)
このスキルは、Yuval Avidaniのブランドシステムの動画インスタンス化です。ソースコンテンツによってブランドやパレットが明示的に指定されていない場合は常に、これらのデフォルトが適用されます。これらは、矛盾するコンパニオンスキルのデフォルトを上書きします。
タイポグラフィ
| 役割 | 英語 | ヘブライ語 | ルール |
|---|---|---|---|
| 見出し / カード / カラオケキャプション | Anton(大文字、ウェイト400 + タイトなトラッキング-0.02emから-0.04em) | Rubik Black(ウェイト900) | 英語は常に大文字、タイトルケースは禁止。ヘブライ語の表示テキストは常にウェイト900。 |
| 本文 / ガラスカードのボディコピー / チップテキスト | Inter(400 / 500 / 600 / 700) | Assistant(400 / 500 / 600 / 700) | カードに見出しの下にセカンダリのボディコピーがある場合のみ使用。カード内の行間は1.4。 |
| 数字 / カウンター / 統計 | Anton | Rubik Black | 数字は本文ではなく、見出しテキストとして扱います。 |
| コード / 等幅(ターミナルカード、パス) | JetBrains Mono | — | タイプライター風のコード表示用。 |
ヘブライ語の方向: すべてのヘブライ語キャプションコンテナにdir="rtl"を設定します。PILのフォールバックパスでのみpython-bidiのget_display()を使用します。CSSはRTLをネイティブに処理します。論理CSSプロパティ(margin-inline-*、padding-inline-*)が物理プロパティ(margin-left)よりも優先されます。
禁止: セリフフォントのデフォルト使用、system-uiスタック、ヘブライ語テキストへのAntonの適用(中抜きのXとしてレンダリングされます — Antonはラテン語のみ)。
カラーパレット
YUV.AIの標準パレットとその動画チューニング版:
| 役割 | Web標準 | 動画レンダリング(MP4内部で使用) | なぜ変更するか |
|---|---|---|---|
| オフホワイト / ペーパー | #FAFAF7 | #F5F0E1(より暖かい) | テキストストロークのある暗いステージ上でより暖かく読めます。H264での「青白いグレア」効果を低減します。 |
| イエロー / アクセント | #E5FF00 | #FFE61E | わずかに彩度が高く、小さなサイズでも黒いテキストストロークを突き抜けます。 |
| ピンク / ブランドスレッド | #FF1464 | #FF1464 | 同じ。ガラスカードのボーダーアクセント、キーモーメントのストリップストローク、ブランドスレッドとして使用します。 |
| ブラック / ステージ | #0A0A0A | #0c0e16(暖かみのあるニアブラック) | H264での純粋な黒のバンディングを回避します。 |
| チャコール / 明るい背景のテキスト | #1A1A1A | — | UIオーバーレイのみ(プレビューページ、レンダリングされたMP4の内部では決して使用しません)。 |
| ボーン / クリーム | #F5EEE4 | — | Webページのみ、MP4内部では決して使用しません。 |
レンダリング出力で禁止:
- 純粋な
#FFFFFF— 常により暖かいオフホワイトに置き換えてください。 - 青のアクセント(ネイビー、スレート、インディゴ、クールグレー)。ソースブランドが要求する場合を除きます。
- デフォルトのTailwindパレット名(
slate-*、zinc-*、gray-*、emerald-*、cyan-*、indigo-*、violet-*、rose-*)。 - マルチカラーアイコンセット — PhosphorまたはLucideのシングルストロークのみ。
レイアウトとモーションのデフォルト
- ボーダー半径: ガラスカードは
40–56px(シグネチャーのソフトラウンド)。ピル型CTAは999px。8/12pxのコーポレートラウンドの中間領域は絶対に使用しないでください。 - シャドウ: 暖色系(ピンク/オレンジのアンダートーン) — ガラスカードには
0 20px 60px rgba(255, 20, 100, 0.12)、デフォルトの青黒rgba(0,0,0,.1)は絶対に使用しないでください。 - ホワイトスペース: たっぷりと。カードがフレームの空き領域の60%以上を占めることは決してありません。
- 非対称性がグリッド完全性よりも優先されます。 カードをオフセットする。重ねる。1つの要素がグリッドを破る。
- グレイン: プレビュー/カタログページでは1~2%のノイズ(レンダリングされたMP4内部では使用しないでください — 圧縮で台無しになります)。
- アニメーションライブラリ: GSAP(常に)。カードのエントランスには
back.out(1.7)、SplitTextの表示にはpower3.out、スラムビートにはexpo.out、アイドルフロートにはsine.inOut。
継承ルール
補助的なサーフェス(プレビューページ、カタログ、ダッシュボード、レンダリングステータスUI)を構築する場合は、完全なyuv-design-systemスキルのデフォルト — Anton + Interのタイポグラフィ、デフォルトのFly Highパープルパレット、シグネチャーコンポーネント、ブランドアセット — を適用してください。yuv-design-systemは、Yuvalブランドのビジュアルに関する信頼できる情報源です。
MP4自体をレンダリングする場合は、上記の表の動画チューニング値を適用してください。同じブランド、2つの配信サーフェス。
ライブエフェクトカタログ(メニューとして使用)
Yuvalは、このスキルが動画に適用できるすべてのエフェクト、トランジション、マーカー、カード、テーマ、SFXの公開ライブスクロール可能なビジュアルカタログを維持しています:
編集を依頼する際、Yuval(または彼がカタログを送る人)は、任意のエフェクトのチップをクリックします。チップはcaptions.karaoke.scale-popのような安定した識別子をクリップボードにコピーします。彼はそれらのIDをプロンプトに貼り付けます:
"これを
style.swiss-pulse、キャプションkaraoke.scale-pop、統計にmarker.circle、トランジションblur-crossfade、すべてのカットにsfxwhoosh、ヒーローワードにsfximpactで編集してください。"
ユーザーが貼り付けたすべてのエフェクトIDを尊重する必要があります。 カタログページは唯一の信頼できる情報源です — すべてのIDは、検証された動作を持つ文書化されたエフェクトにマッピングされます。ユーザーが認識できないIDを指定した場合は、カタログ(https://effects.yuv.ai)を取得して定義を見つけ、即興で対応しないでください。
カタログにはプロンプトライブラリ(effects.yuv.ai #prompts)も含まれており、8つのプロダクション対応のフル編集プロンプト(プロダクトローンチ / 説明動画 / ライブコーディング / フローのウォークスルー / ホットテイク / チュートリアル / ファウンダーピッチ / ヘブライ語のトーキングヘッド)があります。ユーザーが「Xシナリオ用のプロンプト」を参照した場合は、そこにルーティングしてください。
バイリンガルレンダリング — 同じ動画内でのヘブライ語と英語
多くの編集では、ヘブライ語のナレーションと英語のブランドトークン(Claude、GitHub、hyperframesなど)が混在します。スキルは以下を行う必要があります:
-
グリフごとのフォントルーティング — Antonがラテン語を処理し、Rubik Blackがヘブライ語を処理します。すべてのテキストコンテナの単一の
font-family: 'Anton', 'Rubik', sans-serif宣言がこれを自動的に行います。ヘブライ語の文字にAntonを適用しないでください(中抜きのXとしてレンダリングされます — Antonはラテン語のみ)。 -
RTLコンテナ — すべてのヘブライ語キャプション行は、そのコンテナに
dir="rtl"を設定します。英語のブランドトークンは、ブラウザの双方向アルゴリズムを介して同じ行内でLTRのままになります。手動での並べ替えは不要です。 -
ヘブライ語でのブランド名のスペル — Yuvalが好むヘブライ語の音訳:
- "Claude" → "קלוד"("קלאוד"ではない)
- "Hyperframes" → 英語のまま("Hyperframes")
- "GitHub" → 英語のまま("GitHub")
- Scribeがブランド名を間違ったヘブライ語のスペルで文字起こしした場合は、カラオケレイヤーを生成する前に、文字起こし後のパスで修正してください。
-
コンパニオンカタログはすべての場所でバイリンガルEN/HE — ライブカタログは、トグルでUI全体をヘブライ語に切り替えます(effects.yuv.ai参照)。同じ
data-langトグルパターンは、このスキルが生成する補助的なサーフェス(プレビューページ、レンダリングステータスUIなど)に適用されます。
プロダクションイテレーションから学んだ教訓
以下は実際のセッションから学んだものであり、現在は~/.claude/skills/yuv-design/lessons-learned.mdにあります。補助的なフロントエンド(プレビューページ、レンダリングダッシュボード、カタログ)を構築する前に、そのファイルを読んでください。動画パイプライン自体は以下のハードルールによって管理されますが、このスキルが生成するHTML/CSSサーフェスは以下を尊重する必要があります:
- バイリンガル = トグル、並列ではない(
lessons-learned.mdの教訓 #1) - モバイル = ≤880pxでハンバーガーナビ(教訓 #2)
- セクションごとに1つの見出し(教訓 #3)
document.titleは言語トグルの一部(教訓 #5)- 8つ以上のデモがあるカタログにはIntersectionObserver(教訓 #9)
- 最初のパスで包括的に構築 — スコープをイテレーションしない(教訓 #10)
- SPAには
Claude-in-Chrome、静的HTMLにはWebFetchのみ(教訓 #7、#15) - 実際のソースページからコンテンツを確認し、決して invent しない(教訓 #8)
このスキルを参照するタイミング
ユーザーが動画ファイルをドロップして編集を依頼するたびに。"これを持って編集してください: <パス>" のような1行の依頼でも、以下の完全なフローをトリガーする必要があります。事前にクリエイティブな方向性を尋ねないでください — ユーザーのスタイルは以下のハードルールに捉えられています。実行し、フィードバックから繰り返し改善するだけです。
何かに触れる前に内部化すべき3つのこと
1. コンテンツを絶対に invent しないでください。 すべてのカードの単語は、話者がトランスクリプトで実際に言ったことに基づいている必要があります。偽の通貨プレースホルダー("$$$")、偽のパーセンテージ("100% 理解")、リンクが約束されていないのに invent されたCTA("link in bio")は禁止です。ユーザーは invent されたコンテンツを瞬時に見抜き、信頼は急速に失われます。疑わしい場合は、文字通りのヘブライ語の引用をカードにコピーしてください。同じルールがブランド名のヘブライ語音訳にも適用されます。例えば、ブランドが"Claude"の場合、適切なヘブライ語は...
...(原文が途中で切れていますが、翻訳を続けます)
2. 最初から正しくやる — スコープをイテレーションしないでください。 バイラル動画編集は、複数のパスにわたってスコープを追加すると、一貫性がなくなり、ブランドから逸脱する傾向があります。すべての要素(カード、キャプション、トランジション、SFX、モーショングラフィックス)を最初のパスで計画して実行してください。ユーザーが「これは多すぎる」と言った場合にのみ削減し、後から追加するために「とりあえずシンプルに」はしないでください。これはYUV.AIのプロダクションスタイルです。
3. 顔を決して覆わないでください。 動画が話者の顔を含む場合、すべてのカード、キャプション、グラフィックオーバーレイは、顔の周りに配置されるか、十分に透明である必要があります(backdrop-filterがここで役立ちます — 実際のぼかしガラスの効果は、顔を隠さずにオーバーレイを読みやすくします)。もし疑わしい場合は、カードを下の3分の1に移動するか、話者が一時停止したときだけ表示するようにしてください。
ハードルール(プロダクション — 交渉不可)
これらのルールは、すべてのYUV.AIバイラル動画編集を管理します。これらは以前のコンパニオンスキルドキュメントの優先順位に優先します。
- 常に
hyperframes initでプロジェクトを初期化し、ベースビデオを設定してください。手動でHTMLファイルを作成しないでください — hyperframes CLIがプロジェクトの構造を設定します。 - 常に video-useから
base.mp4を生成し、それをhyperframesの背景ビデオとして使用してください。ビデオを空のキャンバスに直接配置しないでください。 - 常に GSAP(
back.out(1.7)イージング)を使用してカードとテキストのアニメーションを行ってください。CSSトランジションやrequestAnimationFrameループは使用しないでください。 - 常に
font-family: 'Anton', 'Rubik', sans-serifをすべてのテキストコンテナに適用してください。 - 常に レンダリングの前にヘブライ語のテキストが正しい方向(
dir="rtl")であることを確認してください。 - 常に 両方のアスペクト比(9:16 と 16:9)をレンダリングし、
_V<N>サフィックス(_V1、_V2など)を付けてバックアップを保存してください。 - 決して 話者の顔をカードやグラフィックで覆わないでください。
- 決して 話者が言っていないコンテンツを invent しないでください。
- 常に レンダリングの最後にユーザーに最終動画の場所を伝えてください。
- 決して このパイプラインをポッドキャスト専用のオーディオ編集に使用しないでください —
video-useスキルを単独で使用してください。
YUV.AI バイラル動画パイプライン — スタイルと正確性で動画を編集します。