Communitygithub.com

ido6/ai-video-skills

Crie cenas de previs/blockout no Blender no estilo pawn (corpo em caixa + cabeça esférica em conjuntos de primitivas de cores sólidas) e exporte-as como referências de movimento/estrutura para vídeos de IA (Seedance, idoGen, Kling).

O que é ai-video-skills?

Esta skill permite que agentes de IA (como Claude Code, Cursor, Codex) criem rapidamente cenas de pré-visualização (previs) no Blender usando o estilo visual característico de Ido, com personagens 'pawn' (torso em caixa e cabeça esférica, sem membros ou expressões) em ambientes simples de cores sólidas. Ela suporta dois estilos visuais: 'previs' (pastéis suaves e iluminação de estúdio, ideal para animatics) e 'toy' (cores saturadas de time, com sombras suaves, adequado para cenas de jogos ou multidões). A skill gera um pacote completo de referência para vídeo de IA, incluindo um MP4, os primeiro e último quadros, quadros-chave por segundo e o arquivo .blend, que podem ser usados como entrada para ferramentas como Seedance, idoGen e Kling. Ela oferece dois modos de execução: um modo em background sem interface, que utiliza o shell do Desktop Commander para renderização rápida, e um modo ao vivo dentro do Blender aberto (com o servidor MCP) para que o usuário possa ajustar a cena em tempo real.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Blender Blockout Pawns → Previs para vídeo de IA

Esta skill faz duas coisas:

  • Recria o look de referência de previs do Ido no Blender: personagens pawn puros (um torso em caixa e uma cabeça esférica, sem membros, sem rosto e sem extras) dentro de ambientes de primitivas de cores sólidas.
  • Exporta cada cena como um pacote de referência para vídeo de IA: um MP4, o primeiro e o último quadro, quadros-chave e o arquivo .blend.

A renderização usa o Workbench (estilo viewport), então é rápido o suficiente para animatics.

Configuração (ajuste os caminhos para sua máquina)

  • Blender 5.2 está em <BLENDER_EXE>. A variável de ambiente BLENDER_PATH aponta para ele.
  • O arquivo kit está em <BLOCKOUTS_DIR>\_kit\blockout_kit.py. Ele contém o mesmo código da seção KIT abaixo. Se estiver faltando ou desatualizado, escreva a seção KIT de volta nesse caminho.
  • Raiz de saída é <BLOCKOUTS_DIR>\<SceneName>\. A pasta <BLOCKOUTS_DIR> deve estar conectada à sessão. Se não estiver, peça acesso com device_request_folder_access.
  • Scripts da cena vão em <BLOCKOUTS_DIR>\_scripts\<SceneName>.py.

Modos de execução — use A por padrão

A. Background (comprovado que funciona; não precisa ter o Blender aberto)

  1. Escreva o script da cena no contêiner. Ele deve começar com:
    import math
    exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())
    
    Depois adicione as chamadas de construção, seguidas por r = export_for_ai() ou render_still(), e finalmente print("RESULT", r).
  2. Copie o script para _scripts\<SceneName>.py. Coloque-o em /mnt/user-data/outputs/ e depois use device_commit_files.
  3. Execute-o via shell do Desktop Commander no PC: & '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback' Use um timeout de cerca de 300 s. Uma tomada de 5 s em 720p renderiza em menos de um minuto.
  4. Recupere preview.png ou first.png/last.png com device_stage_files e veja-as com Read. Depois itere.

O execute_blender_code_for_cli do conector do Blender lê BLENDER_PATH. Ele só funciona depois que o aplicativo desktop Claude foi reiniciado desde que essa variável foi definida. Se ele disser que o executável não foi encontrado, use a rota do shell acima.

B. Ao vivo, dentro do Blender aberto (o execute_blender_code do conector, com o servidor MCP add-on em execução). Use isso quando Ido quiser assistir ou ajustar no viewport.

  • Na primeira chamada, execute exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()), depois as chamadas de construção.
  • new_scene() sempre cria uma nova cena, então as cenas do Ido nunca são tocadas.
  • Se uma chamada posterior gerar NameError, execute a linha exec novamente.

Os dois estilos visuais

