Communitygithub.com

craft-2d-animation

Muestra a un agente cómo planificar, construir o editar 'animación 2D artesanal' para que el resultado concreto sea un movimiento que el agente pueda defender plano por plano. El procedimiento recorre la Animación 2D Artesanal (EffectCraft + FilmCraft): 1. Dirección visual y legibilidad de escena, 2. Encuadres y gramática visual. Úsalo cuando una nueva tarea requiera esta técnica.

¿Qué es craft-2d-animation?

Esta habilidad capacita a un agente de IA para crear animaciones 2D profesionales utilizando EffectCraft y FilmCraft, siguiendo una metodología estructurada que abarca desde la planificación visual hasta el renderizado eficiente. Se centra en principios de animación clásica como anticipación, acción y rebote, junto con una gramática visual detallada (planos generales, over-the-shoulder, medios y primeros planos) para contar historias sin depender del diálogo. Es especialmente útil para intros, demos de productos y cortometrajes, ya que incluye pautas para el diseño de personajes con siluetas contrastantes, decorados sobredimensionados para movimientos de cámara, y una jerarquía de anclas para personajes articulados que evita errores comunes en EffectCraft. Además, proporciona scripts reutilizables para la generación de proyectos, renderizado por lotes de bajo consumo y ensamblaje final en FilmCraft, todo optimizado para máquinas con recursos modestos. El agente puede verificar visualmente los planos mediante capturas clave y debe asegurarse de que la acción sea comprensible incluso sin sonido.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

Preguntar en tu IA favorita

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

Documentación

Animación 2D Artesanal (EffectCraft + FilmCraft)

Método general y reutilizable para diseñar, animar y ensamblar intros, demos de producto, escenas cortas o cortometrajes 2D en EffectCraft (con montaje/exportación opcional en FilmCraft), con o sin pista musical.

Referencia CLI/MCP y permisos Flatpak compartidos: ../craft-music-video/references/mcp-and-commands.md.


1. Dirección visual y legibilidad de escena

  1. Lugares identificables por el color: limitar una escena corta a 2 o 3 lugares como máximo, cada uno con una luz dominante y una paleta dedicada (p. ej., pasillo cálido/noche, puesto de trabajo iluminado por una pantalla, sala clara con un solo color de acento reservado para errores o alertas).
  2. Siluetas llenas en lugar de contornos huecos: construir los personajes y decorados con formas geométricas rellenas (curvas de Bézier o rectángulos redondeados) con rostros minimalistas (ojos, cejas, boca simples) y un ligero borde de contraluz (rim light) del lado de la fuente de luz.
  3. Contraste de siluetas: distinguir cada personaje desde la miniatura (p. ej., silueta redondeada que se encoge vs. silueta recta de hombros cuadrados y gestos bruscos).
  4. Decorados sobredimensionados para los movimientos de cámara: dibujar los fondos/paredes más anchos que el encuadre (2200–2400 px para un zoom/shake en 1920×1080, o 3600+ px para un travelling panorámico) para evitar cualquier borde negro de 10–20 px en los bordes del encuadre.

2. Encuadres y gramática visual

Variar los valores de plano para narrar la acción sin texto superfluo:

Valor de planoRol narrativoBuenas prácticas técnicas
Plano general (Establishing)Presentar el lugar, la iluminación y la posición relativa de los elementosMantener un punto de referencia espacial fijo (escritorio, pantalla, panel, puerta) al regresar al mismo lugar
Por encima del hombro (OTS)Mostrar el objetivo del personaje y su punto de vista sobre una interfaz u objetoReutilizar exactamente el mismo encuadre OTS entre el primer intento y el éxito final para crear un recordatorio visual inmediato
Plano medio / PerfilSeguir la postura, los desplazamientos y la evolución física de una escenaIdeal para mostrar un encogimiento progresivo, un retroceso en la silla o un gesto amplio
Primer plano (Close-up)Aislar una intención, un detalle de interfaz, una mano sobre una tecla, una mirada o un gagMantener los movimientos cortos y legibles; aprovechar el primer plano para despejar zonas negativas limpias

