Communitygithub.com

lenguaje-de-animación

Muestra a un agente cómo planificar, construir o editar 'lenguaje de animación' para que el resultado concreto sea texto utilizable o un guion. El procedimiento recorre Lenguaje de Animación, La única distinción que importa y El vocabulario. Úsalo cuando una nueva tarea requiera este oficio.

¿Qué es lenguaje-de-animación?

Esta habilidad proporciona a un agente de IA un sistema completo y estructurado para diseñar y producir animaciones cortas (llamadas 'stingers') destinadas a vídeos explicativos con presentador. Va mucho más allá de simples reglas de estilo, definiendo una gramática visual completa con cinco elementos básicos (fondo, vidrio, brillo, trayectoria, estado) y una biblioteca de ocho tipos de stinger, cada uno con una duración específica y una frase narrativa asociada. La habilidad es especialmente útil para agentes que trabajan en entornos de edición de vídeo automatizada (como Hyperframes) y que necesitan generar especificaciones de animación coherentes y reutilizables. El flujo de trabajo está documentado en scripts de Python, y el sistema ya ha detectado y corregido varios defectos técnicos, lo que demuestra su madurez y robustez para la producción real. El skill distingue claramente entre 'escenas' (que explican y duran de 8 a 15 segundos) y 'stingers' (que gesticulan y duran de 2 a 4 segundos), y establece reglas precisas para el uso de material audiovisual de archivo (B-roll), diferenciando entre 'cita' (con tarjeta y crédito) y 'metraje' (a pantalla completa y sin fuente en pantalla). También proporciona un menú más amplio de reglas atómicas y planos de Hyperframes para cuando la biblioteca principal no es suficiente. En resumen, es una guía de autoridad para cualquier agente que necesite producir animaciones con un lenguaje visual consistente, profesional y técnicamente sólido.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

Preguntar en tu IA favorita

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

Documentación

Lenguaje de Animación

Hereda de skills/00-house-rules/SKILL.md. La implementación está en scripts/stingers.py; la galería que lo renderiza todo está en scripts/build_stinger_gallery.py.


La única distinción que importa

Una escena explica. Un stinger gesticula.

escenastinger
duración8–15 s2–4 s
transmiteun argumento que hay que leeruna idea que ya has oído
rostrooculto o PiPoculto — se corta HACIA él
cuántos3–6 en un vídeo de 10 minutosuno cada 20–40 s
si lo eliminasel argumento deja de calarel vídeo se aplana, pero no se equivoca

Confundir esto es el fallo más común. Una lista de tres elementos con contenido real es una escena compare; la misma lista como steps es decoración. Si un espectador necesita leerlo, no es un stinger.

Los stingers se cortan, no se superponen. Son dueños del encuadre durante sus pocos segundos. Un gráfico a pantalla completa con el presentador aún visible detrás se lee como un error, y 3 segundos sin su rostro no cuestan nada.


El vocabulario

Cinco elementos. Todo en la biblioteca es una combinación de ellos, que es lo que hace que animaciones no relacionadas se lean como un solo sistema.

fondoCasi negro con un suave realce radial. Nunca un #000 plano — un fotograma negro verdadero se lee como una caída de señal, no como un diseño.
vidrioRelleno translúcido ~4.5% de tinta, borde de 1px ~14%, radio 26. La profundidad proviene del borde y un brillo interior, nunca una sombra paralela en la tarjeta.
brilloUn barrido especular de ángulo bajo sobre una tarjeta cuando se asienta. Este es el movimiento característico — es lo que hace que un rectángulo plano se lea como un objeto físico.
trayectoriaCurvas delgadas discontinuas a ~10% de tinta. Las cosas viajan a lo largo de trayectorias. Nada se teletransporta.
estadoUna fila de pequeños puntos que indican el estado del sistema. Un cambio de color en esa fila dice "y entonces se rompió" sin una sola palabra de texto.

El escalonamiento es de 120–160 ms. Por debajo de 100 ms, los hermanos se leen como un solo objeto; por encima de 200 ms, el espectador empieza a esperar.

Cada stinger mantiene su último fotograma. Se corta contra la voz, por lo que terminar en cualquier fotograma después del remate debe ser seguro. Nada se repite en bucle; nada termina en un escenario vacío.


La biblioteca

