Communitygithub.com

Render Rigged 3D

完全18関節3Dスケルタルリギングによるプロシージャルアニメーション、フレーム単位の逐次動画検査、ゼロからのオーディオ制作を、ユーザーの厳密なフォルダベース指示ワークフローに従って実行するスキル。

Render Rigged 3D とは?

Render Rigged 3D は、18関節の3Dスケルタルリギングを搭載したプロシージャルアニメーションエンジンで、参考動画をフレーム単位で完全再現し、ユーザーの音声ファイルに同期したゼロからのSFX・音楽ステムを合成します。このスキルは、Claude Code, Cursor, Codex などのAIエージェント向けに設計されており、PyCairo + NumPy + FFmpeg を用いて1080×1920、30fpsの高品質3D動画をレンダリングします。主な特徴として、Sutherland-Hodgman法によるニアプレーンクリッピングや外向法線によるバックフェイスカリングでポリゴンの歪みやちらつきを防止し、18関節のキャラクターリグ(胴体、頭部、両腕、両脚)に加え、表情変化、3Dプロップ、マクロ物理ビュー(例:ノギンによるレール隙間計測)を備えています。ユーザーは、プロジェクトフォルダ内に参考動画と音声ファイルを配置し、フレーム単位の解析→オーディオ合成→プリビュー確認→本レンダリングの4ステップを指示するだけで、プロ品質の動画が生成されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdulahadofficial432-arch/Gemini_Argon_Video_Skills/tree/HEAD/Render%20Rigged%203D%20Videos%20Skill/Skills/Render%20Rigged%203D

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

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

プレビュー

スキル README より

Train Video 3D Sheet 01 (0s–25s): Crouched Hacksaw on 3D Rail, Steam Locomotive Pass-By, Parallel Canyon Bridges, Union Station Gold Bullion & Purple-Faced Boss
Train Video 3D Sheet 02 (25s–50s): Side-Profile Macro 3D Rail Joint with Vernier Caliper, Welded Rival Track, Vandergold Parlor Car, Jolting Coach & Unobstructed Newspaper
Train Video 3D Sheet 03 (50s–76.67s): Silver Coin in May Gap, White Paper in July Gap, Crushing Rival Rails, Beach Umbrella Tycoon & Steel Arch Bridge Plunge
Japan Job Culture 3D Sheet 01: 3D Office Environments, Reclining Desk-Propped Poses & Articulated 18-Joint Walk Cycles
Japan Job Culture 3D Sheet 02: Dynamic 3D Camera Angles, Expressive Spherical Heads & Prop Interactions
Japan Job Culture 3D Sheet 03: Climax 3D Sequences & Zero-Caption Studio Finish

ドキュメント

Render Rigged 3D — 完全スキル&ユーザー指示ワークフロー

1. ユーザーによる指示の与え方(ユーザーのワークフローメソッド)

