Communitygithub.com

ido6/ai-video-skills

Crea escenas de previs/blockout en Blender al estilo pawn (cuerpo de caja + cabeza esférica, personajes en entornos primitivos de colores planos) y expórtalas como referencias de movimiento/estructura para vídeo con IA (Seedance, idoGen, Kling).

¿Qué es ai-video-skills?

Esta habilidad permite construir rápidamente escenas de previsualización (previs) y blockout en Blender, usando un estilo minimalista de personajes tipo 'pawn' (cuerpo de caja y cabeza esférica, sin extremidades ni rostro) en entornos primitivos de colores planos. Está diseñada para crear referencias de movimiento y estructura que luego se pueden usar en herramientas de vídeo con IA como Seedance, idoGen o Kling. Soporta dos estilos visuales: 'previs' (pasteles apagados, ideal para animáticas) y 'toy' (colores saturados para equipos, juegos o multitudes). La exportación genera un paquete completo de referencia que incluye un MP4, los fotogramas primero y último, fotogramas clave y el archivo .blend. El renderizado usa el motor Workbench de Blender (estilo ventana gráfica), lo que lo hace lo suficientemente rápido para animáticas. La habilidad se ejecuta principalmente en segundo plano a través de la línea de comandos, sin necesidad de abrir Blender visualmente, aunque también se puede usar en vivo con el complemento MCP para que el usuario pueda ver y ajustar la escena en la ventana gráfica.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Blockout de Peones en Blender → Previsualización para Vídeo con IA

Esta habilidad hace dos cosas:

  • Recrea el aspecto de previsualización de referencia de Ido en Blender: personajes peón puros (un torso de caja y una cabeza esférica, sin extremidades, sin rostro y sin extras) dentro de entornos primitivos de colores planos.
  • Exporta cada escena como un paquete de referencia para vídeo con IA: un MP4, el primer y último fotograma, fotogramas clave y el archivo .blend.

El renderizado usa Workbench (estilo ventana gráfica), por lo que es lo suficientemente rápido para animáticas.

Configuración (ajusta las rutas a tu máquina)

  • Blender 5.2 está en <BLENDER_EXE>. La variable de entorno de usuario BLENDER_PATH apunta a él.
  • El archivo del kit está en <BLOCKOUTS_DIR>\_kit\blockout_kit.py. Contiene el mismo código que la sección KIT a continuación. Si falta o está desactualizado, escribe la sección KIT de nuevo en esa ruta.
  • Raíz de salida es <BLOCKOUTS_DIR>\<NombreEscena>\. La carpeta <BLOCKOUTS_DIR> debe estar conectada a la sesión. Si no lo está, solicita acceso con device_request_folder_access.
  • Scripts de escena van en <BLOCKOUTS_DIR>\_scripts\<NombreEscena>.py.

Modos de ejecución — usa A por defecto

A. En segundo plano (probado y funciona; no es necesario tener Blender abierto)

  1. Escribe el script de la escena en el contenedor. Debe comenzar con:
    import math
    exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())
    
    Luego añade las llamadas de construcción, seguidas de r = export_for_ai() o render_still(), y finalmente print("RESULT", r).
  2. Copia el script a _scripts\<NombreEscena>.py. Ponlo en /mnt/user-data/outputs/ y luego usa device_commit_files.
  3. Ejecútalo a través del shell de Desktop Commander en el PC: & '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<NombreEscena>.py' 2>&1 | Select-String 'RESULT|Error|Traceback' Usa un tiempo de espera de aproximadamente 300 s. Una toma de 5 s a 720p se renderiza en menos de un minuto.
  4. Recupera preview.png o first.png/last.png con device_stage_files y míralos con Read. Luego itera.

El execute_blender_code_for_cli del conector de Blender lee BLENDER_PATH. Solo funciona después de que la aplicación de escritorio de Claude se haya reiniciado desde que se configuró esa variable. Si dice que no se encontró el ejecutable, usa la ruta del shell anterior.

B. En vivo, dentro de Blender abierto (el execute_blender_code del conector, con el servidor MCP add-on en ejecución). Úsalo cuando Ido quiera ver o ajustar en la ventana gráfica.

  • En la primera llamada, ejecuta exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()), luego las llamadas de construcción.
  • new_scene() siempre crea una nueva escena, por lo que las escenas propias de Ido nunca se tocan.
  • Si una llamada posterior genera NameError, ejecuta la línea exec de nuevo.