Cálculo de encuadre de cámara (cam_focus)

Con un nulo de cámara de ancla [0, 0], centrar un punto del mundo (tx, ty) en medio de un encuadre W × H a la escala sc % obedece exactamente a: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (disponible directamente mediante cam_focus(tx, ty, scale_pct, width, height) en ec_runtime.py).


3. Cambios de pose, peso y ritmo visual

  1. Anticipación → Acción → Rebote / Mantenimiento:
    • Nunca pasar linealmente de una pose A a una pose B.
    • Añadir una pequeña anticipación de sentido opuesto antes de la acción (p. ej., dedo que se levanta y duda antes de golpear una tecla, puerta que se abre ligeramente antes de cerrarse de golpe, cuerpo que se apoya antes de retroceder).
    • Terminar con un ligero rebasamiento (overshoot) o una pausa legible (hold) para dar peso (p. ej., personaje que retrocede un paso y hace una pausa para admirar su trabajo).
  2. Escalones de postura progresivos: durante una espera o un aumento de tensión, hacer evolucionar la postura por escalones nítidos entre dos planos (inclinación del torso, bajada de la cabeza, relajación de los brazos) en lugar de un flotamiento permanente.
  3. Mantener los planos entre dos acciones: dejar respirar la composición entre los acentos (parpadeos, micro-zoom lento, cursor que parpadea) en lugar de agitar todas las capas continuamente.
  4. Prueba muda obligatoria: visionar toda escena de acción, intro o demo sin el sonido (o mediante 3–5 capturas clave render-frame). El objetivo del personaje y la progresión de la escena deben seguir siendo 100 % comprensibles solo con la imagen.

4. Anclas de los personajes, de las cámaras y orden de apilamiento (Trampas EffectCraft)

Estas reglas evitan los errores de desfase, miembros separados o elementos ocultos en EffectCraft (comportamiento compatible con After Effects):

A. Nulos y cámaras

  • comp.layers.addNull() crea por defecto un ancla en [50, 50] y una posición en [960, 540]. Siempre forzar anchorPoint.setValue([0, 0]) antes de posicionar o emparentar el nulo (esto es lo que hace makeCamNull en ec_runtime.py).
  • Siempre asignar child.parent = parent ANTES de child.position.setValue(...), para que las coordenadas de child se interpreten directamente en el sistema de referencia local del padre.

B. Regla absoluta sobre el parenting y las transformaciones

  • Vincular a TODOS los hijos mientras el padre está en pose neutra (rotation = 0°, scale = [100, 100]).
  • Aplicar las rotaciones iniciales, zooms de cámara o keyframes del padre solo DESPUÉS de la creación completa de toda la jerarquía hija.
  • Por qué: modificar parent.rotation o parent.scale antes de asignar child.parent = parent desencadena una compensación inversa al estilo AE que proyecta la cabeza/los brazos fuera del cuerpo o encoge todo un decorado en una esquina del encuadre.

C. Jerarquía de anclas de un personaje 2D articulado

  • Personaje sentado: Root en las caderas (hip_pos) → Chair, Legs, TorsoNull (pivote cintura [0, 0]) → BackUpperArm (hombro) → BackForeArm (codo) → TorsoBody → Head (base del cuello) → UpperArm → ForeArm.
  • Personaje de pie: Root en el suelo entre los pies (foot_pos) para mantener los zapatos plantados en el suelo durante un zoom o un paso atrás → LegBack / LegFront (pivote caderas) + TorsoPivot (pivote caderas) → Arms, Blazer/Body, Head.
  • Empalme cuello / collar: agregar siempre una forma sólida de cuello / collar que superponga la parte superior del torso y la parte inferior de la cabeza para que una inclinación fuerte (25°–35°) nunca abra un hueco entre la barbilla y los hombros.

D. Orden de apilamiento (Stacking Order)

  • Dentro de una misma capa de forma (ADBE Root Vectors Group): el primer grupo agregado se dibuja ENCIMA, el último DEBAJO (orden delante → detrás).
  • Entre capas distintas de una composición: cada nueva capa se inserta en el índice 1 (ENCIMA). Construir las capas en el orden detrás → delante (fondo → resplandor → decorado → personaje → primer plano).

5. Legibilidad del texto y separación diegética / superposición

  1. Sin banda negra permanente: colocar los títulos, subtítulos o leyendas en el espacio negativo libre de cada plano (encima de una pantalla, en una esquina oscura de la pared, debajo de una línea de horizonte), sin superponer nunca un rostro, un borde de pantalla o un panel del decorado.
  2. Contraste y márgenes de seguridad:
    • Aplicar una sombra suave (ADBE Drop Shadow, opacidad 190–230, distancia 4–6 px, desenfoque 14–18 px) para garantizar la lectura sobre fondo claro u oscuro.
    • Respetar márgenes horizontales de seguridad (>= 70 px en 1920×1080) y un tiempo de mantenimiento legible (>= 0.35 s después del final de la acción o de la última palabra, incluso a través de un corte de plano).
  3. Separación estricta Texto diegético (V1) vs. Texto superpuesto (V2):
    • Texto integrado en el decorado (V1): letreros, interfaces de pantalla, hojas, pizarras, teclas de teclado. Forma parte del mundo animado y permanece presente en todas las exportaciones.
    • Texto superpuesto (V2, ProRes 4444 RGBA): títulos, cartelas, subtítulos, letras o anotaciones de interfaz de usuario. Colocarlo en composiciones transparentes separadas permite exportar con un clic una versión con títulos y una versión limpia en el montaje rigurosamente idéntica.

6. Verificación visual y renderizado eficiente en recursos

  1. Control mediante imágenes clave antes de cualquier renderizado de video: usar effectcraft-cli render-frame --max-side 960 en 1 o 2 instantes clave por plano (y --transparent para las superposiciones V2) para verificar encuadres, empalmes de articulaciones y legibilidad del texto en pocos segundos.
  2. Renderizado secuencial seguro (máquinas de 8 GB RAM / CPU modesta):
    • Renderizar 1 sola composición a la vez (nunca renderizados ProRes 4444 RGBA en paralelo en 8 GB de RAM).
    • Limitar los hilos (RAYON_NUM_THREADS=2, OMP_NUM_THREADS=2), ejecutar en prioridad baja (nice -n 15 ionice -c 3), evitar --gpu si la VRAM está compartida con la RAM del sistema, y dejar 2 s entre dos renderizados para liberar memoria.

7. Herramientas compartidas T3 Code y dependencias

Los scripts reutilizables se encuentran en ~/.t3/shared/craft-video/:

HerramientaRutaUso en animación 2D
Runtime JSX EffectCraft~/.t3/shared/craft-video/ec_runtime.pyImportar JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script para generar correctamente un .ecproj (ancla [0,0], Bézier, brillos, keyframes suavizadas/hold)
Renderizado por lotes secuencial~/.t3/shared/craft-video/render_ec_batch.shRenderizar las escenas V* (ProRes HQ RGB) y superposiciones L*/T* (ProRes 4444 RGBA) en baja carga con reanudación automática mediante ffprobe
Ensamblaje y exportación FilmCraft~/.t3/shared/craft-video/assemble_filmcraft.pyEnsamblar V1 (+ V2 alpha y A1 audio opcionales) en Rec.709 en un .fcproj y exportar Master + Clean

Dependencias necesarias

  • Python 3.9+ (solo biblioteca estándar)
  • ffmpeg y ffprobe
  • CLI de EffectCraft (effectcraft-cli o Flatpak ai.storyteller.effectcraft con acceso --filesystem)
  • CLI de FilmCraft (filmcraft-cli o Flatpak ai.storyteller.filmcraft) para el ensamblaje/exportación multipista
  • Opcionales Linux: nice, ionice, taskset

Comandos de ejemplo

# Verificar las dependencias disponibles (sin renderizado)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# Previsualizar el plan de renderizado secuencial de baja carga (escena + títulos alpha)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# Previsualizar el ensamblaje FilmCraft sin música (intro/demo muda, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados