Communitygithub.com

動画編集 — 字幕付きショーケースパイプライン

任意の動画を、字幕付きのショーケースに編集します。文字起こし(多言語対応、デフォルトはlarge-v3)を行い、ユーザーがレンダリング前に修正できるtranscript_review.txtを提示し、HyperFramesコンポジションでリキッドガラス風キャプションピル、リキッドブラー背景、リキッドモーフワイプ、オプションの背景除去による被写体背後テキストなどを組み合わせて最終動画をレンダリングします。

動画編集 — 字幕付きショーケースパイプライン とは?

このスキルは、HyperFramesをベースにしたエンドツーエンドの字幕付き動画編集パイプラインです。ユーザーが動画ファイルを提供し、「編集」「字幕追加」「リール作成」「チュートリアル制作」などを依頼した際に呼び出されます。特に、レンダリング前に必ず文字起こしのレビュー工程を挟み、ユーザーが誤認識を修正してから最終出力を行う点が特徴です。対応言語は英語、ヘブライ語、およびWhisperがサポートするすべての言語です。同一の16:9ソースから、16:9(YouTube/横長)と9:16(TikTok/Instagram Reels/YouTube Shorts)の両方をレンダリング可能で、縦長モードでは中央に配置された映像ストリップにぼかし背景+リキッドブラーと縦長用に調整されたキャプションピルを組み合わせるため、再撮影は不要です。このパイプラインは、YUV.AIのスキルピラミッドの中間層に位置し、yuv-pilotオーケストレーターからルーティングされるか、スタンドアロンで動作します。常に`~/Documents/yuv-projects/videos/<slug>/`にプロジェクトを保存し、最終レンダリングは`renders/<name>_FINAL.mp4`に出力されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/video-edit

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

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

ドキュメント

動画編集 — 字幕付きショーケースパイプライン は何をしますか?

HyperFrames上で動作する、エンドツーエンドの字幕付き動画エディターです。ユーザーが動画を提供すると、文字起こし → レビュー → レンダリングの順に自動化し、長時間のレンダリングの前に必ず文字起こしの承認を待ちます。

YUV.AIピラミッドにおけるこのスキルの位置づけ

video-edit は、YUV.AIスキルピラミッドの中間層に位置し、yuv-design-system、yuv-decks、yuv-viral-video、parallax-landing-page、video-to-landing-page と同じ階層です。トップ層のオーケストレーター yuv-pilot は、ユーザーが字幕付きショーケース、チュートリアル、または字幕付きトーキングヘッド動画の編集を希望する場合に、このスキルにルーティングします。

これは、より汎用的な動画編集スキルであり、yuv-viral-video の兄弟にあたります。役割分担は以下の通りです。

  • yuv-viral-video — YUV.AIバイラルショート専用のパイプライン(MrBeast風のテンポ、独自の編集スタイル)
  • video-edit — 汎用的な字幕エディター。レンダリング前に文字起こしレビューを行います(ヘブライ語 + 英語 + あらゆるWhisper対応言語)

YUV.AIブランドの字幕付き動画の場合は、このスキルを yuv-design-system(ネオンモードのタイプ/パレット決定)と組み合わせて使用します。汎用的な/サードパーティ向けの字幕付き動画の場合は、このスキル単体で動作します。

呼び出すタイミング

  • 動画ファイル(mp4/mov/mkv)のパスと、「編集」「字幕追加」「リール作成」「プロモーション制作」「同じようにして」といったリクエストがあった場合
  • 「字幕を修正/ヘブライ語のスペルミスを修正」— 既存プロジェクトのレビューステップから再開する場合
  • 字幕付きチュートリアル / トーキングヘッド / プロモーション動画の制作

保存場所

デフォルト: ~/Documents/yuv-projects/videos/<slug>/ — 字幕付き動画プロジェクトは常にここに保存し、レンダリング結果を見つけやすくします。<slug> は短い識別子で、トピックやソースファイル名から生成します。

mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# ここでプロジェクトを初期化します。

最終レンダリングは ~/Documents/yuv-projects/videos/<slug>/renders/<name>_FINAL.mp4 に出力されます。レンダリング終了時にユーザーに動画の場所を伝えます。