ユーザーが新しい動画再現タスクを開始する際は、以下の厳密なワークフローに従います:

  1. メインワークスペース内に新規プロジェクトフォルダを作成(C:\Users\WayWe Work-Station\Downloads\Mate\<Project Folder>\):
    • 動画のトピックにちなんだ名前で、メインワークスペースフォルダ内に新しいフォルダを作成します(例:"Train Video"、"Japan Job Culture"、"Railroad Video"、"The Window That Breaks Japan's Gambling Law"、"80 Victories in a Plane Nobody Could See")。
  2. プロジェクトフォルダ内に参考動画+ナレーションを配置:
    • プロジェクトフォルダ内に以下を配置します:
      • 参考動画(例:"Example video 1.mp4"、"Jap vid.mp4"、"My video 0.mp4"、"My video 2.mp4")。
      • ナレーション音声ファイル:プロジェクトフォルダ直下、またはナレーション用サブフォルダ("VoiceOver"、"VoiceOver 01"、"VoiceOver 02")に配置。ファイル名は例:"Voiceover.mp3" または "Audio.mp3"。
  3. ユーザーのプロンプトパターン:
    • ユーザーは以下をあなたに依頼します:
      1. 参考動画をフレーム単位(Frame 0 から Frame N-1 まで)で読み取り、解析。厳密な時系列順で、フレームをスキップしたりサンプリングしたりせず、すべてのフレームをチェックし、以下の項目を記録します:
        • 正確なフレーム番号とタイムスタンプ(frame / fps)
        • カメラ位置、角度、動き(dx, dy、ズーム、チルト、ロール)、およびショットのフレーミング
        • 表示されているすべての人物、位置、動き、表情、体のポーズ、手/指、衣装/アクセサリー
        • オブジェクト、乗り物、背景/環境、照明、影、テキスト/ロゴ/看板、視覚効果
        • フレーム間の比較(何が変わったか、何が同じか、動きの方向/量、新しく追加/削除されたオブジェクト、モーフィング、フリッカー、生成アーティファクト)
      2. ユーザーのナレーションファイルを使用して、まったく同じ動画を100%ゼロから再現。正確なビジュアル、超アクティブな注目集めアニメーション、キャラクターリギング/動き、カメラのコレオグラフィー、明確な視覚的説明を一致させ、固定の18関節3Dスケルタルリギングプロシージャルアニメーションスタイルで、キャプションなし、100%ゼロからのSFXおよび音楽ステムを使用してレンダリングします。

2. ビジュアルリファレンス&レンダリング済み3Dコンタクトシート(screenshots/)

A. 列車動画 — 18関節3Dリギング再現&マクロ熱物理学(train_rigged_3d_sheet_01..03.jpg)

Train Video 3D Sheet 01 (0s–25s): Crouched Hacksaw on 3D Rail, Steam Locomotive Pass-By, Parallel Canyon Bridges, Union Station Gold Bullion & Purple-Faced Boss

Train Video 3D Sheet 02 (25s–50s): Side-Profile Macro 3D Rail Joint with Vernier Caliper, Welded Rival Track, Vandergold Parlor Car, Jolting Coach & Unobstructed Newspaper

Train Video 3D Sheet 03 (50s–76.67s): Silver Coin in May Gap, White Paper in July Gap, Crushing Rival Rails, Beach Umbrella Tycoon & Steel Arch Bridge Plunge

B. 日本の仕事文化 — 18関節3Dリギングコーポレートアニメーション(japan_rigged_3d_sheet_01..03.jpg)

Japan Job Culture 3D Sheet 01: 3D Office Environments, Reclining Desk-Propped Poses & Articulated 18-Joint Walk Cycles

Japan Job Culture 3D Sheet 02: Dynamic 3D Camera Angles, Expressive Spherical Heads & Prop Interactions

Japan Job Culture 3D Sheet 03: Climax 3D Sequences & Zero-Caption Studio Finish


3. 固定の18関節3Dスケルタルリギングアニメーションアーキテクチャ

Render Rigged 3D で作成されるすべての動画は、100%ゼロからの3Dプロシージャルエンジン(PyCairo + NumPy + FFmpeg、1080×1920、30.00 fps) を使用し、2Dの棒人間的なショートカットやポリゴンのグリッチを一切排除します:

A. グリッチフリーの3Dカメラ&ポリゴンパイプライン(Camera3D、clip_and_project_poly、draw_box_3d)

  1. 真の3D透視カメラ(Camera3D):
    • ワールド空間での pos = (x, y, z)、target = (tx, ty, tz)、fov、ダッチアングル roll、有機的な手持ち揺れ(math.sin(t * 2.5) * 4.0)、高速ドリープッシュイン、ホイップパン、クレーンチルト、高周波ジャルトシェイクをサポート。
  2. Sutherland-Hodgman 3Dニアプレーンポリゴンクリッピング(NEAR_Z = 45.0):
    • 必須アンチグリッチルール:z_cam を単にクランプするだけで、カメラの後ろを横切る3D頂点を投影してはいけません。遠近法による除算の前に、すべての3Dポリゴン(clip_and_project_poly)をカメラのニアプレーン z_cam >= 45.0 に対して常にクリップし、長いレール、床、壁、橋が画面全体で折りたたまれたり歪んだりしないようにします。
  3. 決定論的3D外向法線バックフェイスカリング:
    • 必須アンチフリッカールール:draw_box_3d では、ボックスの面を頂点の平均奥行きでソートしてはいけません(これにより、隣接する面の深度順序が入れ替わり、カメラが動くたびにちらつきます)。常に外向法線によるバックフェイスカリング(np.dot(face_normal, cam.pos - face_center) > 0)を使用し、長いジオメトリ(線路のレールや枕木など)を奥から手前へのセグメントに分割します。

