Communitygithub.com

ido6/ai-video-skills

Blenderでポーンスタイル(箱型胴体+球体頭部のキャラクターをフラットカラーのプリミティブセットに配置)のプリビズ/ブロックアウトシーンを構築し、AI動画(Seedance、idoGen、Kling)用のモーション/構造参照としてエクスポートします。

ai-video-skills とは?

このスキルは、Blenderを使用してプリビジュアライゼーション(プリビズ)シーンを迅速に作成し、それをAI動画生成の参照として活用するためのものです。具体的には、箱型の胴体と球体の頭部を持つ「ポーン」キャラクターを、フラットカラーのプリミティブな家具や部屋の中に配置します。このシンプルなスタイルは、動きや構図に集中するために設計されており、AIモデルが模倣しやすいクリーンな構造参照を提供します。生成されたシーンは、MP4動画、最初と最後のフレーム、キーフレームの静止画、そしてBlendファイルとしてエクスポートされ、SeedanceやidoGenなどのAI動画ツールへの入力として使えます。スキルはBlenderのWorkbenchレンダリングを使用するため高速で、アニマティックの作成に適しています。主にClaude Codeや類似のAIエージェント向けに設計されており、バックグラウンドでの自動実行(推奨)と、ライブでのBlenderビューポート操作の2つの動作モードをサポートします。また、プリビズルック(落ち着いたパステルカラー)とトイルック(鮮やかなチームカラー)の2種類のビジュアルスタイルを切り替えられます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ido6/ai-video-skills/tree/HEAD/skills/blender-blockout-pawns

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

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

ドキュメント

Blender Blockout Pawns → AI動画プリビズ

このスキルは2つのことを行います。

  • BlenderでIdoの参照プリビズルックを再現します。純粋なポーンキャラクター(箱型胴体と球体頭部、四肢、顔、その他は一切なし)を、フラットカラーのプリミティブ環境内に配置します。
  • 各シーンをAI動画用の参照パッケージとしてエクスポートします。MP4、最初と最後のフレーム、キーフレーム静止画、.blendファイルを含みます。

レンダリングはWorkbench(ビューポートスタイル)を使用するため、アニマティックには十分な速さです。

セットアップ(パスはご自身の環境に合わせて調整してください)

  • Blender 5.2 は <BLENDER_EXE> にあります。ユーザー環境変数 BLENDER_PATH がそれを指しています。
  • キットファイルは <BLOCKOUTS_DIR>\_kit\blockout_kit.py にあります。これには後述のKITセクションと同じコードが含まれています。もし存在しない、または古い場合は、KITセクションをそのパスに書き戻してください。
  • 出力ルートは <BLOCKOUTS_DIR>\<SceneName>\ です。フォルダ <BLOCKOUTS_DIR> はセッションに接続されている必要があります。接続されていない場合は、device_request_folder_access でアクセスを要求してください。
  • シーンスクリプトは <BLOCKOUTS_DIR>\_scripts\<SceneName>.py に配置します。

実行モード — デフォルトではAを使用

A. バックグラウンド(動作確認済み。Blenderを開く必要はありません)

  1. シーンスクリプトをコンテナに書き込みます。先頭は以下で始まる必要があります。
    import math
    exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())
    
    次にビルド呼び出しを追加し、続けて r = export_for_ai() または render_still() を呼び出し、最後に print("RESULT", r) を記述します。
  2. スクリプトを _scripts\<SceneName>.py にコピーします。/mnt/user-data/outputs/ にステージし、その後 device_commit_files を使用します。
  3. PCのDesktop Commanderシェル経由で実行します。 & '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback' タイムアウトは約300秒に設定します。720pの5秒ショットは1分未満でレンダリングされます。
  4. device_stage_files で preview.png または first.png/last.png を取得し、Read で確認します。その後、反復します。

Blenderコネクタの execute_blender_code_for_cli は BLENDER_PATH を読み取ります。これは、その変数が設定されてからClaudeデスクトップアプリが再起動された後にのみ機能します。実行ファイルが見つからなかったと表示された場合は、上記のシェルルートを使用してください。

