ビデオクリエーター
動画を1つのHTMLページとして作成します。render(t) という1つの関数で、すべての要素の状態を時間だけから設定します。CSSトランジション、タイマー、前のフレームのメモリは使用しません。Playwrightスクリプトが各フレームの時間までシークし、スクリーンショットを撮り、ffmpegがフレームをエンコードします。すべてのフレームは t の純粋関数であるため、任意の瞬間にジャンプしたり、並列レンダリングしたり、毎回同一の出力を得ることができます。
創造的な自由度は大きく与えられています。このスキルは、技法、苦労して学んだ教訓、そしてDannyのデフォルト設定を提供するものです。テンプレートではありません。最高の動画は、その主題に固有の1つの強力なアイデアから生まれます。
参考実装: https://github.com/dannysmith/astro-editor の website/video/ ディレクトリ(READMEではページ、レンダラー、合成オーディオ、公開についてカバーしています)。技法を学ぶために読んでください。見た目を真似るためではありません。そのダークで映画的なスタイルはその製品に適したものであり、すべての製品に適しているわけではありません。
ページ
window.DURATION = 45 // 秒
window.__ready = Promise.all([document.fonts.ready, ...[...document.images].map((i) => i.decode())])
window.render = (t) => { /* すべての要素をtから設定 */ }
ほとんどのモーションは、3つのヘルパー(時間ウィンドウを通じた0~1の進行度、イージングカーブ、lerp)から構築します。カメラ移動用のキーフレームリストと、テキスト用のシード付きタイピングヘルパーを追加します。?t=12(1つの瞬間でフリーズ)と ?play(通常速度でループ再生、requestAnimationFrame 駆動)をサポートし、Dannyがブラウザでページを開いて確認できるようにします。どちらも指定されていない場合、ページは render(t) が呼ばれるまで何もしないでください。これがレンダラーの読み込み方法だからです。フレーム0をレンダリングする前に __ready を解決してください。そうしないと、初期フレームでフォールバックフォントが使用されたり、画像が表示されなかったりします。
ワークフロー
-
リサーチ。何を元に作業するか把握します。
- ウェブサイトやブランドがあるプロジェクト: 実際の色、フォント、スクリーンショット、コピー、スタイルシートを取得し、製品の主張をドキュメントと照合します。
- ブランドがほとんどない、またはUIがないプロジェクト: READMEとドキュメントから内容を、見た目はハウススタイルから取得します。
- プロンプトのみ(コンセプト、記事、架空の製品): プロンプトと添付ファイルがソースです。ハウススタイルを使用します。架空のものは自由に発明しますが、一貫性を保ちます。
重要なものが欠けている場合は、質問します。
-
ピッチ。構築する前に、Dannyに確認用の短いコンセプトを提示します。中心となるアイデアとそれをシーンからシーンへとつなぐもの、ビートの順序、おおよその長さ、見た目、オーディオのアプローチを含めます。コンテキストが十分にある場合は、1つのコンセプトを提案します。ほとんどない場合は、2~3の異なる方向性を数行ずつ提案します。
-
計画。自分用にタイムドストーリーボード(シーン、開始、終了、画面に表示されるもの)を作成します。
-
構築。現在のプロジェクトの
video/ディレクトリ内で作業します(依頼がない限りコミットしないでください)。または、空のディレクトリの場合は現在のディレクトリを使用します。プロジェクト用のレンダースクリプトを作成します。このスキルのassets/render.mjsを開始点としてコピーし、動画が必要とするものに変更します。アニメーションが必要なUIはHTMLで再現し、静止画やモンタージュの瞬間には実際のスクリーンショットを、シェイプやイラストにはSVGを使用します。 -
レビュー。コンタクトシートとスチルをレンダリングし、修正、繰り返し、フルレンダリングの前に少なくとも2回行います(クラフトを参照)。
-
納品。最終的なMP4ファイル、Dannyが動画全体を一目で確認できるコンタクトシート、再レンダリング方法、そしてサードパーティのアセットを使用した場合は
LICENSES.txtを含めます。エンコードされたファイルからフレームをスポットチェックします。
特に指示がない限り: 16:9、1920×1080、60fps、長さはコンテンツに合わせ(プロモーションは30~60秒)、音声なしでも意味が通じるようにします。
クラフト
- 背骨を見つける。すべてのカットを通して一貫する1つのデバイス(ウィンドウ、シェイプ、キャレット、カメラパス、カメラが移動する単一の世界)。これがないと、動画はフェードで切り替わるアニメーションスライドになってしまいます。クロスフェードよりも、マッチカットと1つのものが次のものに変形することを優先します。
- ペースを調整する。ビートはおおよそ1.5~4秒。変化をつけます。最も遅いシーンは最も速いシーンの約3倍の長さにします。何も動かず、セリフが決まる「保持ビート」を少なくとも1つ含めます。退出は入場よりも速くします。最初の数秒でこれが何であるかを伝えます。
- 読む時間を与える。テキストは、表示された後、最低0.6秒+単語1語あたり0.3秒保持します。1行が2秒以内で読めない場合は、単語を削ります。
- サイズはウェブではなくビデオ用に。1080pの場合、見出しは90px以上、本文は32px以上。1pxの線と10%未満の不透明度はエンコード後に消えます。全画面の線形グラデーションはバンディングが発生するため、ベタ塗りまたはラジアル塗りを使用します。
- 安易なデフォルトを避ける。すべてに同じイージングと持続時間、すべての入場がスライドアップ&フェード、すべてのシーンで同じスタガー、すべてのカットでクロスフェード、グラデーションテキスト、黒背景に紫やシアンのグロー、すべて中央揃え。
- 実際の素材を使用する。ソースからの実際の色、コピー、UI。画面上に表示されるすべての数字と主張を確認します。
- 編集者のようにレビューする。
- 1秒あたり約1フレームのコンタクトシートは、ペーシングと構成を示します。
- スチルは動きを隠すため、各トランジション全体でフレームを密に並べてイージングを確認します(サンプルレンダラーでは
--sheet 0.05 --from 12 --to 12.6)。 getBoundingClientRect()を使用してコード内でテキストのオーバーフローと衝突を確認します。目視だけではありません。
注意点
- フレーム間で状態を保持しない。並列レンダラーワーカーは動画の途中から開始するため、以前のフレームからキャッシュされたものはすべて失われます。すべてを
tから導き出すか、各フレームでページから測定します。 - フォントはローカルに保つ。Webフォントファイルをプロジェクトにダウンロードします。レンダリング時にネットワークから読み込むのは信頼できません。Macにインストールされているライセンスフォント(Operator Monoなど)は
local()で読み込みます。それらのファイルをリポジトリにコピーしないでください。 - 乱数をシードする(タイピングリズム、ジッター、ブラブシェイプなど)。レンダリングが同一になるようにします。
- 推測ではなく測定する。レイアウトに依存する位置(コネクターライン、ドロップターゲット、カーソルパス)は
getBoundingClientRect()から取得します。画像に注釈をオーバーレイする場合は、画像自身のオフセットを追加することを忘れないでください。 <video>要素を再生しない。ffmpegでフレームを抽出し、tに対応する正しいフレームを表示します。- ChromiumはClaude Codeサンドボックス内では起動しません。レンダリングはサンドボックスの外で実行します。
- 音声は聞こえません。その旨を伝えます。レベルを数値で確認し、波形を確認します(
references/audio.mdを参照)。 - ウェブ配信: H.264、
-crf 27 -preset veryslow -tune animation -pix_fmt yuv420p -movflags +faststart、AACオーディオはloudnorm=I=-16でノーマライズ。
ハウススタイル
プロジェクトとプロンプトで未定義のまま残っているものに対するデフォルト。プロジェクト独自のブランドが見た目では優先され、Dannyの指示がすべてに優先します。彼が異なるスタイルを要求したり、デフォルトを無視するように言った場合は、それらを完全に破棄します。パレット、ブラブ、書体を習慣で持ち越さないでください。トーン、アニメーション、オーディオのデフォルトは、彼が特に指定しない限り、ブランド動画にも適用されます。
色
Dannyのパレット。Notionの色に基づいています。ブランドグレー #2f3437 のキャンバス、フレームと暗いパネルには #191919、白いテキスト、キーワードにはコーラル #ff7369。パステル400番台と彩度の高い500番台をシェイプに使用します。references/colours.md には、各色の用途、danny.isパレットとFlexokiパレット、そしてそれらを使用するタイミングを含む完全なパレットがあります。動画ごとに1つのパレットを使用します。
フォント
デフォルトはGeist。見出しにはウェイトの太いものを使用します。その他:
- Figtree: より親しみやすいサンセリフ。
- Literata: 引用や論説記事向けのセリフ。
- Caveat: 余談向けの手書き風。控えめに使用します。
- Operator Mono: コードとターミナル。ローカルにインストールされているので、
local('Operator Mono')を使用し、フォールバックとしてFira Codeを指定します。 - システムフォント (SF Pro): Macアプリプロジェクト用。ネイティブUIに合わせます。
- Inter: Dannyの古いFigmaスライドに合わせる場合。
Operator MonoとSF Proを除き、すべてGoogle Fontsにあります。
タイポグラフィ
大きく太く: 見出しはウェイト800~900、タイトな行間、わずかにネガティブなトラッキング。短いタイトルはすべて大文字、ステートメントは文の先頭のみ大文字。強調はイタリックではなく色で行います。中央揃えよりも左揃えと非対称を多く使用します。
トーン
- イギリス英語。
- 暖かく、平易で、少し生意気。知らない人に売り込むのではなく、賢い友人に何かを説明するような感じ。
- 具体的に。「あなたのスキーマがフォームになる」であり、「あなたのワークフローを強化」ではない。
- 1行に1つの考え。
- そのものができること以上に主張しない。
- 絵文字は歓迎。
- マーケティングの決まり文句は使わない(「紹介します」「革命を起こす」「シームレス」「アンロック」「ゲームチェンジャー」)。
Astro EditorとTaskdnのホームページがそのトーンを示しています。ナレーションや見出しより長いものには writing:guide を読み込んでください。
美学
プロジェクト自身のホームページから始めます。ホームページがない場合は、Danny自身のスライドやソーシャル画像(references/examples/ 内のスクリーンショット。デザインする前に見てください)の雰囲気を借ります。レイアウトではなく、要素を取り入れます:
- 暗いフレームに埋め込まれたチャコールのキャンバス。
- コーラルでハイライトされた、大きく太い白いタイプ。
- コーラルとパステルカラーの有機的なブラブが角からはみ出る。
- ゆるく手描きの波線や矢印。
- イラストとしての大きな絵文字。
- パレット内のフラットなベクター描画。
- 時折の塗りつぶしのカラーカード。
- コード用のmacOSウィンドウクローム。
- たっぷりとしたスペース。
親しみやすく、少し遊び心があり、明らかに人間が作ったと感じられるべきです。
画像
写真よりも、自分で描くSVG(シード付きブラブ、フラットなイラスト、図表)を優先します。写真は、何かを追加する場合にのみ、UnsplashまたはPexelsから使用します。アイコンはLucideまたはPhosphorから。Apple絵文字はネイティブにレンダリングされ、個人の動画に適しています。商用製品のマーケティングにはFluent Emoji(MITライセンス)を使用します。
アニメーション
- スムーズで、スウォッシュ感はありません。スピン、3Dフリップ、ズームブラー、レンズフレア、パーティクルバーストはなし。
- モーションは注目を誘導し、一度に1つの焦点の動きだけにします。
- タイピングは人間らしく。不均一なリズム、句読点でのポーズ、タイピング中はソリッドでアイドル時は点滅するキャレット。
- 背景に少し命を吹き込みます。漂うブラブ、揺れる絵文字、ポップインするティック。
- 誰かを笑顔にする瞬間を1つ目指します。
- 最後は保持されたエンドカードで終了します。
オーディオ
動画ごとに選択し、ピッチで理由を説明します:
- 動画に合わせた既存のトラック。Dannyに2~3候補をリストアップします(聞こえないため)。
- 画面上のイベントに同期した合成音。生のオシレーターではなく、サンプリングされた楽器を使用します。
- 上記2つの混合。
- 無音。短いクリップや、ミュートで自動再生されるものには無音。
効果音は控えめに。意味のあるイベント1つにつき1つ。references/audio.md には、ソース、ライセンス、ffmpegレシピ、聞こえないオーディオを確認する方法が記載されています。