ワークフロー(12ステップ)

  1. ソース調査 — ffprobe で解像度、fps、長さ、オーディオを確認します。

  2. スキャフォールド作成 — cd ~/Documents/yuv-projects/videos && npx hyperframes init <slug> --video <path> --non-interactive を実行。コピーされた動画を source.mp4 にリネームします。

  3. オーディオ抽出 — ffmpeg -i source.mp4 -vn -ac 1 -ar 16000 audio.wav を実行。

  4. 文字起こし — references/transcribe.py をプロジェクトにコピーします。デフォルトモデルは large-v3(ヘブライ語に最適)。CUDAはWindowsでは通常失敗します(cuDNN不足)。その場合、スクリプトはCPU int8にフォールバックします。ヘブライ語の場合は language="he"、英語の場合は language="en" を強制指定。それ以外の言語は自動検出します。

  5. 既知の誤りを修正 — references/corrections-hebrew.md の内容をプロジェクトルートの corrections.json にコピーします(キー = 誤ったトークン、値 = 正しいトークン)。

  6. 🛑 停止 — レビューサーバーを起動し、ユーザーがWebアプリで承認するのを待ちます。 まず既知の修正を適用します。references/make_review.py をプロジェクトにコピーして実行します。 python make_review.py これにより corrections.json が transcript.json に適用されます。

    次に、レビューサーバーを バックグラウンドタスクとして 起動します(ユーザーがブラウザで「承認してレンダリング」をクリックするまでブロックされます)。

    python "$HOME/.claude/skills/video-edit/references/serve_review.py" .
    # Windowsの場合: python "C:\Users\<ユーザー名>\.claude\skills\video-edit\references\serve_review.py" .
    

    サーバーは REVIEW_URL=http://localhost:PORT/ のような行を出力します。バックグラウンドタスクの出力(またはstdout)からそのURLを取得し、ユーザーに次のように送信します。

    👉 ここで文字起こしを確認してください: http://localhost:PORT/ 「承認してレンダリング」をクリックすると、自動的に続行します。

    エージェントは 「続行」メッセージを必要としません — ユーザーがボタンをクリックすると、サーバーはプロジェクトディレクトリに transcript_review.txt を書き込み、コード0で終了します。エージェントのバックグラウンドタスク通知が発火し、パイプラインはステップ8から再開します。

    ブラウザがない/サーバーが使えない場合のフォールバック: エディターを静的ファイルとして開きます(start "" "$HOME/.claude/skills/video-edit/transcript-editor/index.html")。ユーザーにプロジェクトフォルダを選択させ、編集して transcript_review.txt をプロジェクトに保存し、「続行」と返信するよう依頼します。エディターは両方のモードをサポートしています。

  7. (オプション)背景除去 — 下記ステップ7を参照。ユーザーのレビューと並行して実行できます。

  8. 承認後、python references/apply_review.py を実行します。編集された行を再トークン化し、単語のタイミングを transcript.json に再配分して、キャプション同期が機能するようにします。

  9. (オプション)背景除去 — 被写体の背後にテキストを配置する必要があるトーキングヘッドセグメントがある場合、セグメントを outro.mp4(または intro.mp4)として抽出し、npx hyperframes remove-background <clip>.mp4 -o <name>_subject.webm --quality best を実行します。多くの環境ではCPUのみ使用(1440pで約15秒のクリップの場合、約3~8分)。

  10. ソースを高密度キーフレームで再エンコード — マルチワーカーレンダリングは、キーフレームが疎だとフリーズします。常に以下を実行してください。

    ffmpeg -y -i source.mp4 -c:v libx264 -preset medium -crf 18 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -pix_fmt yuv420p -movflags +faststart -c:a copy footage.mp4
    
  11. (編集済み)文字起こしを再読み込み し、references/gen_body.py でボディサブコンポジションを生成します。ジェネレーターは、compositions/components/caption-body.html に、エディトリアルスタイルとマトリックススタイルを交互に配置したリキッドガラス風キャプションピルを出力します。アンカーは左下中央寄り(右下のウェブカムPiPと重ならないようにします)。

  12. ホスト index.html を references/host-template.html からワイヤリングします。レイヤー順序(z-index、トラックインデックスではありません):

    • z0: フッテージ .cam-bg
    • z1: リキッドブラー背景(compositions/liquid-blobs.html、mix-blend-mode: screen、全長)
    • z2: 被写体背後パララックスキャプション(背景除去を使用した場合のイントロおよび/またはアウトロ)
    • z3: 被写体切り抜き .cam-out / .cam-sub(対応する data-media-start 付き)
    • z6: ボディキャプション
    • z46: プログレスバー + フラッシュ + リキッドモーフワイプ
  13. リント — npx hyperframes lint を実行。エラーは0でなければなりません。よくある修正: ワイプ要素でのGSAP/CSS transform競合(xPercent/yPercent を使用するか、CSS transformを削除)、同じプロパティでのトゥイーン重複(overwrite: "auto" を追加)。

  14. レンダリング — npx hyperframes render --quality standard --fps 30 --output renders/<name>_FINAL.mp4 を実行。Standard が適切なデリバリ品質です。high にするとレンダリング時間が約2倍になります。完了報告の前に、タイムライン全体から6~8フレームをスポットチェックで確認します。

縦長(9:16)出力(TikTok / Reels / Shorts向け)

ユーザーが縦長/ポートレート/TikTok/Reels/9:16出力(16:9ソースから)をリクエストした場合:

  1. プロジェクトを兄弟フォルダにクローンします: cp -r project/ project-vertical/。
  2. index.html を references/host-template-vertical.html(1080×1920キャンバス、ぼかし背景+リキッドブラー、16:9フッテージを中央に配置した水平ストリップ、キャプションは下部)に置き換えます。
  3. gen_body.py を references/gen_body_vertical.py(中央揃えのピル、大きなフォント、より狭い最大幅)に置き換え、再実行して compositions/components/caption-body.html を出力します。
  4. 被写体背後カットアウト+パララックスサブコンポジションを削除します(カットアウトは16:9用に位置合わせされており、v1で再調整する価値はありません)。代わりに縦長コンポジションでは、ぼかしソース背景+ブラーで雰囲気を出します。
  5. index.html 内の data-duration を実際の動画時間に更新します。ブランドチップテキスト(デフォルト YUV.AI)も適宜更新します。
  6. リント+レンダリング — 同じコマンド。出力は 1080×1920 です。そのままTikTok/IG Reels/YT Shortsにアップロードできます。

16:9と9:16の両方を同時に納品するには、2つのレンダリングコマンドを(並列プロジェクトで)実行します。transcript_review.txt の承認は両方に適用されます — 同じキャプション、2つのコンポジション。

重要なルール

  • 明示的な文字起こし承認なしに最終レンダリングを決して行わないでください。 レビューステップがこのパイプラインの核心です。
  • ヘブライ語の場合: large-v3 + language="he" + direction: rtl + Rubikフォント(エディトリアルデュアルウェイト強調のため700 + 900)を使用します。
  • キャプションピルには常に不透明な暗い背景が必要です — 明るいテキストだけだと白いアプリUIで見えなくなります。
  • キャプションピルは水平方向に中央揃えにしますが、映像の右下にウェブカムPiPがある場合は、中央のx座標を左にシフトします(例: left: 720px)。
  • 被写体背後カットアウトクリップは、data-media-start を data-start と一致させる(またはクリップが抽出された場合はソースからのオフセットと一致させる)必要があります。そうしないと、カットアウトがフレーム0から再生され、同期がずれます。
  • remove-background で生成されるwebmは元のRGBを保持し、アルファマスクのみを書き込みます。ffprobe は yuv420p と報告し、一見「アルファなし」に見えます。TAG:ALPHA_MODE=1 を確認するか、単色の上に合成して確認してください。
  • テキストが焼き付けられたアウトロ/エンドカード — それらの上にキャプションを重ねないでください。衝突します。

ファイルリファレンス

ファイル目的
transcript-editor/index.htmlインタラクティブブラウザエディター — 動画プレビュー、RTL編集、辞書適用、オプションのWebLLM AI提案、transcript_review.txt を保存
references/setup.md前提条件 + Node / Python / FFmpeg / faster-whisper のインストールコマンド
references/transcribe.pyCPUフォールバック+単語タイムスタンプ付きのfaster-whisper文字起こし
references/serve_review.pyローカルレビューサーバー — 自動でエディターをロードし、ユーザーが「承認してレンダリング」をクリックするまでブロック、その後 transcript_review.txt を書き込み終了(エージェントにシグナルを送る)
references/make_review.py修正を適用し、transcript_review.txt を出力(ファイルモードのフォールバック)
references/apply_review.py編集済みレビューファイルを解析し、単語タイミングを再配分、transcript.json を更新
references/gen_body.pyキャプションボディジェネレーター(エディトリアル+マトリックスをリキッドガラス風ピルに表示)
references/host-template.html16:9 ホストコンポジション。リキッドエフェクト+トランジションワイプ付き
references/host-template-vertical.html9:16 ホスト(1080×1920)— TikTok / Reels / Shorts向けレイアウト: ぼかし背景、中央配置の16:9フッテージストリップ、下部にキャプション、右上にブランドチップ
references/gen_body_vertical.py縦長用に調整されたキャプションボディジェネレーター(中央揃えピル、大きなフォント、狭い最大幅)
references/liquid-blobs.html全長にわたって漂うブラブレイヤー
references/caption-parallax-outro.html被写体背後キャプションテンプレート(英語版。他の言語の場合はクローンしてください)
references/corrections-hebrew.mdヘブライ語Whisperでの既知の誤認識リスト
references/transcript-review-workflow.md一時停止/承認ステップの詳細説明