look="previs" (padrão)look="toy"
SensaçãoPastéis suaves e empoeirados. Cada objeto é de uma cor diferenteCores saturadas de time, como peças de jogo de tabuleiro
CabeçaEsfera lisa que flutua cerca de 6 cm acima do corpoEsfera low-poly (16×10) que repousa / afunda levemente no corpo
CorCor da cabeça difere da cor do corpoCabeça e corpo compartilham uma cor de time (white/black/red/blue/yellow/orange/green)
IluminaçãoLuz de estúdio, sem sombras, cavity suave mundialLuz de estúdio mais sombras suaves projetadas, sem cavity (cavity desenha linhas de grade em cabeças low-poly)
Cenário típicoSalas com teto ameixa escuro, cama, mesa e portas; maquetes em pedestaisCorredores, mesas redondas de feltro, cadeiras, corrimãos; multidões coloridas por função
Exposição+0.45+0.75

O corpo pawn tem 0.48 m de largura × 0.40 m de profundidade, e a altura padrão é 1.86 m com a cabeça incluída. Crianças têm cerca de 1.2 e gigantes cerca de 3. seated=True dá um torso mais curto elevado à altura do assento, para combinar com chair(). Regra do Ido: mantenha o pawn puro. Varie apenas cor, height= e seated=True. Nunca adicione narizes, membros, chapéus ou adereços presos a ele.

Quando Ido não disser, use previs. Use toy quando ele mencionar times, um cassino, um jogo, uma multidão ou cores fortes.

Construindo uma tomada

  1. Chame new_scene(name, look, aspect="16:9"). Opções de aspecto: 16:9 = 1280×720, 9:16 = 720×1280 (Reels/TikTok), 1:1, 4:5, 21:9. Combine o aspecto do vídeo de IA que você está fazendo.
  2. Construa o cenário com room(), depois móveis com block(), bed(), table(), chair() e cylinder(). Use 10–40 objetos; o visual precisa de muito pouco detalhe. Use open_walls=(1,) para que a câmera possa ficar dentro da sala.
  3. Adicione pawns com character(). Anime-os com move(), que os desliza e os vira nas esquinas. Planeje caminhos ao redor de adereços, porque os pawns passam direto pelos móveis.
  4. Adicione a câmera com camera(loc, look_at, lens=20–28) na altura dos olhos 1.5–1.7 m, levemente fora do eixo, como uma câmera de previs manual. Dois outros enquadramentos: uma visão alta 3/4 olhando para baixo para uma maquete, ou por cima do ombro atrás de dois pawns. Para um movimento de câmera, keyframe cam.location e cam.rotation_euler nos quadros inicial e final. Mantenha os movimentos simples (push-in, pan, orbit), porque os modelos de IA copiam melhor movimentos simples.
  5. Defina a duração. Uma tomada geralmente é de 5–10 s: KIT["scene"].frame_end = 120 (5 s a 24 fps). move() já estende frame_end para cobrir a caminhada.
  6. Chame render_still() e revise. Quando o enquadramento estiver bom, chame export_for_ai().
  7. Relate o nome da cena, a pasta de saída e o primeiro e último quadros.

