Communitygithub.com

MiguelBai/yanni-video-editor

Yanniのトーキングヘッド動画を「紙切り」サイエンスリール風に編集します。カメラの顔と、ちぎった紙のシーンを混ぜ、切り抜いたオブジェクトが落ちてきたり、本物の研究ページが高速で現れたり、赤い統計数字がポップアップし、単語ごとにキャプションが常に流れます。ユーザーが動画ファイルをドロップしたり、特定のフレーズを言ったときに使用します。

yanni-video-editor とは?

このスキルは、Yanniのトーキングヘッド動画を「紙切り」スタイルのサイエンスリール(1080x1920)に変換する完全自動パイプラインです。ユーザーはほぼClaudeを操作する必要がなく、スキルが自律的に動画の準備、文字起こし、ジャンプカット、ビート計画、アセット収集、編集JSONの作成、HyperFramesを用いたプレビューとレンダリングまでを行います。対応プラットフォームはClaude Code(デスクトップ版)を想定しており、ffmpeg、whisper-cli、Node.jsが必須です。特徴は、顔カットと紙カットを交互に配置するリファレンススタイル、実際の研究論文のスクリーンショットの使用、統計数字の正確な反映、単語単位のキャプションの自動生成です。ユーザーへのメッセージは短く簡潔にし、必要な場合のみ(研究リンクや不足動画の確認)にしか質問しません。全体の流れは、プリフライト、動画準備と文字起こし、ジャンプカット、ビート計画、アセット収集(画像カットアウト、研究ページ、統計数字)、edit.jsonの作成とビルド、スナップショット確認、プレビューレンダリング、修正、最終レンダリングです。厳格なルールとして、証拠の捏造禁止、キャプションは発言通り、アクセントカラーはブランドから1色のみ、システムのスタイル変更は一度だけ、タイミングはカット時間を使用します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MiguelBai/yanni-video-editor/tree/HEAD/skills/edit

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

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

ドキュメント

紙切りリール編集者

Yanniは栄養、ペプチド、フィジークのクリエイターです。彼は自分の喋りを録画します。このスキルは、生テイクを彼が選んだリファレンス(薬理学解説動画)スタイルの完成された1080x1920リールに変換します。彼の顔がカメラに映り、ちぎった紙の「解説」シーンと交差し、すべての上にキャプションが重なります。

ユーザーはほとんどClaudeを使いません。すべての作業を自分で行い、メッセージは短く簡潔に保ち、本当に必要なときだけ(研究リンク、不足動画)彼に尋ねてください。生のJSONや長いログを彼に見せないでください。

最初の計画の前に、references/style.mdを一度読んでください。それは測定されたスタイルのバイブルです。このファイルは手順です。

以下Eは、<このスキルのベースディレクトリ>/engineを意味します。

0. 事前チェック

  • ~/.yanni-editor/brand.jsonがない、またはffmpeg/whisper-cli/nodeがない場合:最初にセットアップスキルを実行してから、戻ってきてください。
  • 動画を見つけてください。彼がファイルをドラッグした場合、パスは彼のメッセージにあります。そうでない場合は、一度だけ尋ねてください:「動画ファイルをこのウィンドウにドラッグしてEnterキーを押してください。」
  • プロジェクトフォルダ:<brand.jsonのprojectsDir>/<ケバブケースのトピック>(例 ~/Movies/Yanni Edits/bpc-157-healing)。スラッグは文字起こしがトピックを教えてくれた後に選びます。それまではuntitled-<日付>を使用し、後で名前を変更します。

1. 準備と文字起こし

node "$E/prep.mjs" "<生動画>" "<プロジェクト>"

1080x1920 30fps、-16 LUFSに正規化し、build/raw.transcript.txt(タイムスタンプ付きフレーズ)を書き出します。そのファイルを読んでください。

2. ジャンプカット(および悪いテイク)

リテイクを探します:同じ文が2回言われている、言い間違い、「待って、やり直す」など。最後のテイクを保持し、それ以前のものを生の時間範囲で削除します。また、明らかな不要部分(スマホに手を伸ばすなど)を先頭と末尾から削除します。

node "$E/cut.mjs" "<プロジェクト>" --remove "3.10-7.85,40.2-44.0"
# リテイクなし:node "$E/cut.mjs" "<プロジェクト>"