B. 18関節3D関節キャラクターリグ(draw_rigged_character_3d)

すべてのキャラクターは、18関節のスケルタル階層を使用して3Dワールド空間でアニメーション化されます:

  • 胴体&頭部チェーン(5関節):pelvis -> spine -> chest -> neck -> head
  • 左右腕チェーン(8関節):clavicle_L/R -> shoulder_L/R -> elbow_L/R -> wrist_L/R -> hand_L/R
  • 左右脚チェーン(6関節):hip_L/R -> knee_L/R -> ankle_L/R -> toe_L/R
  • 湾曲した3D関節四肢(draw_curved_limb_3d):
    • (shoulder, elbow, wrist) および (hip, knee, ankle) を通る滑らかな3次ベジェ関節四肢。シェーディングされた3D球状の手と3Dの靴を備えます。
  • 3D球状の頭部、帽子、フェイシャルリグ:
    • 放射状グラデーションの3Dシェーディング球体の頭部。遠近法的に短縮された目、瞳孔、眉毛、口の表情(neutral、grin、angry、rage、panic、worried、squint、closed_smile)を備え、(head_yaw, head_pitch, head_roll) に従って3D球体の表面を回転します。
    • 定期的な目のまばたき、胸の呼吸(math.sin(t * 4.5))、汗の滴、役割に応じた3D帽子/ベスト/スーツ(engineer、boss、tycoon、foreman、veteran、worker)、および特別な視覚状態(例:purple_anger により頭部が紫紺色に変化し、両耳から3Dの白い蒸気の噴出が発生)を含みます。
  • 障害物のない前面プロップ重ね順ルール:
    • キャラクターが読める前面プロップ(新聞、看板、書類など)を保持する場合は常に、3Dの上腕/前腕を最初に描画(プロップの背後に自然に隠れるように)、プロップを2番目に胸部の前面に描画、白い3D球状の手を3番目に左端と右端を握るように描画し、腕の線がテキストやイラストを横切らないようにします。

C. クリスタルクリアなビジュアルストーリーテリング&マクロ物理ビュー

  • ナレーションで説明されるすべての概念は、明確な3Dステージング、プロップ、専用マクロショットを通じて画面上で視覚的に説明されなければなりません:
    • マクロ3Dカットアウェイ&ゲージ:測定、物理、メカニズム(例:熱によるレール膨張)を説明する際は、専用のサイドプロファイル3Dマクロビュー(draw_macro_rail_joint_side_3d)を構築します。このビューには、3D Iビームプロファイル、ボルトで固定されたフィッシュプレート、正確な隙間をクランプするスライド式金属バーニヤキャリパー、上昇する水銀温度計、めくれるカレンダー(MAY -> JUNE -> JULY)、隙間に落ちる物理的な比較オブジェクト(銀貨 vs. 薄い紙)、および力/応力矢印(==><==) が含まれます。
    • マルチサブショットビジュアルペーシング:長いナレーションの文章を、明確な個別のビジュアルサブショットに分割します(例:サブショットAでマクロメカニズムを表示 -> サブショットBでキャラクターの反応を表示、またはサブショットAで新聞の見出しを表示 -> サブショットBで乗客が 'ALL ABOARD!' に向かって歩く様子を表示)。これにより、ビジュアルのペーシングがハイパーアクティブで魅力的なままになります。

3. ステップバイステップ実行プロトコル

新しいプロジェクトフォルダでトリガーされた場合:

