Communitygithub.com

ido6/ai-video-skills

Blender에서 폰(pawm) 스타일(박스 몸통 + 구체 머리 캐릭터, 평면 색상 기본 세트)의 프리비즈(previs)/블록아웃(blockout) 장면을 제작하고, 이를 Seedance, idoGen, Kling 등 AI 영상 생성 도구를 위한 모션 및 구조 참조 자료로 내보냅니다.

ai-video-skills란 무엇인가요?

이 스킬은 Blender를 활용하여 AI 영상 생성을 위한 참조 장면을 빠르고 효율적으로 제작하는 방법을 제공합니다. 특히 Ido의 독자적인 '폰(pawm)' 스타일(박스 몸통과 구체 머리로 구성된 단순한 캐릭터)을 구현하여, 복잡한 모델링 없이도 영상의 레이아웃, 블로킹, 카메라 움직임을 명확히 전달할 수 있습니다. `previs`(부드러운 파스텔 색상)와 `toy`(채도 높은 팀 색상) 두 가지 룩을 지원하며, 각각 조명과 표현 방식이 다릅니다. 이 스킬은 Blender 5.2를 사용하며, Desktop Commander 셸을 통해 백그라운드에서 실행하거나 MCP 애드온 서버를 통해 실시간 뷰포트에서 작업할 수 있습니다. 최종 출력은 MP4 영상, 첫/마지막 프레임 이미지, 키프레임 스틸컷, .blend 파일로 구성된 참조 패키지이며, 이는 Seedance, idoGen, Kling과 같은 AI 영상 모델의 모션 제어, 비디오-투-비디오, 또는 참조 영상 입력으로 사용됩니다. 특히 2026년 10월 6일 업데이트된 플레이북 오버라이드 규칙에 따라 사실적인 AI 영상(Seedance 2.5/idoGen)의 제어 클립으로 사용할 때는 중성 회색 세트, 식별 가능한 프록시, 주요 소품, 실제 스케일 등 엄격한 규칙을 적용해야 합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Blender 블록아웃 폰 → AI 영상 프리비즈

이 스킬은 두 가지 작업을 수행합니다:

  • Blender에서 Ido의 참조 프리비즈 룩을 재현합니다: 평면 색상의 기본 환경 내에서 순수 폰(pawm) 캐릭터(팔다리, 얼굴, 장식 없이 박스 몸통과 구체 머리로 구성).
  • 각 장면을 AI 영상 참조 패키지로 내보냅니다: MP4, 첫 번째 및 마지막 프레임, 키프레임 스틸컷, .blend 파일.

렌더링은 워크벤치(뷰포트 스타일)를 사용하므로 애니매틱(animatic)에 충분히 빠릅니다.

설정 (사용자 환경에 맞게 경로 조정)

  • 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 라인을 다시 실행합니다.

두 가지 룩

look="previs" (기본값)look="toy"
느낌차분하고 먼지 낀 파스텔 색상. 모든 객체가 다른 색상채도 높은 팀 색상, 보드 게임 조각처럼
머리몸통 위 약 6cm 위에 떠 있는 부드러운 구체몸통 위에 놓이거나 약간 파고드는 저폴리곤 구체 (16×10)
색상머리 색상이 몸통 색상과 다름머리와 몸통이 하나의 팀 색상 공유 (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. 시선 높이 1.5–1.7m에서 camera(loc, look_at, lens=20–28)로 카메라를 추가합니다. 핸드헬드 프리비즈 카메라처럼 축에서 약간 벗어나게 배치합니다. 다른 두 가지 프레이밍: 마케트를 내려다보는 높은 3/4 뷰, 또는 두 폰 뒤의 어깨 너머 뷰입니다. 카메라 움직임을 위해 시작 및 종료 프레임에서 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 상자)).
  • 군중: 테이블 주위에 폰을 고리 모양으로, 카운터 뒤에 줄을 서게 하거나, 쌍으로 경비병을 배치합니다. 장난감 룩에서는 역할별로 색상을 지정합니다.
  • 소품은 폰의 스케일을 공유하므로 폰의 머리는 대략 문의 위쪽 1/3 높이와 같습니다.

AI 영상 핸드오프

export_for_ai(every=24)는 다음 파일을 Videos\Blockouts\<Scene>\에 기록합니다:

  • <Scene>.mp4는 모션 및 구조 참조 자료입니다. 비디오-투-비디오, 모션 제어, 또는 Seedance나 idoGen의 "참조 비디오" 입력용입니다.
  • first.png와 last.png는 구성 입력입니다. 사실적인 작업의 경우 실제 시작/종료 프레임을 구축하는 이미지 모델을 공급합니다(아래 오버라이드 참조); 초안 테스트에만 직접 사용하십시오.
  • keys/key_####.png는 초당 하나의 스틸컷입니다. 옴니-레퍼런스 멀티샷(@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):

  • 중성 회색 세트. 색상이 있는 벽/천장은 생성물에 색조를 번짐 [필드]. 주요 폰과 스토리 소품에만 평면 색상을 유지합니다.
  • 모든 프록시는 두 가지 단서로 식별 가능 (색상 + 높이/모양/위치); 색상 단독 매핑은 신뢰할 수 없음 [필드]. 폰 색상이 의상에 번질 수 있는 경우, 폰을 의상 색상으로 칠합니다 [미확인].
  • 스토리 중요 소품 (병, 쟁반, 안경)은 자체 단순 프리미티브를 얻습니다.
  • 실제 스케일, 바닥이 존재하고, 움직이지 않아야 하는 것은 없음, 오버레이 없음(경로, 기즈모, 그리드, 프레임 카운터, 텍스트) 및 오디오 트랙 없음.
  • 샷당 하나의 지배적인 카메라 움직임, 하나의 클립. 느린 어깨 플로트만 베이크하고, 빠른 흔들림은 텍스트로 요청하거나 편집에서 추가합니다.
  • 렌즈는 영화 촬영술 결정이며, 고정된 20–28mm 기본값이 아닙니다: 클립에 베이크됩니다. 9:16의 경우 센서를 36.7mm(회전된 ALEXA Mini LF 게이트)로 설정하여 Blender mm가 실제 mm와 같도록 합니다.
  • 클립 사양: 24fps, 출력 화면비, 정수초 단위, ≥4초 (Seedance 최소값), 클립 길이 = 생성 길이, 사용 가능한 부분 이후에 실제 애니메이션의 꼬리 포함.
  • first.png는 시작 프레임이 아닙니다. 이미지 모델에 대한 구성 입력으로, 시트와 함께 사실적인 시작 프레임을 구축합니다. 초안 테스트에만 직접 사용하십시오.
  • 또한 카메라 방향당 빈 세트의 스틸컷과 평면도(위치 계획)를 내보냅니다.

KIT — blockout_kit.py의 내용

# ---- 블록아웃 키트 (세션당 한 번 붙여넣은 후 헬퍼 호출) ----
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: 워크벤치, 차분한 랜덤 파스텔, 투사 그림자 없음)
             '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 = BOTTOM 면의 중심."""
    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=(wall_index 0..3, offset_along_wall, width, height)는 해당 벽을 분할하여 개구부를 자릅니다."""
    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.

관련 스킬