ポーズはオーディオ自体からカットされます(-35 dB未満で0.3秒以上の部分)。彼が急いでいるように聞こえる場合は--gap 0.45を使用します。部屋が騒がしく何もカットされない場合は、--db -30を試してください。出力:build/head.mp4とカット時間のbuild/transcript.txt。これ以降のすべてのビート時間はカット時間です。

build/transcript.txtを読んでください。Whisperは名前を間違えます。修正をedit.jsonのreplaceに書き込みます(単語ごとのマップ、大文字小文字を区別しません)。例:{"BPC157": "BPC-157", "tren": "Tren"}

3. ビートの計画(資産に触れる前に書き留める)

build/plan.mdを書きます:ビートごとに1行、カット時間範囲、発言内容、FACEまたはPAPER、紙の場合は画面に表示するもの。リファレンスからのルール:

  • PAPERで開始。 最初の2〜4秒は紙のシーンで、黒いヘッダータグにトピック名とメインオブジェクトがドロップイン。これがフックです。
  • 最初のFACEビートには名前スタンプ("stamp": 0.2)が含まれます。
  • 交互に配置。 話される思考が明らかに続く場合を除き、紙ビートを2つ連続で顔を挟まずに配置しないでください(その場合は複数のショットを持つ1つの紙ビートにします)。紙ビートは2〜5秒、顔ビートは1.5〜5秒。ランタイムの45〜55%を紙に割り当てることを目指します。build.mjsがpaperShareを出力します。
  • 紙に配置するもの: 彼が化合物、食品、サプリメント、身体部位、研究を名前を挙げた瞬間、数字を言ったとき、メカニズムを説明したとき。顔に残すもの: 意見、警告、結論、ジョーク、行動喚起。顔は信頼、紙は証拠です。
  • 紙ビート内ではショットが1.2〜2.5秒ごとに変わります。 whipで次の研究ページへ、pushで現在のカードの下に統計や図を追加、zoomでオブジェクトを交換。1つの静的なショットが4秒続く紙ビートは死んでいます。
  • 長い顔の連続(約4秒以上でジャンプカットが内部にある場合):2つの顔ビートに分割し、2つ目に"zoom": 1.12を指定します(パンチインでカットを隠す)。

4. ビジュアルの収集

すべてをbuild/assets/に配置します。build/assets/credits.txtにすべての画像のソースを書き込みます(find_imagesはライセンスとページを出力します)。

切り抜きオブジェクト(バイアル、注射器、鶏胸肉、卵、ダンベル、脳、肝臓):

node "$E/find_images.mjs" "注射器" "<プロジェクト>/build/cand" --n 6
# 候補を見て(読んで)、最も明確な背景が単純なオブジェクトを選びます
node "$E/cutout.mjs" "<プロジェクト>/build/cand/syringe-2.jpg" "<プロジェクト>/build/assets/syringe.png"

次に切り抜きを見ます。背景除去はガラス、透明プラスチック、複雑な背景では失敗します。失敗した場合、別の候補を試すか、写真をcutoutの代わりにcardとして使用します。解剖学は古い版画として最適に読めます:「Gray's anatomy <臓器>」で検索し、リファレンスが使用するグレースケールルックのために"mono": trueを使用します。彼が自身の製品写真を持っている場合は、それらを優先します。

研究ページ(このスタイルの backbone):

  • 本物の研究のみ。 彼が引用する研究で確実に見つけられない場合は、リンクを尋ねてください。研究、ジャーナルページ、図、数字を決して捏造しないでください。偽のスクリーンショットに基づく健康主張は、人と彼のアカウントを傷つける可能性があります。
  • Europe PMCを介したスクリーンショット(PubMedはヘッドレスブラウザをブロックします):
    node "$E/webshot.mjs" "https://europepmc.org/article/MED/<PMID>" "<プロジェクト>/build/cand/study.png"
    
    それを見ます。次に、彼が話している部分を切り抜きます。タイトルブロックは「2017年のオスロからの研究...」、主張に対する正確な結果文や図:
    ffmpeg -v error -y -i study.png -vf "crop=W:H:X:Y" -frames:v 1 "<プロジェクト>/build/assets/study-title.png"
    
    スクリーンショットは2倍スケールなので、切り抜きはシャープです。カードを読みやすく保ちます:タイトに切り抜き、カードは画面上で最大約820px幅です。
  • ジャーナルページ(ScienceDirect、Wiley)もしばしばブロックします。スクリーンショットがキャプチャや空白の場合は、彼にMacでページのスクリーンショット(Cmd+Shift+4)を撮ってファイルをドロップするよう依頼してください。