Individual skills in this repo

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

hoodini/ai-agents-skills

Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts, video-title karaoke captions, premium GSAP motion graphics, no fake content, never covering the speaker's face. Hebrew is rendered in Rubik Black, English in Anton uppercase. Always renders BOTH 9:16 and 16:9 and always saves with _V<N> suffix for backups. Trigger when the user drops a path to an .mp4/.mov/.mkv and says "edit this", "make it viral", "turn this into a short", or any Hebrew equivalent (ערוך סרטון, סרטון ויראלי, להפוך לוויראלי, ריל, שורט). The pipeline is the COMBINATION of two skills: video-use (transcription + word-snapped cuts + base extraction) and hyperframes (HTML/CSS/GSAP visual composition + render). Do NOT use for podcast-only audio edits.

hoodini/ai-agents-skills

Yuval Avidani's YUV.AI brand and design system. Apply ONLY when YUV.AI-branded output is requested — presentations, decks, keynotes, portfolio, brand site, profile, speaker bio, brand assets, or any prompt mentioning YUV.AI / "my brand" / "my deck" / "my site" / "for me". Do NOT auto-trigger on generic "build a game / web app / dashboard / landing page" without YUV.AI context — those use whatever palette fits. Three modes; NEON (hot pink #FF1464 + neon cyan #00E5FF + white, DEFAULT for YUV.AI web, apps, games, dashboards, social, general visual work); DECKS (Fly High purple/yellow/grey, presentations and slides ONLY); Warm Editorial (pink/yellow/bone for Hope, Marcus, bigcats.ai, practical.yuv.ai). Universal Fly High throughline across all modes; flight/progress motifs (HUD strips, dials, "Let's Fly High" tagline, phoenix mark). Anton + Inter (EN), Rubik + Assistant (HE), letter-spacing 0 default. Bundled brand assets, canonical socials, credentials. Project brand wins if specified.

hoodini/ai-agents-skills

Yuval's all-in-one AI video pipeline. Turns an idea/script into a finished, on-brand MP4 by orchestrating HyperFrames (HTML→deterministic video render), Lottie (branded motion graphics), ManimCE (math / neural-network / concept animations), and a transcribe→approve caption flow — all wrapped in the YUV.AI Neon Phoenix brand via a frame.md. Use whenever Yuval wants to make, edit, or explain something as a video: promo, explainer, launch, social reel, "make a video about X", "explain X as a video", "neural network animation", "turn this into a video", captioned tutorial, 16:9 or 9:16. Triggers: video, explainer, promo, reel, manim, lottie, hyperframes, animation, "make a video", "explain ... as a video", מצגת וידאו, סרטון, הסבר וידאו. Routes each beat to the right engine, wraps in brand, self-verifies, and renders.

hoodini/ai-agents-skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language (RTL or LTR — Hebrew, English, Arabic, Spanish, French, Japanese, etc.) and any subject (food, tech, animals, fashion, services, SaaS, wildlife campaigns, music releases, books, real estate). The signature effect is mouse-driven video scrubbing — the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing → joy → nostalgia → contemplation → action). Triggers on phrases like "build a landing page from this video", "cinematic landing ...

hoodini/ai-agents-skills

Build a scroll-driven cinematic landing page from a short video. The user provides a 5–15 second video (often AI-generated); this skill extracts every frame at HD JPEG quality, then produces a single-hero HTML page where the user's scroll gesture scrubs the frames in place (the page itself never scrolls) and 5 dramatic text overlays crossfade in/out — Google Anton headlines, Caveat handwritten accents, locked body, virtual scroll. Use this skill whenever the user wants to "turn this video into a landing page", "make a scroll-scrub landing page", "build a parallax hero from this clip", "add a new landing page to the parasites showcase", "do the same as github/lion/hope for this new video", or any variant that pairs a short clip with dramatic scroll-triggered storytelling. Trigger even if the user only says "use my video for a landing page" — that is this skill.

hoodini/ai-agents-skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

hoodini/github-trending

Fetch and display GitHub trending repositories and developers. Use when building dashboards showing trending repos, discovering popular projects, or tracking GitHub trends. Triggers on GitHub trending, trending repos, popular repositories, GitHub discover.

hoodini/mongodb

Work with MongoDB databases using best practices. Use when designing schemas, writing queries, building aggregation pipelines, or optimizing performance. Triggers on MongoDB, Mongoose, NoSQL, aggregation pipeline, document database, MongoDB Atlas.

hoodini/owasp-security

Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability.

関連スキル