Regras de composição extraídas dos vídeos de referência

  • Paredes, piso e teto têm cada um sua própria cor. Em previs, o teto é muito escuro ameixa (#3A3442), então aparece como uma faixa escura no topo do quadro.
  • A câmera geralmente fica dentro da sala. Use open_walls para deixar de fora a parede atrás da câmera.
  • Portas são placas finas deixadas entreabertas. O parâmetro door= de room() corta a abertura e adiciona a placa.
  • Bagunça é feita de caixas finas e planas, como papéis espalhados em uma mesa ou notas adesivas em uma parede (caixas de 0,15 × 0,01 × 0,2 em cores pastéis aleatórias).
  • Multidões: coloque pawns em anéis ao redor de mesas, filas atrás de balcões, ou pares como guardas. No estilo toy, colora por função.
  • Adereços compartilham a escala do pawn, então a cabeça de um pawn está aproximadamente nivelada com o terço superior de uma porta.

Entrega para vídeo de IA

export_for_ai(every=24) escreve estes arquivos em Videos\Blockouts\<Scene>\:

  • <Scene>.mp4 é a referência de movimento e estrutura. É para vídeo-para-vídeo, controle de movimento, ou a entrada de "vídeo de referência" no Seedance ou idoGen.
  • first.png e last.png são entradas de composição. Para trabalhos fotorrealistas, alimentam o modelo de imagem que constrói o quadro inicial/final real (veja as substituições abaixo); use-os diretamente apenas para testes de rascunho.
  • keys\key_####.png é um quadro por segundo. Use-os para referência múltipla omni (@Image1…) ou storyboards.
  • <Scene>.blend é a cena, mantida para edições posteriores.

Ao escrever o prompt de geração, diga ao modelo para manter o layout, o bloqueio e o movimento da câmera da referência. Depois descreva o visual final: pessoas reais no lugar dos pawns, com materiais, iluminação e guarda-roupa. Mapeie cada cor de pawn para um personagem, por exemplo "a figura de corpo rosa = a mulher no vestido vermelho". Para prompts multishot do Seedance, passe para a skill seedance-25.

Entrega fotorrealista para vídeo de IA: substituições do guia (2026-10-06)

Os estilos visuais acima são para animatics. Quando um clipe é um clipe de controle para Seedance 2.5 / idoGen fotorrealista, estas regras do guia de previs do Ido têm precedência (detalhe completo: idogen-video-brain → references/previs-to-seedance-playbook.md; escolha de lente: cinematography → references/camera-directing-playbook.md):

  • Cenário cinza neutro. Paredes/ tetos coloridos sangram matiz na geração [campo]. Mantenha cor sólida apenas nos pawns principais e adereços da história.
  • Cada proxy identificável por duas pistas (cor + altura/forma/posição); mapeamento apenas por cor não é confiável [campo]. Se uma cor de pawn pode vazar para o guarda-roupa, pinte o pawn com a cor do guarda-roupa [não verificado].
  • Adereços críticos para a história (garrafa, bandeja, copos) ganham sua própria primitiva simples.
  • Escala real, piso presente, nada se movendo que não deveria, sem sobreposições (caminhos, gizmos, grade, contador de quadros, texto) e sem trilha de áudio.
  • Um movimento de câmera dominante por tomada, um clipe por tomada. Cozinhe apenas flutuação lenta do ombro; peça movimento rápido no texto ou adicione na edição.
  • A lente é uma decisão de cinematografia, não um padrão fixo de 20–28 mm: é cozida no clipe. Para 9:16, defina o sensor para 36,7 mm (gate ALEXA Mini LF rotacionado) para que os mm do Blender sejam iguais aos mm reais.
  • Especificação do clipe: 24 fps, aspecto de saída, segundos inteiros, ≥4 s (mínimo do Seedance), duração do clipe = duração da geração, com uma cauda de animação real após a parte utilizável.
  • first.png não é um quadro inicial. É uma entrada de composição para o modelo de imagem, que constrói o quadro inicial fotorrealista junto com as folhas. Use-o diretamente apenas para testes de rascunho.
  • Também exporte um still do cenário vazio por direção de câmera e uma visão superior (planta baixa).

KIT — o conteúdo de blockout_kit.py

# ---- BLOCKOUT KIT (cole uma vez por sessão, depois chame os helpers) ----
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' (vídeos 1-2: Workbench, pastéis aleatórios suaves, sem sombras projetadas)
             'toy'    (vídeo 3: cores saturadas de time, sombras suaves, cabeças low-poly)"""
    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"          # a paleta está cozida nos materiais (estável entre renderizações)
        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             # cavity desenha linhas de grade em cabeças facetadas
    sc.view_settings.view_transform = "Standard"
    sc.view_settings.exposure = 0.45 if look == "previs" else 0.75   # igual ao brilho do quadro de referência
    return sc

def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
    """Caixa alinhada ao eixo. size=(x,y,z) em metros, loc = centro da face INFERIOR."""
    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=()):
    """Cada parede é seu próprio objeto para que cada parede tenha sua própria cor.
    door=(wall_index 0..3, offset_along_wall, width, height) corta uma abertura dividindo aquela parede."""
    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 fundo, 1=-Y frente, 2=+X direita, 3=-X esquerda
        …
        block(name + f"_wall{i}", (sx, t, sy), (x, y, h / 2), (wall_colors or [None])[i] if wall_colors else None)
        if door and door[0] == i:
            _, off, dw, dh = door; block(name + f"_door_{i}", (dw, t, dh), (x + off, y, 0), "#A07050")

# (código truncado para tradução)

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.

Habilidades Relacionadas