Los dos estilos

look="previs" (por defecto)look="toy"
SensaciónPasteles apagados y polvorientos. Cada objeto es de un color diferenteColores de equipo saturados, como piezas de juego de mesa
CabezaEsfera lisa que flota unos 6 cm sobre el cuerpoEsfera de baja poligonización (16×10) que descansa / se hunde ligeramente en el cuerpo
ColorEl color de la cabeza difiere del color del cuerpoLa cabeza y el cuerpo comparten un color de equipo (blanco/negro/rojo/azul/amarillo/naranja/verde)
IluminaciónLuz de estudio, sin sombras, cavidad suave mundialLuz de estudio más sombras suaves proyectadas, sin cavidad (la cavidad dibuja líneas de cuadrícula en cabezas de baja poligonización)
Conjunto típicoHabitaciones con techo ciruela oscuro, cama, escritorio y puertas; maquetas sobre pedestalesPasillos, mesas redondas de fieltro, sillas, barandillas; multitudes coloreadas por rol
Exposición+0.45+0.75

El cuerpo del peón mide 0.48 an × 0.40 prof m, y la altura estándar es 1.86 m con la cabeza incluida. Los niños miden aproximadamente 1.2 y los gigantes unos 3. seated=True da un torso más corto elevado a la altura del asiento, para combinar con chair(). Regla de Ido: mantén el peón puro. Solo varía el color, height= y seated=True. Nunca añadas narices, extremidades, sombreros o accesorios unidos a él.

Cuando Ido no lo especifique, usa previs. Usa toy cuando mencione equipos, un casino, un juego, una multitud o colores fuertes.

Construcción de una toma

  1. Llama a new_scene(nombre, look, aspect="16:9"). Opciones de aspecto: 16:9=1280×720, 9:16=720×1280 (Reels/TikTok), 1:1, 4:5, 21:9. Que coincida con el aspecto del vídeo con IA que estás creando.
  2. Construye el set con room(), luego los muebles con block(), bed(), table(), chair() y cylinder(). Usa de 10 a 40 objetos; el estilo necesita muy poco detalle. Usa open_walls=(1,) para que la cámara pueda estar dentro de la habitación.
  3. Añade peones con character(). Anímalos con move(), que los desliza y los gira en las esquinas. Planifica las rutas alrededor de los accesorios, porque los peones atraviesan los muebles.
  4. Añade la cámara con camera(loc, look_at, lens=20–28) a la altura de los ojos 1.5–1.7 m, ligeramente descentrada, como una cámara de previsualización manual. Otros dos encuadres: una vista alta de 3/4 mirando hacia abajo a una maqueta, o sobre el hombro detrás de dos peones. Para un movimiento de cámara, establece fotogramas clave en cam.location y cam.rotation_euler al inicio y al final. Mantén los movimientos simples (acercamiento, paneo, órbita), porque los modelos de IA copian mejor los movimientos simples.
  5. Establece la duración. Una toma suele ser de 5 a 10 s: KIT["scene"].frame_end = 120 (5 s a 24 fps). move() ya extiende frame_end para cubrir la caminata.
  6. Llama a render_still() y revísalo. Cuando el encuadre funcione, llama a export_for_ai().
  7. Informa el nombre de la escena, la carpeta de salida y el primer y último fotograma.