{ "kind": "converge", "from": "todo confluye en un solo lugar", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
kindla frase bajo la que pertenecedur
converge"Todo esto confluye en un solo lugar." Los chips viajan por trayectorias discontinuas hacia un núcleo brillante; los puntos de estado se llenan a medida que recibe carga.3.0–3.6
overload"Y entonces dejó de funcionar." El mismo núcleo se agrieta en rojo. Comparte la geometría de converge para que ambos se corten juntos como una sola historia.2.4–3.0
steps"Hay tres de estos." Tarjetas de vidrio numeradas, escalonadas, con brillo en cada una. El más reutilizable y el más sobreexplotado.2.6–3.2
swap"Esto, no aquello." A se tacha y se retira hacia arriba; B llega debajo. Ambos permanecen legibles.3.0–3.6
countup"Era el cuarenta y tres por ciento." Un número asciende, la escala crece con el valor, sobre una línea de origen visible.2.6–3.4
beatsTres frases cortas, percusivas. Cada una tiene una entrada diferente en una misma cuadrícula de compás compartida.2.4–3.2
surround"Estás enterrado en herramientas." Chips etiquetados rodean un centro fijo y luego se cierran. El centro nunca se mueve.3.2–4.0
photoUna imagen encontrada, tratada. Tarjeta de vidrio, lento Ken Burns, título, línea de crédito.2.8–4.0
clipLa misma tarjeta que contiene metraje en lugar de una imagen fija. Sin Ken Burns — ya se mueve.2.4–3.0

Úsalos en composition.json exactamente como una escena — el mismo anclaje from / at / dur, el mismo error grave si la frase no se resuelve.


Metraje de archivo: el stinger photo / clip

Dos tratamientos, y full elige entre ellos. full es de aceptación explícita; omítelo y obtienes la tarjeta.

full: true — METRAJE DE ARCHIVOfull: false — CITA
encuadrea sangre, sin tarjetatarjeta de vidrio, brillo, deriva lenta
texto en el encuadreun tercio inferior que nombra qué es la tomatítulo y línea de crédito
fuente en el encuadrenuncaobligatorio
usar parametraje e imágenes fijas que transmiten un momentouna captura de pantalla, un gráfico, una página de precios, un documento

El metraje de archivo es a pantalla completa y no lleva referencia de fuente. Instrucción permanente del humano, 2026-08-14. Ocupa todo el encuadre como lo hace el metraje de archivo en cualquier edición que alguien haya visto. El único texto permitido sobre él es un tercio inferior que dice qué es la toma, nunca de dónde vino. La atribución sigue ocurriendo — en el _FINAL/ATTRIBUTION.md del drop (entrega), que fetch_stock.py escribe en el momento de la descarga y ninguna edición puede omitir. Pexels y Pixabay hacen opcional el crédito en el encuadre, por lo que el registro satisface la licencia por sí solo y el encuadre se mantiene limpio.

Esto reemplaza el párrafo que solía vivir aquí para el metraje de archivo, que decía que un clip a sangre "se lee como un vídeo diferente" y ponía todo en una tarjeta. Ese razonamiento sigue siendo válido para el caso de cita y solo para él: cuando se espera que el espectador lea el activo como evidencia que se está citando, full: false y la línea de fuente vuelve al encuadre.

El constructor sigue teniendo la tarjeta por defecto, y eso es intencionado. Invertir el valor por defecto retrataría silenciosamente cada escena photo ya escrita según él — entre ellas working/stingers/plan.json de drop-005 — y una especificación que renderizó una tarjeta ayer debe renderizar la misma tarjeta hoy. El trabajo nuevo solicita "full": true; skills/executive-animator siempre lo hace. El cambio de una palabra en st_photo es todo lo que se necesita si la tarjeta se retira por completo algún día.

Una nota de geometría: a sangre usa object-fit: cover, por lo que dale una fuente que ya sea 16:9. Un recorte 2.19:1 mostrado a pantalla completa pierde 221 píxeles de cada lado, que es cómo un diagrama termina con su primera y última columna cortadas mientras cada compuerta informa una caja correcta.

Un constructor, dos nombres. photo para una imagen fija, clip para metraje; se bifurca según la extensión del archivo, por lo que el nombre solo existe para hacer legible una especificación. Lo que realmente cambia:

photoclip
elemento<img><video muted playsinline> con temporización de framework
Ken Burnssí, 1.00 → 1.07 en la tarjetaninguno

El metraje no recibe Ken Burns. El clip proporciona su propio movimiento, y una rampa de escala sobre el movimiento real es precisamente lo que hace que el material de archivo se lea como tal. Una imagen fija es inmóvil y necesita la deriva para mantenerse viva; un clip no.

// Metraje de archivo. Pantalla completa, tercio inferior dice qué es, sin fuente en el encuadre.
{ "kind": "clip", "from": "todo se mueve a la vez", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "Todo se mueve a la vez" }

// Cita. Un documento que el espectador lee como evidencia, por lo que la tarjeta y el crédito vuelven.
{ "kind": "photo", "full": false, "from": "la página de precios cambió", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Precios de Anthropic, agosto 2026",
  "credit": "ANTHROPIC.COM · OBTENIDO 2026-08-13" }

El tercio inferior se sitúa en cap_left / cap_bottom, con valor predeterminado de 96 / 186 — apaisado, lo que limpia los 96 izquierdos y 132 inferiores de youtube_long. Un llamante 9:16 debe pasar su propio cap_bottom: los reels reservan 520 en la parte inferior y la banda de karaoke ocupa y 1150-1400, por lo que el valor predeterminado apaisado coloca un título debajo de la barra de progreso. No hay un par que sea correcto en ambos encuadres.

src se resuelve relativo al archivo de especificación y el constructor lo copia en el assets/ del proyecto, por lo que una ruta incorrecta falla ruidosamente en la construcción en lugar de como una tarjeta vacía. Obtén ambos de scripts/fetch_stock.py, que imprime el bloque listo para pegar.

La atribución es una obligación del registro, no del encuadre. Cada activo de nivel 3 obtiene su fila en el _FINAL/ATTRIBUTION.md del drop, escrito por fetch_stock.py en el momento de la descarga — eso es lo que config/broll-policy.md exige y no es opcional. Que el crédito también aparezca en el encuadre es una decisión de diseño, y para el metraje de archivo la respuesta es no. En una tarjeta de cita permanece, se renderiza con WCAG AA, y una atribución que nadie puede leer no es una atribución.

Resuelve cada imagen en orden de niveles primero. Una foto es de nivel 3: recurre a ella solo cuando tu propio metraje y una superposición de nivel 2 ambos no tengan genuinamente nada. El Ken Burns se ejecuta en el <img> dentro la tarjeta de recorte, nunca en la tarjeta misma.

⚠ No copies el patrón largo de inserción de vídeo de terceros. La referencia de la que proviene este lenguaje contiene 50 segundos de metraje de entrevista de otra persona. config/broll-policy.md lo prohíbe rotundamente, y ninguna cantidad de buen diseño de movimiento lo convierte en nuestro. Las fotos con atribución están bien; levantar medio vídeo no.


El menú más amplio — a qué recurrir cuando nada de lo anterior encaja

Existen dos corpus ascendentes y ambos son más grandes que esta biblioteca. Lee de ellos en lugar de inventar movimiento.

El skill hyperframes-animation — 48 reglas atómicas + 22 planos de escena. Cárgalo con Skill(hyperframes-animation), luego abre rules-index.md y lee la regla que necesitas en rules/<nombre>.md. El valor predeterminado de la casa es componer 2–4 reglas atómicas en una línea de tiempo pausada; un plano es para cuando quieres una toma completa de 4–5 fases.

El registro de bloques — 373 bloques instalables: npx hyperframes catalog --query "<concepto>", luego npx hyperframes add <bloque>.

Situación → regla

Seleccionado para un vídeo explicativo con presentador. Estas son las reglas que sobreviven a nuestro formato; el resto de las 48 asumen principalmente una interfaz de producto o un cursor guiado que no tenemos.

cuando la línea es…reglapor qué encaja
un número, una estadística, un porcentajecounting-dynamic-scale, stat-bars-and-fillsya implementado como countup; usa las reglas directamente para barras, anillos, rellenos de estrellas
una lista contundente, a alta velocidadkinetic-beat-slam, waterfall-entryimplementado como beats; waterfall-entry es la cascada más suave
una definición o un término que aterrizagradient-text-sweep, depth-scatter-assemblelos glifos nunca se mueven en el primero; el segundo los ensambla desde la profundidad
"aquí está la forma" (un diagrama)svg-path-drawel contorno se dibuja solo. Mídelo con getTotalLength() en la configuración
"está rodeado / enterrado / conectado"radial-surround, avatar-cloud-network, orbit-3d-entryimplementado como surround; los otros dos añaden líneas de conexión y entrada 3D
una idea reemplazando a otrascale-swap-transition, card-morph-anchor, morph-swapimplementado como swap; card-morph-anchor transforma el propio contenedor
"mira más de cerca esto"depth-of-field-blur, coordinate-target-zoom, viewport-changeenfoque selectivo, o una cámara virtual en un wrapper .world
énfasis en una palabra habladaasr-keyword-glow, css-marker-patternsbrillo sincronizado con marcas de tiempo de palabras — ya tenemos tiempos de palabras medidos
un acento duro y percusivochromatic-glitch, particle-burst, motion-blur-streakusa con moderación; como máximo uno por vídeo
un latido de aterrizaje tranquilotitlecard-reveal (plano), ambient-glow-bloomel movimiento bajo es la carga útil, no una deficiencia
cualquier entrada en absolutospring-pop-entranceel pop canónico. En caso de duda, este

Planos que vale la pena conocer

La mayoría de los 22 son formas de anuncios de lanzamiento de producto. Cuatro se corresponden con lo que realmente hacemos:

  • kinetic-type-beats — el caballo de batalla. Las palabras llevan la toma, sin escenario, sin superficie.
  • dataviz-countup — cuando los datos llevan el argumento.
  • comparison-split — dos capacidades sopesadas a la vez (nuestra escena compare es una prima plana).
  • titlecard-reveal — el latido de respiro, exactamente un movimiento contenido.

Omite cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate y el resto de la familia de demostraciones a menos que estemos mostrando realmente una interfaz de producto. Son excelentes y no son nuestro formato — un vídeo explicativo con presentador que de repente realiza una demostración falsa de una aplicación se lee como un anuncio.

El contrato que asume toda regla ascendente

Vale la pena saberlo antes de copiar una, porque romper esto no falla la verificación — falla la representación:

  • UNA línea de tiempo GSAP pausada en window.__timelines. Nunca reproducción automática, nunca una segunda línea de tiempo.
  • Seguro de búsqueda en ambas direcciones — fromTo con estados 'desde' explícitos, valores absolutos, nunca += relativo. El estado debe ser una función pura del tiempo de la línea de tiempo.
  • Determinista — sin Math.random(), sin Date.now(). Solo pseudoaleatorio derivado de índice. Repeticiones finitas, nunca repeat: -1.
  • Solo transformaciones y pintura. Los interpoladores de width / height / top / left están prohibidos; usa proxies de escala/traslación o máscaras.
  • El escalonamiento de grupos está limitado para que una llegada se lea como un solo latido: items × stagger ≤ ~0.5s.
  • Precalcula las constantes de diseño. Nunca derives una posición en el momento de la interpolación; el renderizador muestrea en paralelo y la medición se desincroniza.

Añadir un nuevo concepto

  1. Busca primero en el registro — npx hyperframes catalog --query "<concepto>". Existen 373 bloques. radial-surround, morph-swap, split-tilt-cards y particle-image-reveal son primos cercanos de cosas en esta biblioteca y pueden ser un mejor punto de partida que el código nuevo.
  2. Constrúyelo a partir de los cinco elementos anteriores. Un concepto que necesita un sexto elemento es o una escena, o una señal de que el vocabulario necesita una extensión deliberada — no una excepción.
  3. Añádelo a KINDS en scripts/stingers.py.
  4. Renderiza la galería y míralos todos juntos. Esa es la única manera de saber si uno nuevo se unió a la familia o simplemente aterrizó a su lado.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

Tres defectos que esta biblioteca ya detectó

Cada uno pasó una hyperframes check limpia antes de que nadie mirara un fotograma:

  1. GSAP no puede animar ::after. Resuelve los objetivos con querySelector, que nunca devuelve un pseudoelemento, por lo que cada brillo no hacía nada silenciosamente. El brillo ahora es un elemento hijo real (SHEEN_EL). Si añades una tarjeta, ponlo dentro.
  2. GSAP resuelve los tiempos iguales en la línea de tiempo en el orden de registro, no en el orden lógico. Añadir un interpolador en el mismo segundo que otro ya lo hace para empujarlo más tarde; el st_photo para una cita ahora devuelve la línea de crédito explícitamente en lugar de confiar en el orden.
  3. object-fit: cover recorta, no escala. La máscara de vitrina de converge para su núcleo aplica escala en lugar de depender del ajuste CSS. El error apareció al renderizar la galería — probe_frames capturó un desbordamiento de 4 píxeles en el este que check no vio.

Individual skills in this repo

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

Skills relacionados