B. ライブ、開いているBlender内(コネクタの execute_blender_code、MCPアドオンサーバー実行時)。Idoがビューポートで監視または調整したい場合に使用します。

  • 最初の呼び出しで exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()) を実行し、次にビルド呼び出しを行います。
  • new_scene() は常に新しいシーンを作成するため、Ido自身のシーンが影響を受けることはありません。
  • 後の呼び出しで NameError が発生した場合は、exec 行を再度実行してください。

2つのルック

look="previs" (デフォルト)look="toy"
雰囲気落ち着いたダスティパステル。すべてのオブジェクトが異なる色鮮やかなチームカラー、ボードゲームの駒のよう
頭部胴体から約6cm浮いている滑らかな球体胴体に載っている/少し沈み込んでいる低ポリ球体(16×10)
色頭部と胴体は異なる色頭部と胴体は1つのチームカラー(white/black/red/blue/yellow/orange/green)を共有
照明スタジオ照明、シャドウなし、ソフトなワールドキャビティスタジオ照明+ソフトキャストシャドウ、キャビティなし (キャビティは低ポリ頭部にグリッド線を描く)
典型的なセット暗いプラム色の天井、ベッド、机、ドアのある部屋。台座上のマケットホール、丸いフェルトのテーブル、椅子、手すり。役割ごとに色分けされた群衆
露出+0.45+0.75

ポーンの胴体のサイズは0.48m×0.40m、標準身長は頭部を含めて1.86mです。子供は約1.2m、巨人は約3mです。seated=True は、chair() と組み合わせるために、座面の高さまで上げられた短い胴体を提供します。Idoのルール: ポーンは純粋に保つこと。 色、height=、seated=True のみを変更してください。鼻、手足、帽子、プロップを取り付けないでください。

Idoが指定しない場合は previs を使用します。チーム、カジノ、ゲーム、群衆、または強い色について言及する場合は toy を使用します。

ショットの構築

  1. new_scene(name, look, aspect="16:9") を呼び出します。アスペクト比の選択肢: 16:9=1280×720、9:16=720×1280 (Reels/TikTok)、1:1、4:5、21:9。作成するAI動画のアスペクト比に合わせてください。
  2. room() でセットを構築し、次に block()、bed()、table()、chair()、cylinder() で家具を配置します。10〜40のオブジェクトを使用します。ルックには非常に細かいディテールは必要ありません。open_walls=(1,) を使用すると、カメラを部屋の中に配置できます。
  3. character() でポーンを追加します。move() でアニメーションさせます。これはポーンを滑らせ、角で方向転換させます。プロップの周りのパスを計画してください。 ポーンは家具をすり抜けます。
  4. カメラを camera(loc, look_at, lens=20–28) で追加します。アイハイトは1.5〜1.7mで、軸を少しずらし、ハンドヘルドプリビズカメラのようにします。他の2つのフレーミング: マケットを見下ろす高い3/4ビュー、または2人のポーンの後ろからのオーバー・ザ・ショルダーショット。カメラを動かす場合は、開始フレームと終了フレームで cam.location と cam.rotation_euler をキーフレーム設定します。動きはシンプルに(プッシュイン、パン、オービット)保ちます。AIモデルはシンプルな動きを最もよくコピーするためです。
  5. 長さを設定します。ショットは通常5〜10秒: KIT["scene"].frame_end = 120 (24fpsで5秒)。move() は歩行をカバーするために frame_end をすでに延長しています。
  6. render_still() を呼び出して確認します。フレーミングが決まったら、export_for_ai() を呼び出します。
  7. シーン名、出力フォルダ、最初と最後のフレームを報告します。

