Communitygithub.com

cinematicanimation

エージェントが映画のようなアニメーションを計画、制作、編集する方法を示します。具体的な出力がすぐに使えるコピーやスクリプトになるようにします。このプロセスは、ルックを6行で定義し、CyclesまたはEEVEEエンジンを選択し、パイプラインに従って進みます。新しい課題がこの技術を必要とするときに使用します。

cinematicanimation とは?

このスキルは、AIエージェントがBlenderを使用して映画のようなアニメーション作品を制作するための包括的なワークフローを提供します。具体的には、トイキャラクターとフォトリアルな世界観を組み合わせたダークで雰囲気のある映像スタイルを、Cycles(高品質なリファレンスルック)またはEEVEE(短時間で同様のルックを実現)のどちらかのレンダリングエンジンで実現する方法を詳細に説明しています。スキルは、ブリーフィング、ショット計画、ワールドとキャストの構築、ライティング、パフォーマンス、レンダリング、仕上げという7つのステージからなるパイプラインを定義し、各ステージには通過基準(ゲート)が設定されています。また、cinematicanimationは、ユーザーの他のスキルであるrobloxmaxxing(ゲームアセット作成)やscriptmaxxing(インドネシア語ナレーション)と連携するように設計されており、ユーザーのアバター(Avatar)を使用した作品制作もサポートしています。このスキルは、コードブロックで示された具体的なコマンドやPythonスクリプト(cine_kitモジュール)を使用して、Blenderをヘッドレスモードで実行し、効率的にアニメーションを制作することを前提としています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aaksa/cinematicanimation/tree/HEAD

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

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

ドキュメント

cinematicanimation は何をしますか?

robloxmaxxingの隣にあるプレミアムレーン。そのスキルはゲームアセットと明るく賑やかな説明ワールドを作ります。こちらは映画を作ります:数人のキャラクター、暗い部屋、一つのランプ、音を消しても追えるストーリー。Cycles(リファレンスルック)またはEEVEE(以下の「エンジン」のルールに従えば、同じルックをはるかに短い時間で実現)でレンダリングします。

SKILL = このフォルダ。B = /Applications/Blender.app/Contents/MacOS/Blender (5.1)。BP = BlenderのPython (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13)、beatgrid.pyにのみ必要。その他のスクリプト: python3 -I。

セッションごとに一度読むこと: references/craft.md (ストーリー、ショット、編集、アニメーション、サウンド) と references/look.md (ライト、マテリアル、レンズ、グレーディング、レンダリング時間)。references/reference-films.md はエビデンスです:両方の映画をショットごとに測定したものです。このファイルの数値について議論する前に読んでください。

ルックを6行で

  1. おもちゃのキャラクター、現実世界。 顔が描かれたブロック。その周りのすべてはフォトリアルで、使い古され、小さなスケールです。
  2. 暗い。 フレームの中央輝度はフルレンジの0.10〜0.26。見えるランプが一つキーライトです。フィルライトなし、空なし。
  3. プロップの高さ。 カメラはテーブルレベルに近づけて配置し、被写界深度を浅くし、前景に柔らかいものを配置します。
  4. インサートがストーリーを運ぶ。 手、オブジェクト、読み取れるプロップ。約半数のショットに顔はありません。
  5. グリッドに合わせてカット。 ショットの長さは音楽のビートの整数倍または半拍です。テンポはストーリーに合わせて変化します。
  6. 沈黙もショットの一部。 音楽は転換点で一度だけ止まります。エンディングは顔か物体、そしてブラックアウトです。

エンジン: Cycles または EEVEE

K.setup(..., engine="CYCLES" | "EEVEE")。M4で1080x1920で計測:

エンジン1フレームあたり60秒のリール (1,440フレーム、2プロセス)使用するタイミング
Cycles, 160サンプル70〜90秒28〜36時間ヒーロースティル、カバー、短いティーザー
Cycles, 16サンプル, 40%サイズ11秒2時間 (ソフト:プレビュー、納品用ではない)カットの確認
EEVEE, 64サンプル, フルサイズ, ショットのセットのみロード6〜8秒1〜1.5時間約15秒以上のものの納品

EEVEEは、以下のルールを守れば、ルック(ヘイズ、ボケ、バックライトプラスチック、AgX)を維持できます。それぞれ、Negara Anginで代償を払って得たものです。

  • シーン構築後、K.eevee_lights(keep=(...))を呼び出すこと。 主要な動機付けられたライトのみが影を落とします。多数の小さな影用ライトは影プールをオーバーフローさせ、フレーム間でちらつきます。
  • 窓ガラスはアルファ、ガラスではありません。 EEVEEでの透過ガラスはスクリーンスペースを屈折させ(背後にあるものがぼやける)、ブレンド透過は黒くレンダリングされます。Principledのアルファ約0.14、surface_render_method = "BLENDED"を使用し、反射+バンプからのドロップを使用します。
  • EEVEEはガラス越しにピントを合わせることができません。 被写界深度は最も近いサーフェスの深度を読み取るため、ガラスの後ろにあるものはすべてガラス上にあるかのようにぼやけます。ガラスが被写体である間だけ表示し (K.visible)、ピントがガラスを通り過ぎたら非表示にします。
  • ガラスは影を落としません (eevee_lightsが行います): EEVEEはガラスを不透明として扱うため、窓や瓶を通る光は止まります。
  • 各ショットは、そのセットのみをロードしてレンダリングすること (--sets): ロードされたすべてのセットは毎フレーム評価されます(インスタンス化フィールド、雨)。Negara Anginではこれにより時間が半分になりました。2つのワーカーが同じジョブリストを処理できます。render_rangeはロックファイルでフレームを要求します。
  • モーションブラーとボリュームタイルサイズのコストはわずかです。64を超えるサンプルは、グレインパスで隠せる以上の効果はありません。
  • Cyclesはコースティクスがオフ:窓ガラスの後ろのライトは部屋に届きません。「窓の光」はガラスパネルの内側に配置します。

パイプライン

ステージ作業内容ゲート
0. ブリーフログライン、ループまたはチェーン、ステークオブジェクト、ロケーションごとのパレット、トラックとそのBPM (beatgrid.py)GATE B: ブリーフのすべての行が観察可能なものであること
1. ショット計画ショットを行として:サイズ、レンズ、動くもの、ビート単位の長さ;シーンごとに1つのマスターGATE S: craft.mdのルールが紙面上で成立すること
2. ワールド+キャストcine_kit: 部屋/通り、プロップ、ランプ、ヘイズ;K.Charフィギュアマスターのスチル、それぞれを一文で説明
3. ライト見えるランプからのキー、アクセント、エッジ;プレビューサイズで各カメラのstillすべてのショットのスチルに対するGATE L (look_gate.py)
4. パフォーマンスビート上のポーズ (hit, pose, face, talk)、カメラ移動、life()コンタクトシートが音なしでストーリーとして読めること
5. レンダリングrender_rangeを2〜3プロセス、16ビットPNG、既存ファイルはスキップフレーム数 = フィルムの長さ
6. 仕上げfinish.py (グロー、グレーディング、ソフトネス、ビネット、グレイン) + サウンドミックスフィルムに対するGATE L、GATE E (shotlist.py --bpm)、-14 LUFS

失敗したゲートは、そのステージで修正します:明るいフレームはグレーディングの問題ではなく、照明の問題です。

GATE B - ブリーフ (ビルドスクリプトの先頭のdocstring)

  • ログライン:欲求と代償を含む一文。
  • 形状:短くなるループ(ルールを一度示し、その後より速く繰り返す)またはチェーン(各シーンが次のシーンを開始するオブジェクトで終わる)。
  • ステークオブジェクト:顔や数字が付いた小さなもの(写真、請求書、チケット)。カメラがそれに寄るところ。
  • ロケーションごとのパレット:支配的な光の色1つ、影の色1つ、アクセント色1つ。場所ごとに異なる。
  • サウンド:トラック、そのBPM、音楽が入る場所、音楽が止まる3〜8秒間。
  • エンディング:最後のイメージ(顔または物体)と、その後のブラックの上に表示される1〜2語。
  • 除外事項:この映画が似てはいけないもの。

GATE L - ルック (リファレンスからの数値;scripts/look_gate.py)

測定値 (フルレンジの0-1)合格範囲リファレンス
フレーム中央輝度0.10〜0.260.20, 0.17
シャドウレベル (10パーセンタイルピクセル)0.09未満0.06, 0.04
明るいレベル (90パーセンタイルピクセル)0.22〜0.560.46, 0.36
ピーク (最も明るいピクセル)0.85以上0.91, 0.98
ブラックフロア0.05未満0.02, 0.02
彩度アンバー: 0.10〜0.30, ノワール: 0.03〜0.140.18, 0.07

各ショットの完成スチルで実行し、次にフィルム全体で実行します。単一の明るいインサートはWARNになる可能性があります。FAILは修正されます。「ピークが0.85未満」はフレーム内に実際のハイライトがないことを意味します:ランプ、きらめき、またはネオンチューブをレンズが見える場所に配置します。

GATE E - 編集 (scripts/shotlist.py film.mp4 --bpm N)

すべてのショットの長さはビートの整数倍または半拍です。平均ショット長は1〜3.5秒。最初の2つのショットは、そのシーンで最も長いものです。同じサイズとアングルのショットが2つ連続することはありません。3〜8秒の区間で音楽がありません。フィルムはブラックアウトの1秒以内に終了します。

シーンの構築

"$B" -b --factory-startup -P build.py -- --out out --stills        # 各ショット1スチル、半サイズ、各約10秒
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final &   # 2〜3回起動: 既存のフレームはスキップされます
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True)            # リールの場合は "9:16";納品の場合は preview=False
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()

examples/standoff/build.py は完全でテスト済みのバージョン (4ショット、7.2秒) です:新しいフィルムの出発点としてコピーしてください。

cine_kit 簡易リファレンス

必要なもの呼び出し方
シーンsetup(aspect, height, samples, preview), world(), room(), haze(size, loc, density)
サーフェスplastic (おもちゃの肌、バックライトで光る)、cloth(kind=weave/knit/leather)、wood(planks=)、brick、asphalt(wet=)、flat (フェルト、漆喰、金属)、glass、emit (ネオン、電球、スクリーン)
形状box (常に面取り済み)、cyl、torus(arc=)、text (3Dレター、ネオン単語)、paper (ポスター/請求書/カード、読み取り可能な行あり)、round_table、chair
ランプpendant (見えるシェード+電球+スポット)、neon (チューブ+マッチングフィル)、bokeh_lights、light(kind, loc, power, color=ケルビンまたはhex, target, size)
キャストChar(name, skin, shirt, pants, hat=hair/cap/fedora/beanie):.pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw)、.hit(frame, dur, ...) (スナップ+ホールド)、.face(frame, expr)、.talk(f0, f1)、.sit、.walk、.life()
提供キャラクターRigged("bugis_man" / "bugis_woman" / path.blend, at, yaw):ファイルからのキャラクターモデル、Charの高さ、** Charと同じポーズチャンネル** (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head)。ペイントされた顔:スワップ不可。そのため感情は頭、腕、カットから表現します。新しいワンピースモデルは scripts/rig_block.py で一度リギングし(最初にスライスから首、腰、腕の境界を測定)、K.CAST に追加します。リグは首を除いて剛体で、neck_blend.py で柔らかくします(「ネックシーム」参照)
ユーザーのアバターAvatar(at, yaw, pose):Aksaのリギング済みRobloxキャラクター (Roblox/blender/hero_face.blend)、Charの高さ。.pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...)、.hit、.sit、.life()、.head (カメラターゲット)、.face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink、その後一度 .finish()。ユーザーは自身のフィルムのヒーローです:主演にはAvatarを、他の全員にはCharを使用します
表情K.EXPRESSIONS: neutral, smirk, grin, angry, shout, shock, sad, shut, talk_a, talk_o, talk_m, side。スワップのみ、モーフィングは不可
ペイントされた顔での歌唱一度だけ: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (オルソ正面レンダリングでペイントされた口を見つけ、その色で10形状の口アトラスを自身の肌の上に描き、頭の骨にスキニングされたプレートを顔に配置;セル0=ペイントなので、静止時は不可視;その後、プレートの下にあるものがすべて頭に乗るように首を再ブレンド)。シーン内: K.Rigged(".../x_sing.blend").sing(words, f0, f1)、words = [{"word","start","end"}] はトラックの文字起こしから (faster-whisperの単語タイミング)。彼女が歌っている間は頭をレンズのほうに向けます:横顔は口を隠します
カメラCam(name, loc, target, lens, stop, focus, roll):.at(frame, loc, target, focus, roll)、.push(f0, f1, 0.06)、.handheld(amount);Cam.distance_for(lens, height) = その高さの被写体をフレームいっぱいに捉えるための距離 (推測ではなくサイズで近接カメラを配置);.clip_follow(f0, f1, subject) = キーフレーム化されたニアクリップ、頭の上を越えて手の中の電話に飛び込むため
可視性K.visible(ob, [(f0, f1), ...]):それらの範囲でのみレンダリング可視;非表示カーブのみに影響 (オブジェクトの全カーブをCONSTANTに設定しないこと:モーションがステップ状になる)
編集beats(bpm) -> ビートnのフレーム;cut_list([(name, cam, beats), ...], bpm) はカメラをマーカーにバインドし、各ショットのフレームを返す
出力still(path, frame)、render_range(dir, f0, f1)

stop は、被写体が40cmのコレクタブルであると仮定した場合のF値:2〜2.8はインサート、4は顔、5.6〜8はマスター。小さい値ほどぼやけます。

ユーザーの他のスキルとの連携

  • 脚本: インドネシア語のナレーションには scriptmaxxing を使用。数行に抑えること;1370万回再生のリファレンスにはナレーションがありません。
  • 音楽と効果音: ~/Ngonten/Maxxing/audio-lib (CC0)。ショット計画の前にトラックで beatgrid.py を実行します。
  • ユーザー自身のアバター: K.Avatar() は表情リグ(まばたき、眉、Roblox/blender/face/face_rig.py からの単語レベルのインドネシア語リップシンク)とともにロードします。K.Char.talk() は他の話者のみのための限定アニメーションです。試すには:build.py -- --avatar --stills。
  • プロップとセット: robloxmaxxing/blender/rbx_kit.py は同じスタッドスケールで構築;CC0 PBRテクスチャと現実世界のプロップには Poly Haven (Blender用MCP search_assets、または3d-assets MCP);1つのヒーロープロップには Meshy。リアルなプロップが重要です。
  • 縦型リール: --aspect 9:16。ここでのすべては有効;マスターは24〜28mmになり、奥行きはレンズ軸に沿って積み重なります。

クローズアップ作業のための苦労して得たルール (Negara Angin, 2026-11-21)

  • 測定してからフレーミング。 ショットのフレームにおける頭、手、プロップの評価位置をプリントし、Cam.distance_for でカメラを配置します。目検討で配置したマクロカメラは、2スタッド必要なオブジェクトから0.5スタッドの距離になってしまいました。
  • Robloxの手は大きなブロック。 手の中に「持たせた」電話は埋もれます;スクリーンの法線に沿って手の前にプロップを保持します。
  • プロップをボーンペアレントしてからワールド行列を設定してはいけません (原点に配置されます)。ポーズが保持されている間はプロップをワールド固定にするか、オペレーターでペアレントします。
  • スチルはカットマーカーを無視します。 カメラにバインドされたマーカーはそのフレームの scene.camera をオーバーライドします:スチルのためにマーカーをクリアします。
  • フックは1つのイメージと1つのイベントです。 フレーム1はすでに美しくなければならず (Negara Angin: 極限マクロで窓を滑り落ちる雨粒、その内部で屈折する部屋の光)、最初のビートでそれを変えなければなりません (キックがドロップを通してピントを移動させる)。
  • トランジションは後付けではなく設計する: スクリーンを通り抜けてそれが表示する世界へ (次のショットの最初のフレームをスクリーンイメージとしてレンダリング)、ショットから次のショットへ鞭のように振り抜くなど。

[以降の翻訳は省略]

関連スキル