Communitygithub.com

Avinash1286/pendent

Todo el conocimiento de animación para HyperFrames: reglas atómicas de movimiento, planos de escenas multifase, transiciones, técnicas de diseño de movimiento y siete adaptadores de tiempo de ejecución. Úselo para cualquier tarea de movimiento o animación.

¿Qué es pendent?

Este skill centraliza todo el conocimiento de animación para HyperFrames, un marco de trabajo para la creación de composiciones animadas deterministas y buseables. Proporciona un sistema de capas que va desde reglas atómicas (recetas GSAP reutilizables) hasta planos de escenas complejos de múltiples fases. El skill maneja siete adaptadores de tiempo de ejecución diferentes: GSAP (predeterminado para la mayoría del trabajo de movimiento), Lottie (para activos After Effects), Three.js (escenas 3D), Anime.js (tweening ligero), CSS keyframes, Web Animations API y TypeGPU/WebGPU (shaders). Cada uno se registra en una variable global específica para que HyperFrames pueda buscarlos en un solo paso. Se incluye un script de auditoría (`animation-map.mjs`) para analizar la coreografía de la composición después de su creación, detectando zonas muertas, problemas de consistencia y advertencias del ciclo de vida. También cuenta con 24 efectos de animación de texto con nombre a través de un skill externo. El skill impone restricciones críticas como el uso de una sola línea de tiempo en pausa, valores precalculados de diseño (sin `getBoundingClientRect()` en tiempo de interpolación) y transformaciones espaciales solo con alias de transformación de GSAP. Es ideal para desarrolladores de IA o agentes que necesitan generar animaciones predecibles y de alto rendimiento en HyperFrames. **Plataformas compatibles:** HyperFrames, GSAP, Lottie, Three.js, Anime.js, Web Animations API, CSS, TypeGPU/WebGPU.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Avinash1286/pendent/tree/HEAD/film/docs

Preguntar en tu IA favorita

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

Documentación

Animación HyperFrames

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

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

Predeterminado: componer reglas atómicas

Elija de 2 a 4 reglas de rules-index.md, combínelas en una sola línea de tiempo de GSAP en pausa y 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 predefinida existente de múltiples fases (revelación de marca, prueba social, etc.) y reutilizar su canalización de fases ahorra un tiempo real de autoría.
  • Desea un código ejecutable de referencia para una coreografía compleja de 4 a 5 fases.

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

Enrutamiento

Si desea...Lea
Elegir un patrón de movimiento atómico por desencadenante / etiquetarules-index.md
Leer la receta completa de HTML / CSS / GSAP de una reglarules/<name>.md
Elegir una plantilla de escena multifaseblueprints-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
Buscar 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 / interpolaciones / parámetros de posiciónadapters/gsap.md
GSAP — recetas de efectos integradosrules/gsap-effects.md
GSAP — transformaciones / rendimientoadapters/gsap-transforms-and-perf.md
GSAP — easing / staggeradapters/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
CSS keyframes (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), búsqueda currentTime)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, canalizaciones de cómputo)adapters/typegpu.md
HTML como textura + post-efectos WebGL/GLSL (capturar DOM en vivo con drawElementImage)adapters/html-in-canvas-patterns.md
Efectos de animación de texto con nombre (24 IDs a través del 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 y stagger. Todas las reglas atómicas de este skill se basan 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 impulsadas por shaders.
  • Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
  • CSS para motivos repetidos simples, decoración, destellos: 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, shaders personalizados).

Varios tiempos de ejecución pueden coexistir en una sola 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 un solo paso.

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 en la carga de página para clips de escenas posteriores, sin interpolaciones de display o visibility sin formato, y sin construcción de líneas de tiempo dentro de async / setTimeout / Promise). autoAlpha de GSAP y los conjuntos de visibilidad de duración cero en los límites explícitos de la línea de tiempo permanecen permitidos por el núcleo. Use esas excepciones solo en elementos que no sean clips o envoltorios dentro de un clip; el marco posee el ciclo de vida de .clip. No repita el contrato completo aquí.

Adiciones de arte de animación sobre el contrato del núcleo:

  • Constantes de diseño precalculadas — nunca derive posiciones de getBoundingClientRect() en tiempo de interpolación. Las mediciones del DOM en tiempo de interpolación se desincronizan porque el renderizador muestrea en paralelo; calcule las coordenadas una vez en la configuración de la composición y reutilícelas.
  • El movimiento espacial usa solo alias de transformación de GSAP (x, y, scale, rotation). La lista permitida 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 <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

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

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

Véase 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 ritmo (dirección creativa no relacionada con la animación)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Skills relacionados