ステップ1:完全な逐次フレーム単位検査(Frame 0 から Frame N-1 まで)

  1. 参考 .mp4 動画に対して analyze_every_frame.py を実行し、Frame 0 から Frame N-1 までのすべてのフレーム を時系列順に、フレームをスキップせずに検査します。
  2. 完全な逐次フレームレポートを <Project Folder>\Frame_By_Frame_Complete_Analysis_<N>_Frames.md に保存します。
  3. 6×4 コンタクトシート .jpg グリッド(1秒あたり1フレーム)と48kbpsの .mp3 オーディオプレビューを scratch/ に抽出し、read_file を使用してすべてのコンタクトシートとオーディオファイルを検査します(生の .mp4 には read_file を呼び出さないでください)。

ステップ2:ユーザーのナレーションに同期した100%ゼロからのオーディオステムを合成

  1. ユーザーのナレーションファイル(Voiceover.mp3 / Audio.mp3)の正確な長さ(VO_DURATION)を測定し、44.1 kHz 16ビットステレオの Voiceover.wav および Voiceover.mp3 に変換し、<Project Folder>\ に保存します。
  2. build_<project>_audio_stems.py を作成して実行し、NumPy + SciPy(scipy.signal.butter)を使用して以下を合成します:
    • SFX.wav & SFX.mp3:すべての視覚アクションに同期した、100%ゼロからの物理モデリングフォーリー(例:弓鋸のストローク、蒸気のパフ、ホイッスルのドップラー効果、金属の衝突、コイン/紙の落下、熱によるうなり、衝突、爆発)。
    • Music.wav & Music.mp3:感情の弧に合わせた、100%ゼロからのマルチアクト映画的/雰囲気スコア。
    • Full_Mixed_Audio.wav & Full_Mixed_Audio.mp3:Voiceover + SFX + Music を組み合わせたマスターミックス。自動エンベロープダッキングにより、ナレーションがクリスタルクリアに聞こえるようにします。

ステップ3:18関節3Dリギングレンダリングスクリプトのビルド&プレビュー確認

  1. render_<project>_rigged_3d_from_scratch.py を作成し、すべての参考ショットと視覚的説明を正確な VO_DURATION(TOTAL_FRAMES = int(math.ceil(VO_DURATION * 30)))にマッピングします。
  2. 必須のレンダリング前ビジュアルチェック(preview モード):
    • python render_<project>_rigged_3d_from_scratch.py preview を実行し、3枚のコンタクトシート(sheet_01.jpg、sheet_02.jpg、sheet_03.jpg、0.0s から VO_DURATION までを均等にカバーする72タイル)を生成します。
    • 3枚すべてのコンタクトシートを read_file で検査し、以下を確認します:
      • 3Dポリゴンの歪みやボックス面のちらつきがゼロであること
      • プロップ/四肢の重なりがゼロであること(手は新聞/看板の外側に、帽子/傘は適切にレイヤー化されていること)
      • すべてのストーリービートと物理メカニズムが視覚的に明確であること
      • ナレーションキャプションがゼロであること

ステップ4:フル30FPS 1080×1920動画をレンダリングし、成果物を確認

  1. python render_<project>_rigged_3d_from_scratch.py を実行し、TOTAL_FRAMES すべてのフレームを 1080×1920(30.00 fps)でレンダリングし、Full_Mixed_Audio.wav とマルチプレクスします。
  2. <Project Folder>\ に必要なすべての成果物が含まれていることを確認します:
    • Final_Video_No_Captions.mp4(フルミックスオーディオ、キャプションなし)
    • Pure_3D_Procedural_From_Scratch_No_Captions.mp4(純粋な3Dリギングレンダリングコピー)
    • Video_Only_No_Captions_Muted.mp4(クリーンなミュート動画マスター)
    • Frame_By_Frame_Complete_Analysis_<N>_Frames.md
    • Voiceover.wav & Voiceover.mp3
    • SFX.wav & SFX.mp3
    • Music.wav & Music.mp3
    • Full_Mixed_Audio.wav & Full_Mixed_Audio.mp3
    • scripts/:完全なPythonジェネレータースクリプトを含むディレクトリ。

Individual skills in this repo

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

関連スキル