Reglas de composición tomadas de los vídeos de referencia

  • Las paredes, el suelo y el techo tienen cada uno su propio color. En previs, el techo es de un ciruela muy oscuro (#3A3442), por lo que se lee como una banda oscura en la parte superior del encuadre.
  • La cámara suele estar dentro de la habitación. Usa open_walls para omitir la pared detrás de la cámara.
  • Las puertas son losas delgadas entreabiertas. El parámetro door= de room() corta la abertura y añade la losa.
  • El desorden se compone de cajas planas y delgadas, como papeles esparcidos sobre un escritorio o notas adhesivas en una pared (cajas de 0.15 × 0.01 × 0.2 en colores pastel aleatorios).
  • Multitudes: coloca peones en anillos alrededor de mesas, filas detrás de mostradores, o pares como guardias. En el estilo toy, colorea por rol.
  • Los accesorios comparten la escala del peón, por lo que la cabeza de un peón está aproximadamente al nivel del tercio superior de una puerta.

Entrega para vídeo con IA

export_for_ai(every=24) escribe estos archivos en Videos\Blockouts\<Escena>\:

  • <Escena>.mp4 es la referencia de movimiento y estructura. Es para vídeo a vídeo, control de movimiento, o la entrada de "vídeo de referencia" en Seedance o idoGen.
  • first.png y last.png son entradas de composición. Para trabajo fotorrealista, alimentan el modelo de imagen que construye el fotograma real de inicio/fin (consulta las anulaciones a continuación); úsalos directamente solo para pruebas de borrador.
  • keys/key_####.png es un fotograma fijo por segundo. Úsalos para la referencia múltiple de omni (como @Image1…) o guiones gráficos.
  • <Escena>.blend es la escena, guardada para ediciones posteriores.

Al escribir el prompt de generación, dile al modelo que mantenga el diseño, el bloqueo y el movimiento de cámara de la referencia. Luego describe el aspecto final: personas reales en lugar de los peones, con materiales, iluminación y vestuario. Asigna cada color de peón a un personaje, por ejemplo "la figura de cuerpo rosa = la mujer del vestido rojo". Para prompts de Seedance de múltiples tomas, pasa la mano a la habilidad seedance-25.

Entrega para vídeo con IA fotorrealista: anulaciones del manual de jugadas (2026-10-06)

Los estilos anteriores son para animáticas. Cuando un clip es un clip de control para Seedance 2.5 / idoGen fotorrealista, estas reglas del manual de previsualización de Ido tienen prioridad (detalle completo: idogen-video-brain → references/previs-to-seedance-playbook.md; elección de lente: cinematography → references/camera-directing-playbook.md):

  • Set gris neutro. Las paredes/techos de colores sangran el tono en la generación [campo]. Mantén el color plano solo en los peones principales y accesorios de la historia.
  • Cada referente identificable por dos señales (color + altura/forma/posición); el mapeo solo por color no es fiable [campo]. Si un color de peón puede filtrarse en el vestuario, pinta el peón del color del vestuario [no verificado].
  • Accesorios críticos para la historia (botella, bandeja, vasos) obtienen su propio primitivo simple.
  • Escala real, suelo presente, nada que se mueva que no deba, sin superposiciones (rutas, gizmos, cuadrícula, contador de fotogramas, texto) y sin pista de audio.
  • Un movimiento de cámara dominante por toma, un clip por toma. Hornea solo un flotador lento de hombro; solicita una sacudida rápida en el texto o añádela en la edición.
  • La lente es una decisión cinematográfica, no un valor fijo predeterminado de 20–28 mm: se hornea en el clip. Para 9:16, ajusta el sensor a 36.7 mm (puerta ALEXA Mini LF girada) para que los mm de Blender equivalgan a mm reales.
  • Especificaciones del clip: 24 fps, aspecto de salida, segundos completos, ≥4 s (mínimo de Seedance), duración del clip = duración de la generación, con una cola de animación real después de la parte utilizable.
  • first.png no es un fotograma de inicio. Es una entrada de composición para el modelo de imagen, que construye el fotograma de inicio fotorrealista junto con las hojas. Úsalo directamente solo para pruebas de borrador.
  • También exporta un fotograma fijo del set vacío por dirección de cámara y una vista superior (plano de ubicación).

KIT — el contenido de blockout_kit.py

# ---- KIT DE BLOCKOUT (pegar una vez por sesión, luego llamar a los ayudantes) ----
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' (videos 1-2: Workbench, pasteles aleatorios apagados, sin sombras proyectadas)
             'toy'    (video 3: colores de equipo saturados, sombras suaves, cabezas de baja poligonización)"""
    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):
    """Caja alineada a los ejes. size=(x,y,z) en metros, loc = centro de la cara 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 pared es su propio objeto para que cada pared tenga su propio color.
    door=(indice_muro 0..3, desplazamiento_a_lo_largo_del_muro, ancho, alto) corta una abertura dividiendo ese muro."""
    fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
    block(name + "_suelo", (w, d, t), (0, 0, -t), fc)
    if ceiling: block(name + "_techo", (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
        block(name + f"_pared_{i}", (sx, sy, h), (x, y, 0), wall_colors[i] if wall_colors else None)
    ...

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.

Skills relacionados