Communitygithub.com

kinetic-reel

キネティックタイポグラフィによるモーションリール(MP4)をコードで生成します。ショーリール、ポートフォリオ、プロダクトプロモーション、イントロフィルムなどに最適です。

kinetic-reel とは?

このスキルは、コードのみでエディトリアルなハイエナジーモーションリールを制作するための強力なツールです。Canvas 2DとWebGLを組み合わせ、ヘッドレスChromeでフレームごとにレンダリングし、ffmpegでエンコードします。主な機能として、three.jsによる生成レイヤー(パーティクル地形、リキッドマーブル、クロームノット、パーティクルクラウド)と、ビートロックされたシンセサイズドスコアを備えています。ワークフローは「ストーリーボード → 構築 → フレーム確認 → レンダリング/エンコード」という明確なステップで構成され、テンプレートと実例が同梱されています。対応プラットフォームはClaude CodeやCodexなどのコードベースAIエージェントで、プロジェクトのスキャフォールディングから最終出力までを自動化できます。特に、タイポグラフィを主役とし、ビートに同期したカット、シェイプコンティニュイティ遷移、正直なデータ表現を重視する点が特徴です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/kinetic-reel

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

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

ドキュメント

キネティックリール

コードのみでエディトリアルでハイエナジーなモーションリールを作成する手法です。「Work Reel ’26」(84秒のポートフォリオリール:Microsoft → UW–Madison Surgery → Enterprise RAG → trace finale)から抽出されました。実行可能な template/(全技法を使用した17秒のデモ)と、完全な実例 examples/work-reel-26/(上流のみ:https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26)がバンドルされています。

仕組み。 すべてのフレームは t の純粋関数です。reel/index.html は reel/cues.js(タイムライン)と reel/reel.js(ESモジュール:three.jsレイヤー、2Dタイプキャンバス、WebGLポストパス)を読み込みます。render.mjs はヘッドレスChromeを駆動し、コンタクトシート、ストリップ、レビュー用静止画、または全フレームを並列レンダリングし、ffmpegがMP4をエンコードします。music/score.mjs は同じ cues.js からNodeでスコアをシンセサイズするため、すべてのヒットが正確なフレームに配置されます。

ワークフロー

0. スキャフォールド

bash ~/.claude/skills/kinetic-reel/scripts/new_project.sh <project-dir>

次に、デザインを始める前に references/style-guide.md(ルック、モーションボキャブラリ、トランジションカタログ、レイアウトルール)と references/sound.md をすべて読んでください。長いリールの構成については examples/work-reel-26/reel.js(ここにはコピーされていません。https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26 を参照)をざっと確認してください。

1. 重点を決め、ストーリーボードを作成

  • 何をリードとし、各パートにどのくらいの時間を割り当てるかを質問(または決定)します。視聴者は比率に注目します。Work Reelのv2ではMicrosoftが約60%を占めていたため、バランスを取り直す必要がありました。修正方法は、好まれている部分を削るのではなく、他のチャプターの時間を 追加 することでした。リード部分は約35〜40%を目指します。
  • テンプレートから STORYBOARD.md を作成します。時間配分、事実のソース、統一デバイス、ショットごとの1行(見出し、ビジュアルメカニズム、トランジションイン、サウンド)を含めます。
  • 事実は神聖です。 提供されたソースの数字のみを使用し、それぞれに範囲(「約180の自作ケース」、「320のバイリンガルプロンプト」)を明記します。説明用のもの(ツールID、ドキュメントID、回答例、ASTなど)はHUDに SCHEMATIC とラベル付けします。持っていない次元のデータを描画しないでください。プロセスを可視化します。医療/臨床関連の作業では、有効性を主張せず、該当する場合は「開発中/未検証」と記載します。

2. 構築

  • reel/cues.js:S(シーン開始)、hits(重要なすべてのビート)、CH(チャプター → セグメント化されたプログレスバー)、dur。120 BPM:カットはビート上、チャプター変更は小節上で行います。
  • reel/reel.js:ショットごとに1つの関数 sName(t)。各関数はフレーム全体を描画します。bg() → glShot(...) によるGLレイヤー → タイプとシェイプ → hud(t, {...})。ショットをキーとともに SCENES に登録し、TR にトランジションを追加するか(ビート上のハードカットの場合は省略)、追加します。
  • 描画するすべての中国語文字をリストした CJK 定数を保持します(フォントはサブセットとして読み込まれます)。

3. 各ショットを複数回確認

node render.mjs --sheet=1,4,7,10,13,15.5 --cols=3 --w=640 --out=out/check/sheet.jpg   # キーフレーム
node render.mjs --stills=10.4 --out=out/stills                                          # フル解像度詳細
ffmpeg -ss 16.0 -t .6 -i out/reel.mp4 -vf "fps=10,scale=320:-1,tile=6x1" out/check/tr.jpg   # エンコードからトランジションを切り出し

すべての画像をReadで開きます。ラベルとラインの重なり、統計情報同士の重なり、テキストとHUDバンドの衝突、カット時の空フレーム、1600px幅での可読性、各トランジションが 何かから始まって きれいに着地しているかを確認します。目安:チャプターごとに1枚のシート、密度の高いショットごとに1枚のフル解像度静止画、トランジションタイプごとに1つのストリップ。

