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.
| escena | stinger | |
|---|---|---|
| duración | 8–15 s | 2–4 s |
| transmite | un argumento que hay que leer | una idea que ya has oído |
| rostro | oculto o PiP | oculto — se corta HACIA él |
| cuántos | 3–6 en un vídeo de 10 minutos | uno cada 20–40 s |
| si lo eliminas | el argumento deja de calar | el 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.
| fondo | Casi 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. |
| vidrio | Relleno 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. |
| brillo | Un 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. |
| trayectoria | Curvas delgadas discontinuas a ~10% de tinta. Las cosas viajan a lo largo de trayectorias. Nada se teletransporta. |
| estado | Una 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"] }
| kind | la frase bajo la que pertenece | dur |
|---|---|---|
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 |
beats | Tres 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 |
photo | Una imagen encontrada, tratada. Tarjeta de vidrio, lento Ken Burns, título, línea de crédito. | 2.8–4.0 |
clip | La 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 ARCHIVO | full: false — CITA | |
|---|---|---|
| encuadre | a sangre, sin tarjeta | tarjeta de vidrio, brillo, deriva lenta |
| texto en el encuadre | un tercio inferior que nombra qué es la toma | título y línea de crédito |
| fuente en el encuadre | nunca | obligatorio |
| usar para | metraje e imágenes fijas que transmiten un momento | una 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:
photo | clip | |
|---|---|---|
| elemento | <img> | <video muted playsinline> con temporización de framework |
| Ken Burns | sí, 1.00 → 1.07 en la tarjeta | ninguno |
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… | regla | por qué encaja |
|---|---|---|
| un número, una estadística, un porcentaje | counting-dynamic-scale, stat-bars-and-fills | ya implementado como countup; usa las reglas directamente para barras, anillos, rellenos de estrellas |
| una lista contundente, a alta velocidad | kinetic-beat-slam, waterfall-entry | implementado como beats; waterfall-entry es la cascada más suave |
| una definición o un término que aterriza | gradient-text-sweep, depth-scatter-assemble | los glifos nunca se mueven en el primero; el segundo los ensambla desde la profundidad |
| "aquí está la forma" (un diagrama) | svg-path-draw | el contorno se dibuja solo. Mídelo con getTotalLength() en la configuración |
| "está rodeado / enterrado / conectado" | radial-surround, avatar-cloud-network, orbit-3d-entry | implementado como surround; los otros dos añaden líneas de conexión y entrada 3D |
| una idea reemplazando a otra | scale-swap-transition, card-morph-anchor, morph-swap | implementado como swap; card-morph-anchor transforma el propio contenedor |
| "mira más de cerca esto" | depth-of-field-blur, coordinate-target-zoom, viewport-change | enfoque selectivo, o una cámara virtual en un wrapper .world |
| énfasis en una palabra hablada | asr-keyword-glow, css-marker-patterns | brillo sincronizado con marcas de tiempo de palabras — ya tenemos tiempos de palabras medidos |
| un acento duro y percusivo | chromatic-glitch, particle-burst, motion-blur-streak | usa con moderación; como máximo uno por vídeo |
| un latido de aterrizaje tranquilo | titlecard-reveal (plano), ambient-glow-bloom | el movimiento bajo es la carga útil, no una deficiencia |
| cualquier entrada en absoluto | spring-pop-entrance | el 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 escenacomparees 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 —
fromTocon 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(), sinDate.now(). Solo pseudoaleatorio derivado de índice. Repeticiones finitas, nuncarepeat: -1. - Solo transformaciones y pintura. Los interpoladores de
width/height/top/leftestá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
- Busca primero en el registro —
npx hyperframes catalog --query "<concepto>". Existen 373 bloques.radial-surround,morph-swap,split-tilt-cardsyparticle-image-revealson primos cercanos de cosas en esta biblioteca y pueden ser un mejor punto de partida que el código nuevo. - 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.
- Añádelo a
KINDSenscripts/stingers.py. - 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:
- GSAP no puede animar
::after. Resuelve los objetivos conquerySelector, 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. - 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_photopara una cita ahora devuelve la línea de crédito explícitamente en lugar de confiar en el orden. object-fit: coverrecorta, no escala. La máscara de vitrina deconvergepara su núcleo aplica escala en lugar de depender del ajuste CSS. El error apareció al renderizar la galería —probe_framescapturó un desbordamiento de 4 píxeles en el este quecheckno vio.