Communitygithub.com

MattiaIppoliti/tia-skills

Todo el conocimiento de animación para HyperFrames: reglas atómicas de movimiento, planos de escenas de múltiples fases, transiciones de escenas, técnicas de diseño de movimiento y los siete adaptadores de tiempo de ejecución (GSAP por defecto, más Lottie, Three.js, Anime.js, keyframes CSS, Web Animations API, TypeGPU).

¿Qué es tia-skills?

Este skill encapsula todo el conocimiento de animación para el framework HyperFrames, proporcionando reglas atómicas de movimiento, planos de escenas de múltiples fases y transiciones entre escenas. Incluye adaptadores para siete tiempos de ejecución diferentes: GSAP (por defecto), Lottie, Three.js, Anime.js, keyframes CSS, Web Animations API y TypeGPU/WebGPU. Es útil para cualquier tarea de movimiento o animación: seleccionar de 2 a 4 reglas atómicas y componer una animación, cargar un plano predefinido para una coreografía compleja de 4-5 fases, o consultar la API específica de un adaptador (por ejemplo, funciones de easing de GSAP, reproductor de Lottie o mezclador de Three.js). También cubre la auditoría de coreografía de una composición existente mediante el mapa de animación y 24 efectos de animación de texto nombrados. Está diseñado para HyperFrames: una sola línea de tiempo en pausa, segura para búsquedas y determinista. El skill mantiene un estado de contrato actualizado: la artesanía de movimiento (temporización, elecciones de easing, reglas y planos) sigue siendo válida, aunque el código de ejemplo está escrito contra el tiempo de ejecución anterior basado en HTML + GSAP timeline en pausa. Para usar en Remotion (el nuevo framework de salida), se deben traducir los ejemplos: GSAP a interpolate/spring, líneas de tiempo a useCurrentFrame, y atributos de datos a componentes Sequence.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-animation

Preguntar en tu IA favorita

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

Documentación

⚠ Estado del contrato: la artesanía está actualizada, el código no

El framework de salida de este stack es Remotion + React (/hyperframes-core). La artesanía de movimiento aquí sigue aplicando: temporización, elecciones de easing, la forma de un movimiento, las reglas y planos nombrados. El código no: los ejemplos y adaptadores están escritos contra el tiempo de ejecución retirado de HTML + línea de tiempo GSAP en pausa.

Traduciendo mientras lees:

AquíEn Remotion
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), ajustado visualmente
una línea de tiempo en pausa en window.__timelines[id]nada; cada valor es función de useCurrentFrame()
data-start / data-duration en un clip<Sequence from> / durationInFrames, en fotogramas
un keyframe o transición CSSestilo derivado del fotograma (la animación CSS no se renderiza)

Nunca pegues un ejemplo de este skill en un proyecto Remotion sin modificarlo.

Animación HyperFrames

Todo el conocimiento de movimiento en un skill: reglas (recetas atómicas), planos (plantillas de escenas de múltiples fases), transiciones (de escena a escena), técnicas (patrones más amplios de diseño de movimiento) y adaptadores (APIs por tiempo de ejecución).

Para el contrato de composición (atributos de datos, subcomposiciones, determinismo) consulta hyperframes-core.

Por defecto: componer reglas atómicas

Elige de 2 a 4 reglas de rules-index.md, pégalas juntas con una sola línea de tiempo GSAP en pausa, listo. Esto es más rápido y produce menos código que comenzar desde un plano.

Cargar un plano cuando

  • La escena coincide con una plantilla de múltiples fases pre-diseñada existente (revelación de marca, prueba social, etc.) y reutilizar su pipeline de fases ahorra tiempo real de autoría
  • Quieres código de referencia ejecutable para una coreografía compleja de 4-5 fases

Los planos viven en blueprints-index.md. Cada entrada apunta a blueprints/<id>.md (receta). No lo leas de forma especulativa; cárgalo cuando ya hayas decidido que necesitas orquestación a nivel de escena.

Enrutamiento

Quieres…Lee
Elegir un patrón atómico de movimiento por disparador / etiquetarules-index.md
Leer la receta completa HTML / CSS / GSAP de una reglarules/<name>.md
Elegir una plantilla de escena de múltiples fasesblueprints-index.md
Leer la receta completa de un planoblueprints/<id>.md
Crear una transición de escena (impulsada por CSS, entre dos clips)transitions/overview.md, transitions/catalog.md
Consultar una técnica más amplia de diseño de movimientotechniques.md
Analizar el mapa de animación de una composición existentescripts/animation-map.mjs
API de GSAP — línea de tiempo / tweens / parámetros de posiciónadapters/gsap.md
GSAP — recetas de efectos plug-and-playrules/gsap-effects.md
GSAP — transformaciones / rendimientoadapters/gsap-transforms-and-perf.md
GSAP — eases / escalonado (stagger)adapters/gsap-easing-and-stagger.md
GSAP — línea de tiempo / etiquetasadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (exportaciones de After Effects, window.__hfLottie)adapters/lottie.md
Three.js / WebGL (escenas 3D, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
Keyframes CSS (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), búsqueda por currentTime)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, pipelines de cómputo)adapters/typegpu.md
HTML como textura + post-efectos WebGL/GLSL (capturar DOM en vivo mediante drawElementImage)adapters/html-in-canvas-patterns.md
Efectos de animación de texto nombrados (24 IDs mediante el skill externo animate-text)adapters/animate-text.md

Elegir un tiempo de ejecución

  • GSAP es el predeterminado para el 95% del trabajo de movimiento: cubre orquestación de líneas de tiempo, transformaciones, easing, escalonado. Todas las reglas atómicas en este skill están basadas en GSAP.
  • Lottie cuando un activo tiene su propia línea de tiempo predefinida (normalmente exportaciones de After Effects).
  • Three.js para escenas 3D, movimiento de cámara, visuales impulsados por sombreadores.
  • Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
  • CSS para motivos repetidos simples, decoración, brillo — sin costo de animación JavaScript.
  • WAAPI para keyframes nativos del navegador sin dependencia de GSAP.
  • TypeGPU / WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, sombreadores personalizados).

Múltiples tiempos de ejecución pueden coexistir en una composición. Cada uno registra sus instancias en el ámbito global específico del tiempo de ejecución para que HyperFrames pueda buscar en todos ellos en una sola pasada.

Restricciones críticas

Prerrequisito: hyperframes-core → Reglas no negociables (una sola línea de tiempo en pausa, data-duration gobierna la duración, sin Math.random / Date.now / performance.now, sin repeat: -1, sin gsap.set al cargar la página en clips de escenas posteriores, sin interpolaciones de display o visibility sin procesar, y sin construcción de líneas de tiempo dentro de async / setTimeout / Promise). Los ajustes de autoAlpha de GSAP y visibilidad de duración cero en límites explícitos de la línea de tiempo siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o envoltorios dentro de un clip; el framework posee el ciclo de vida de .clip. No repliques el contrato completo aquí.

Adiciones de artesanía de animación sobre el contrato del núcleo:

  • Constantes de diseño precalculadas — nunca derives posiciones de getBoundingClientRect() en el momento de la interpolación. Las mediciones del DOM en tiempo de interpolación se desincronizan porque el renderizador muestrea en paralelo; calcula las coordenadas una vez en la configuración de la composición y reutilízalas.
  • El movimiento espacial usa solo alias de transformación de GSAP (x, y, scale, rotation). La lista blanca del núcleo también permite opacity / color / backgroundColor / borderRadius para interpolaciones de propiedades no espaciales, pero nunca width / height / top / left para cambios de diseño.

Scripts

node skills/hyperframes-animation/scripts/animation-map.mjs <directorio-de-composición> \
  --out <directorio-de-composición>/.hyperframes/anim-map

Lee cada línea de tiempo GSAP registrada en window.__timelines, enumera las interpolaciones, muestrea los cuadros delimitadores, calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia del escalonado, advertencias del ciclo de vida) después de la autoría.

animation-map.mjs primero resuelve los paquetes de ayuda del proyecto actual, luego puede iniciar la versión empaquetada del paquete HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<versión> solo cuando ejecutes el skill fuera de la instalación empaquetada de CLI/skill y necesites fijar esa versión de inicio explícitamente.

Ver también

  • hyperframes-core — estructura de composición, atributos de datos, subcomposiciones, contrato de renderizado determinista
  • hyperframes-creative — paletas, tipografía, narración, planificación de ritmos (dirección creativa no relacionada con animación)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

Skills relacionados