参照動画から取った構図ルール

  • 壁、床、天井はそれぞれ独自の色を持ちます。プリビズでは、天井は非常に暗いプラム色(#3A3442)で、フレーム上部に暗い帯として読み取られます。
  • カメラは通常、部屋の内部に配置します。open_walls を使用して、カメラの後ろの壁を除外します。
  • ドアは薄い板で、半開きにします。room() の door= パラメータは開口部を切り取り、ドア板を追加します。
  • 散らかりは、机の上に散らばった紙や壁の付箋紙など、平らで薄い箱で構成されます(ランダムなパステルカラーの0.15×0.01×0.2の箱)。
  • 群衆: ポーンをテーブルの周りにリング状に、カウンターの後ろに一列に、または警備員としてペアで配置します。トイルックでは、役割ごとに色分けします。
  • プロップはポーンのスケールを共有します。そのため、ポーンの頭部はドアの上部3分の1とほぼ同じ高さになります。

AI動画への受け渡し

export_for_ai(every=24) は以下のファイルを Videos\Blockouts\<Scene>\ に書き込みます:

  • <Scene>.mp4 はモーションと構造の参照です。ビデオ・トゥ・ビデオ、モーションコントロール、またはSeedanceやidoGenの「参照動画」入力用です。
  • first.png と last.png は構図入力です。フォトリアルな作業では、実際の開始/終了フレームを構築するイメージモデルにこれらを供給します(以下のオーバーライドを参照)。ドラフトテストでのみ直接使用してください。
  • keys/key_####.png は1秒あたり1枚の静止画です。これらを全方位参照マルチショット(@Image1…)やストーリーボードに使用します。
  • <Scene>.blend はシーンファイルで、後で編集するために保存されます。

生成プロンプトを作成するときは、モデルに対して参照のレイアウト、ブロッキング、カメラ移動を維持するように指示します。次に、最終的なルックを説明します。ポーンを実際の人間に置き換え、マテリアル、照明、ワードローブを追加します。各ポーンの色をキャラクターにマッピングします。例: "ピンク色の胴体のフィギュア = 赤いドレスの女性"。マルチショットSeedanceプロンプトの場合は、seedance-25 スキルに引き継ぎます。

フォトリアルAI動画への受け渡し: プレイブックオーバーライド (2026-10-06)

上記のルックはアニマティック用です。クリップがフォトリアルなSeedance 2.5 / idoGenのコントロールクリップである場合、Idoのプリビズプレイブックからの以下のルールが優先されます(詳細: idogen-video-brain → references/previs-to-seedance-playbook.md; レンズ選択: cinematography → references/camera-directing-playbook.md):

  • ニュートラルグレーのセット。 色付きの壁/天井は生成に色味をにじませます[現場]。フラットカラーはメインのポーンとストーリープロップにのみ残します。
  • すべてのプロキシは2つの手がかりで識別可能(色+高さ/形状/位置)。色のみのマッピングは信頼できません[現場]。ポーンの色がワードローブににじむ可能性がある場合は、ポーンをワードローブの色に塗ります[未確認]。
  • ストーリー上重要なプロップ(ボトル、トレイ、グラス)には、独自のシンプルなプリミティブを割り当てます。
  • 実際のスケール、床の存在、動いてはいけないものは動かさない、オーバーレイなし(パス、ギズモ、グリッド、フレームカウンター、テキスト)、オーディオトラックなし。
  • ショットごとに1つの支配的なカメラ移動、クリップごとに1つのショット。 ゆっくりとした肩のフロートのみをベイクします。速い揺れはテキストで要求するか、編集で追加します。
  • レンズは映画撮影上の決定事項であり、固定の20〜28mmのデフォルトではありません。クリップにベイクされます。9:16の場合は、センサーを36.7mm(回転させたALEXA Mini LFゲート)に設定し、Blenderのmmが実際のmmと一致するようにします。
  • クリップ仕様: 24fps、出力アスペクト比、秒単位の整数、≥4秒(Seedance最小値)、クリップ長 = 生成長、使用可能部分の後に実際のアニメーションのテールを含む。
  • first.png は開始フレームではありません。 これは、シートと一緒にフォトリアルな開始フレームを構築するイメージモデルへの構図入力です。ドラフトテストでのみ直接使用してください。
  • また、カメラ方向ごとに空のセットの静止画と上面図(位置計画)をエクスポートします。

KIT — blockout_kit.py の内容

# ---- BLOCKOUT KIT (セッションごとに1回ペーストし、その後ヘルパーを呼び出す) ----
import bpy, math, random, os, glob
from mathutils import Vector

OUT_ROOT = os.path.join(os.path.expanduser("~"), "Videos", "Blockouts")
ASPECTS = {"16:9": (1280, 720), "9:16": (720, 1280), "1:1": (1080, 1080), "4:5": (1080, 1350), "21:9": (1680, 720)}

PREVIS = ["#9C7393", "#8DB59A", "#88BDB0", "#C48DAA", "#ADB277", "#88A2B5",
          "#8E78AA", "#BFAE94", "#7FA393", "#B28AA1", "#A2C0AA", "#D6A9B8",
          "#B3A28A", "#7E5A70", "#9FA6C2"]
TOY = {"white": "#E8E8E2", "black": "#0B0C0E", "blue": "#1667A8", "yellow": "#C9A20E",
       "red": "#B0122E", "orange": "#C27A12", "green": "#2E6B4A", "felt": "#2A6A48",
       "cream": "#E6DDC4", "wood": "#5A3218", "brass": "#9C8240", "floor": "#E3D2B0",
       "wall_teal": "#4E7468", "wall_wine": "#5C3740", "wall_taupe": "#6B5E4C"}
KIT = {"look": "previs", "rng": random.Random(7), "col": None}

def _rgba(h):
    h = h.lstrip("#"); c = [int(h[i:i+2], 16) / 255 for i in (0, 2, 4)]
    lin = [x / 12.92 if x <= 0.04045 else ((x + 0.055) / 1.055) ** 2.4 for x in c]
    return (*lin, 1.0)

def _mat(hexcol, rough=0.85):
    name = "BK_" + hexcol.lstrip("#")
    m = bpy.data.materials.get(name)
    if m: return m
    m = bpy.data.materials.new(name); m.diffuse_color = _rgba(hexcol); m.roughness = rough
    m.use_nodes = True
    b = m.node_tree.nodes.get("Principled BSDF")
    if b: b.inputs["Base Color"].default_value = _rgba(hexcol); b.inputs["Roughness"].default_value = rough
    return m

def _pick(color):
    if color is None:
        return KIT["rng"].choice(PREVIS) if KIT["look"] == "previs" else TOY["cream"]
    return TOY.get(color, color)

def _link(ob):
    for c in ob.users_collection: c.objects.unlink(ob)
    KIT["col"].objects.link(ob); return ob

def new_scene(name="Blockout", look="previs", seed=7, fps=24, aspect="16:9", res=None):
    """look: 'previs' (ビデオ1-2: Workbench、落ち着いたランダムパステル、キャストシャドウなし)
             'toy'    (ビデオ3: 鮮やかなチームカラー、ソフトシャドウ、低ポリ頭部)"""
    KIT["look"] = look; KIT["rng"] = random.Random(seed)
    sc = bpy.data.scenes.new(name); KIT["scene"] = sc
    if bpy.context.window: bpy.context.window.scene = sc
    col = bpy.data.collections.new(name + "_SET"); sc.collection.children.link(col); KIT["col"] = col
    sc.render.fps = fps; sc.render.resolution_x, sc.render.resolution_y = res or ASPECTS[aspect]
    sc.render.resolution_percentage = 100; sc.frame_start = 1; sc.frame_end = 1
    sc.render.engine = "BLENDER_WORKBENCH"
    sh = sc.display.shading
    sh.light = "STUDIO"; sh.show_specular_highlight = False
    if look == "previs":
        sh.color_type = "MATERIAL"          # パレットはマテリアルにベイクされる(レンダリング間で安定)
        sh.show_shadows = False; sh.show_cavity = True
        sh.cavity_type = "WORLD"; sh.cavity_ridge_factor = 0.3; sh.cavity_valley_factor = 0.6
        sh.show_object_outline = False
    else:
        sh.color_type = "MATERIAL"; sh.show_shadows = True; sh.shadow_intensity = 0.35
        sc.display.shadow_focus = 0.6; sc.display.light_direction = (0.35, -0.45, 0.82)
        sh.show_cavity = False             # キャビティはファセット頭部にグリッド線を描く
    sc.view_settings.view_transform = "Standard"
    sc.view_settings.exposure = 0.45 if look == "previs" else 0.75   # 参照フレームの明るさに一致
    return sc

def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
    """軸に平行な箱。size=(x,y,z) メートル単位、loc = 底面の中心。"""
    bpy.ops.mesh.primitive_cube_add(size=1, location=(loc[0], loc[1], loc[2] + size[2] / 2))
    ob = bpy.context.active_object; ob.name = name; ob.scale = size; ob.rotation_euler.z = rot_z
    bpy.ops.object.transform_apply(scale=True)
    if bevel:
        m = ob.modifiers.new("Bevel", "BEVEL"); m.width = bevel; m.segments = 3
        bpy.ops.object.shade_auto_smooth(angle=math.radians(35))
    ob.data.materials.append(_mat(_pick(color))); return _link(ob)

def cylinder(name, r, h, loc, color=None, verts=32):
    bpy.ops.mesh.primitive_cylinder_add(radius=r, depth=h, vertices=verts, location=(loc[0], loc[1], loc[2] + h / 2))
    ob = bpy.context.active_object; ob.name = name; ob.data.materials.append(_mat(_pick(color))); return _link(ob)

def room(name="Room", w=6, d=5, h=2.8, t=0.1, ceiling=True, door=None, floor_color=None, wall_colors=None, open_walls=()):
    """各壁は独自のオブジェクトなので、各壁は独自の色を持ちます。
    door=(壁インデックス0..3、壁に沿ったオフセット、幅、高さ) は、その壁を分割して開口部を切ります。"""
    fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
    block(name + "_floor", (w, d, t), (0, 0, -t), fc)
    if ceiling: block(name + "_ceiling", (w, d, t), (0, 0, h), "#3A3442" if KIT["look"] == "previs" else "#5A5650")
    specs = [((w, t), (0, d / 2)), ((w, t), (0, -d / 2)), ((t, d), (w / 2, 0)), ((t, d), (-w / 2, 0))]
    for i, ((sx, sy), (x, y)) in enumerate(specs):
        if i in open_walls: continue   # 0=+Y 奥, 1=-Y 手前, 2=+X 右, 3=-X 左

        …

[以下、省略されたセクションの翻訳は原文の完全性を保つために継続する必要があります]

Individual skills in this repo

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

ido6/ai-video-skills

Design cinematic image and video prompts for genmedia. Use this for shot language, camera movement, lighting, lens choices, color grade, film texture, scene blocking, and production-ready visual direction.

ido6/ai-video-skills

Elite cinematic-video-prompt discipline for idoGen (mcp__idogen__generate_video, WaveSpeed/fal/poyo Seedance 2.0 and 2.5, Veo 3.1, Kling 3.0). Adapted from a production studio's CINEDANCE prompt-director system, folded together with GenHQ classroom technique (camera-movement library, Seedance 2.0-vs-2.5 dialect split, Kling 3.0 burger + @tag binding, Omni Flash video-to-video lock/preserve-list, storyboard mode, UGC/organic mode). Use this WHENEVER writing or fixing a prompt for mcp__idogen__generate_video, or when the user wants a cinematic/consistent/high-budget-looking video shot, camera control, a specific lens feel, spatial blocking across multiple shots, a scene that must match a previous shot's geography/lighting/character, a named camera move, a Kling multi-shot sequence, an edit of existing footage (Omni-style), or an organic/UGC/phone-shot look. Trigger even without the word "CINEDANCE" — any idoGen video-prompt build or repair task qualifies. Companion skills: idogen-image-brain (references/plat...

ido6/ai-video-skills

Generate Seedance 2.5 prompts for **multishot omni reference mode** — sequences where multiple reference images (@Image1, @Image2, etc.), and optionally videos and audio, are assigned across different shots. Use this skill when the user says "multishot", "omni reference", "omniref", uploads multiple references for a shot sequence, or asks for a multishot Seedance prompt. Do NOT use for single-shot, first+last frame, or generic Seedance prompts — those are separate skills. If the user just says "Seedance prompt" without indicating multishot, ask first.

関連スキル