4. スコア、レンダリング、エンコード

node music/score.mjs && ffmpeg -y -i music/score.wav -af "highpass=f=30,equalizer=f=250:t=q:w=1:g=-2,loudnorm=I=-14:TP=-1.2:LRA=8" -c:a aac -b:a 192k assets/score.m4a
node render.mjs --frames --workers=4                                    # Mac GPUで約8〜40ms/フレーム:数分ではなく数秒
node render.mjs --encode --audio=assets/score.m4a --out=out/reel.mp4 --fps=30
# Web用コピー:ffmpeg -i out/reel.mp4 -vf scale=1600:900:flags=lanczos -c:v libx264 -preset slow -crf 23 -c:a aac -b:a 128k -movflags +faststart out/reel-web.mp4

スコアは聞いて確認できません。showspectrumpic とセクションごとのRMSでチェックし、報告する際にその旨を伝えてください。オーディオのみの変更は再レンダリング不要:リマックス(-map 0:v -map 1:a -c:v copy)で対応できます。

最も重要なルール

  1. タイポグラフィが主役です。 見出しにはコンデンスドディスプレイ(Anton)、強いインパクトにはワイドグロテスク(Archivo Black)、唯一の「声」のラインにはイタリックセリフ(Instrument Serif)、ラベルにはモノ(JetBrains Mono)。大きな英字見出し、バイリンガル視聴者向けの小さな中国語注釈。
  2. すべてのショットにメカニズムがあります。 単なる言葉ではなく、グリッドルーティング、行列スキャン、ステートマシンを飛び回るトークン、リストの融合、ゲートを通過するパケットなど。見出しが名前を示し、メカニズムがそれを証明します。
  3. ビートロック。 文字、チップ、カウンター、カットはすべて hits 上に配置します。高速イン(expo-out)、ホールド、次へ。
  4. コンティニュイティ。 チャプター内ではハードカットよりもシェイプコンティニュイティトランジション(視線が留まっている要素をズームイン、直前に光ったものからアイリス)を優先します。ハードカット+インパクトはチャプターの強烈な切り替え用です。
  5. ノイズのスウッシュはなし。 チャプターへの移行ではインキーのスウェル、内部では静かなトーンキュー、カットの約半分は無音。
  6. 正直なデータ(ステップ1参照)、説明用のものには SCHEMATIC ラベル。
  7. 数学をガードします。 backOut() からの半径が0未満になるとキャンバスがエラーをスローするため、circle/starburst/jelly は既にガードされています。シンセサイザーでは、pow() の前にローカル時間を≥0にクランプし、SVFの f/q をクランプします(両方ともテンプレートに実装済み)。

サイトイントロとしてのリールの配信

Work Reelはサイトのエントリーページとして配信されます。index.html がリールをフルスクリーンで再生し、ポートフォリオへハンドオフします。このパターンは examples/site-intro/(index.html、css/intro-reel.css、js/intro-reel.js、HTTP Rangeサポートを追加するCloudflare Workerを含む)にバンドルされています。

  • 音声付き自動再生を試みます。拒否された場合はミュートで再生し、「タップで音声」のパルス表示。それも拒否された場合、または prefers-reduced-motion が設定されている場合は、エンド画面を「スタート」モード(再生がリードボタン)で表示します。
  • 再生中:リールのHUDがコーナーを占有するため、上部中央に小さなガラスのピルボタン。「スキップイントロ」はリールの進行に合わせてリングが埋まるデザイン。サウンドトグルのイコライザーバーはリールのBPMでパルス。Escでスキップ、Mでミュート。
  • エンド画面:リールの文法をHTMLで再現。コーナーブラケット、ドロップイン字体の名前(Anton)、モノマイクロタイプ、セグメント化されたトレースバー、パーティクル地形の2Dドットフィールドバージョン、ライム色のプライマリCTA(ホバー時にテキストロール、シアー、マグネティック、小節ごとにパルス)、ゴーストの「もう一度見る」。
  • 押されたコントロールからライム色のアイリスで遷移、オーディオをフェードダウン、その後ナビゲート。
  • 2つのエンコード(1600×900で約1.3 Mbps、960×540で約0.6 Mbps(スマートフォン/セーブデータ用))、preload="auto"、ポスター画像。HTTP Range(206)で配信しないと、シークやSafariで問題が発生します。

Individual skills in this repo

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

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

VisualxIntelligence/motion-tools-and-skills

Make hand-painted watercolour-and-ink cartoon videos (MP4) with code — p5.js + p5.brush rendered frame by frame in headless Chrome, encoded with ffmpeg — starring Clawd or any character. Use when the user asks to make an animation, animated short, cartoon, music video, lyric video, animated GIF/loop or "a video of Clawd…", or mentions the PDoomVideo / ClaudeAnimationBase approach. Covers storyboarding, the engine API, the render-and-look review loop, music/lyric sync and splitting long videos across subagents.

関連スキル