統計数字(stat):彼が声に出して言った数字のみ、単語通り。

5. build/edit.jsonを書いてビルド

完全な形式とすべてのオプション:references/edit-json.md。最小形状:

{
  "title": "bpc-157 healing",
  "video": "head.mp4",
  "transcript": "transcript.json",
  "replace": { "bpc157": "BPC-157" },
  "beats": [
    { "type": "paper", "start": 0, "end": 3.2, "header": "Does BPC-157 Heal Tendons?",
      "shots": [
        { "at": 0, "enter": "drop", "items": [ { "kind": "cutout", "src": "assets/vial.png", "label": "BPC-157" } ] },
        { "at": 1.6, "enter": "zoom", "items": [ { "kind": "cutout", "src": "assets/tendon.png", "mono": true } ] }
      ] },
    { "type": "face", "start": 3.2, "end": 6.4, "stamp": 0.2 },
    { "type": "paper", "start": 6.4, "end": 10.1,
      "shots": [
        { "at": 0, "enter": "cut", "items": [ { "kind": "card", "src": "assets/study-title.png" } ] },
        { "at": 1.8, "enter": "push", "items": [ { "kind": "stat", "text": "40 rats", "enter": "pop" } ] },
        { "at": 2.7, "enter": "whip", "items": [ { "kind": "card", "src": "assets/study-result.png" } ] }
      ] }
  ]
}

紙ビートでカバーされていないものはすべて彼の顔として表示されます。その後:

node "$E/build.mjs" "<プロジェクト>/build/edit.json"
cd "<プロジェクト>/build" && npx -y hyperframes@latest check

checkはCheck passedと表示しなければなりません。サブコンポジション、トラック密度、重複画像に関する警告はこのフォーマットでは予想されますが、エラーは許されません。

6. 彼に見せる前に確認

cd "<プロジェクト>/build" && npx -y hyperframes@latest snapshot --at <各ビート内の1つの時刻>

snapshots/contact-sheet-*.jpgを読んでください。チェック:すべての紙ビートに何かが表示されている、キャプションと重なっていない、カードが読みやすい、切り抜きのエッジがきれい、スタンプが最初の顔ビートにある、キャプションのスペルが正しい。修正して、正しくなるまで再ビルドしてください。彼が壊れたフレームを見つけるべきではありません。

7. プレビューとレンダリング

彼がスマホやMacで見られるようにドラフトをレンダリングします:

cd "<プロジェクト>/build" && npx -y hyperframes@latest render --quality draft --output "../out/<スラッグ>-draft.mp4"
open "<プロジェクト>/out"

2行で彼に伝えます:ファイルの場所、そして「変更したいことがあれば何でも言ってください。例えば『0:12の研究をもっと大きく』や『中間にもっと顔を』など。」

変更の場合:build/edit.jsonを編集し、再ビルド、確認、スナップショット、再レンダリング。最終バージョンの場合:

npx -y hyperframes@latest render --quality high --output "../out/<スラッグ>.mp4"

ファイルが存在し、再生でき、その長さがbuild/head.mp4と一致することを確認します(ffprobe -v error -show_entries format=duration -of csv=p=0 <file>)。約60 MBを超える場合は、アップロード用に再エンコードします:ffmpeg -i in.mp4 -c:v libx264 -crf 21 -preset slow -c:a copy out.mp4

彼が手動で微調整したい場合、ビルドフォルダでnpx -y hyperframes@latest previewを実行すると、HyperFrames Studioがブラウザでタイムライン全体を開きます。

厳格なルール

  1. 証拠を決して捏造しないでください。 研究、数字、図、引用、または前後比較画像を作り出さないでください。オーディオがソースを特定できない何かを主張している場合、その行は彼の顔に残し、どの行にソースが必要かを彼に伝えてください。
  2. キャプションは彼が言った通りに合わせます。 スクリプトではありません。スペルだけ修正します。
  3. アクセントカラーは1つだけ。 brand.jsonから。赤い統計テキスト、赤いスタンプライン、画像自体以外は色付けしません。
  4. ビデオごとにシステムのスタイルを変更しないでください。 フォント、紙、キャプションの見た目とモーションはengine/runtime/にあります。ビデオは独自のedit.jsonを持ちますが、CSSは持ちません。彼がグローバルなスタイル変更を求めた場合、runtimeを一度だけ変更してください。
  5. タイミングはカット時間です。 build/transcript.txtから取得し、生の時間は使いません。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル