Communitygithub.com

orbit-reel

話者の周囲を人物画像カードが3Dリング状に周回し、頭の後ろを通って前景へと移動します。縦型(9:16)と横型(16:9)のバージョンがあります。/orbit-reel または、特定のトーキングヘッドクリップにこの処理を適用するために使用します。

orbit-reel とは?

このスキルは、トーキングヘッド動画に3D効果を適用し、複数の画像カードが話者の周りをリング状に周回するエフェクトを生成します。ビデオ編集やAIエージェントを活用したコンテンツ制作に役立ち、Claude Code上で動作するように設計されています。縦型(1080x1920)と横型(1920x1080)のテンプレートから選択可能で、カスタム画像や動画素材を差し替えて利用できます。カードは3D空間内で話者の背後と前景を行き来し、preserve-3dシーンとアルファ合成によって自然な重なりを実現します。ビルドプロセスはPythonスクリプトで実行され、ffmpegやffprobe、Node.jsが必要です。第一フレームから話者が表示され、キャプションや画像の配置はプラットフォームのオーバーレイを避けつつも、装飾画像はコンポジション全体を縮めずにはみ出すようにデザインされています。スキルの結果はMP4として出力され、エディット可能なHTMLテンプレートベースで動作するため、柔軟なカスタマイズが可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/orbit-reel

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

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

ドキュメント

/orbit-reel

この処理をトーキングヘッドクリップに適用するには、4.2秒・30fpsのスターターテンプレートを使用します。template.html は縦型(1080x1920)、template-16x9.html は横型(1920x1080)で、スペックに "format": "horizontal" を指定すると選択されます。スタイルと画像は話者の言葉とは独立しているため、ユーザーが指定したトピックに従います。

使用方法

スキルフォルダは、スキル読み込み時に表示されるベースディレクトリから解決します。build.py はその実パスを通じて共有キットを解決し、シンボリックリンクとしてインストールされた場合でも動作します。実行方法:

python3 /path/to/skills/orbit-reel/build.py /path/to/spec.json

サンプルスピーカーはバンドルされていません。ユーザーの映像は、スペックの assets キー(speaker.mp4 / speaker_cut.webm、横型テンプレートでは1920x1080のファイルも使用)で指定するか、一度 assets/my-media/ にドロップして(README参照)、スペックなしで実行します。出力はリポジトリの .work/ ディレクトリに保存されます。--prepare-only を指定すると、レンダリングせずに編集可能なコンポジションをビルドします。Python 3.9以上、ffmpeg/ffprobe、Node.js 22+/npmが必要です。初回ビルド時、固定バージョンのGSAP 3.15.0が無視されるベンダーキャッシュにダウンロードされます。レンダリングにはHyperFrames 0.8.214を使用します。これらの短いテンプレートでは、トランスクリプトやAPIキーは不要です。スペックとカスタム映像の説明

処理の適用

パースペクティブを持った単一のpreserve-3dシーンを維持し、z=0にフレーム位置合わせされたアルファ合成のプレゼンターを配置します。zが負のカードは話者の背後を、正のカードは前景を通過します。ベースビデオとカットアウトは同じソースオフセットに設定します。サンプルでは8枚のカード、570pxの水平方向の軌道、290pxの奥行きを使用しています。リングは新しいスピーカーのクロップに合わせて調整してください。すべてのカードの初期ポーズには、明示的にタイムライン位置0を設定し、すべてのカードがフレームゼロで存在するようにします。

アセットキー: banana-heels.jpg, blue-stairs.jpg, cactus.jpg, speaker.mp4, speaker_cut.webm, pixel-burger.jpg, pixel-fruit.jpg, red-stairs.jpg。フル解像度のサンプル画像とソースのクレジットは assets/style-showcase にあります。

プレゼンターを変更する場合は、同じサイズでフレーム位置合わせされたアルファカットアウトを用意してください。既存の kit/cutout.py で作成できます(共有ガイド参照)。明るい画像と暗い画像の両方で髪や手を確認してください。ビルドヘルパーは自動的にセグメンテーションを行いません。

最初の結果フレームからプレゼンターが表示されるようにしてください。鮮明な写真とクリーンなタイポグラフィを使用します。重要なテキストと顔はプラットフォームのオーバーレイを避け、装飾画像はコンポジション全体を縮めずに、はみ出させてください。テンプレートのキャプションと画像アンカーは開始点であり、自動追跡ではありません。

レビューと納品

ヘルパーはメディアの寸法/長さを検証し、コンポジションを準備し、レンダラーチェックを実行し、MP4をレンダリングして完全にデコードします。最初のフレーム、主要な変更点、終了部分を確認してください。クロップアンカー、テキストの読みやすさ、ソースとカットアウトのタイミング一致をチェックします。デフォルトは無音です。発話、効果音、音楽はユーザーからリクエストがあった場合のみ追加または保持します。長めの編集では、HTMLのタイムラインとソースウィンドウを拡張する必要があります。長さだけを変更しても不十分です。

これらはローカルのClaude Code編集ワークフローです。サードパーティの画像権利は、アセットディレクトリ内のコードライセンスとは別に文書化されています。

ハウススタイル

Interのみ、アクセントカラー1色(#5000fa)、白いキャプションに柔らかい影、角丸のカード、フラットなサーフェス。1ビートにつきアクセントモーメントは1つに抑え、余分な色は追加しないでください。キット全体で別のアクセントカラーを試すには、EDIT_ACCENT=#rrggbb を設定します。ただし、これらのHTMLテンプレートは16進数を直接保持しているため、template.html / template-16x9.html 内で直接変更してください。

Individual skills in this repo

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

関連スキル