Communitygithub.com

Avinash1286/pendent

Todo o conhecimento de animação para HyperFrames — regras atômicas de movimento, blueprints de cenas multifásicas, transições de cena, técnicas amplas de motion design E os sete adaptadores de runtime (GSAP padrão, mais Lottie, Three.js, Anime.js, keyframes CSS, Web Animations API, TypeGPU). Use para qualquer tarefa de movimento ou animação: escolha 2-4 regras e componha, ou carregue um blueprint, ou consulte a API específica do runtime (ex.: eases GSAP / player Lottie / mixer Three.js). Também cobre auditoria da coreografia (mapa de animação) de uma composição existente e 24 efeitos de animação de texto nomeados. Nativo do HyperFrames: timeline única pausada, seek-safe, determinística.

O que é pendent?

Este skill centraliza todo o conhecimento de animação do ecossistema HyperFrames, permitindo que agentes de IA e desenvolvedores criem, componham e auditem animações de forma determinística e segura. Ele oferece regras atômicas de movimento (GSAP-based), blueprints de cenas multifásicas prontas para uso, transições entre cenas e técnicas gerais de motion design. Suporta sete runtimes de animação: GSAP (padrão), Lottie/dotLottie, Three.js/WebGL, Anime.js, CSS Keyframes, Web Animations API e TypeGPU/WebGPU, todos integrados à arquitetura de timeline única pausada do HyperFrames para seek e previsibilidade. O usuário pode consultar índices para escolher regras ou blueprints, acessar receitas detalhadas em markdown, usar scripts para auditar coreografias existentes e aplicar 24 efeitos de animação de texto via skill externo `animate-text`. Ideal para qualquer tarefa de motion design, desde pequenas interações até coreografias complexas de 4-5 fases, garantindo que a composição seja determinística (sem `Math.random`, `Date.now`, ou loops infinitos) e compatível com o contrato central do HyperFrames.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Animação HyperFrames

Todo o conhecimento de movimento em um skill: regras (receitas atômicas), blueprints (modelos de cena multifásicos), transições (cena a cena), técnicas (padrões mais amplos de motion design) e adaptadores (APIs por runtime).

Para o contrato de composição (atributos de dados, subcomposições, determinismo), consulte hyperframes-core.

Padrão: compor regras atômicas

Escolha 2-4 regras de rules-index.md, junte-as em uma única timeline GSAP pausada, pronto. Isso é mais rápido e produz menos código do que começar a partir de um blueprint.

Carregar um blueprint quando

  • A cena corresponde a um modelo multifásico pré-projetado existente (revelação de marca, prova social, etc.) e reutilizar seu pipeline de fases economiza tempo real de autoria
  • Você deseja um código de referência executável para uma coreografia complexa de 4-5 fases

Os blueprints residem em blueprints-index.md. Cada entrada aponta para blueprints/<id>.md (receita). Não o leia de forma especulativa; carregue-o quando já tiver decidido que precisa de orquestração em nível de cena.

Roteamento

O que deseja…Leia
Escolher um padrão de movimento atômico por gatilho / tagrules-index.md
Ler a receita HTML / CSS / GSAP completa de uma regrarules/<name>.md
Escolher um modelo de cena multifásicoblueprints-index.md
Ler a receita completa de um blueprintblueprints/<id>.md
Criar uma transição de cena (orientada a CSS, entre dois clipes)transitions/overview.md, transitions/catalog.md
Consultar uma técnica mais ampla de motion designtechniques.md
Analisar o mapa de animação de uma composição existentescripts/animation-map.mjs
API GSAP — timeline / tweens / parâmetros de posiçãoadapters/gsap.md
GSAP — receitas de efeitos prontas para usorules/gsap-effects.md
GSAP — transformações / desempenhoadapters/gsap-transforms-and-perf.md
GSAP — eases / staggeradapters/gsap-easing-and-stagger.md
GSAP — timeline / labelsadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (exportações do After Effects, window.__hfLottie)adapters/lottie.md
Three.js / WebGL (cenas 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(), currentTime seek)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, pipelines de computação)adapters/typegpu.md
HTML-como-textura + pós-efeitos WebGL/GLSL (capturar DOM ao vivo via drawElementImage)adapters/html-in-canvas-patterns.md
Efeitos de animação de texto nomeados (24 IDs via skill externo animate-text)adapters/animate-text.md

Escolhendo um runtime

  • GSAP é o padrão para 95% do trabalho de movimento — cobre orquestração de timeline, transformações, easing, stagger. Todas as regras atômicas neste skill são baseadas em GSAP.
  • Lottie quando um ativo tem sua própria timeline pré-definida (tipicamente exportações do After Effects).
  • Three.js para cenas 3D, movimento de câmera, visuais orientados por shader.
  • Anime.js para tweens leves quando GSAP é exagero.
  • CSS para motivos repetidos simples, decoração, brilho — sem custo de animação JavaScript.
  • WAAPI para keyframes nativos do navegador sem dependência de GSAP.
  • TypeGPU / WebGPU para canvases renderizados por GPU (partículas, vidro líquido, shaders personalizados).

Múltiplos runtimes podem coexistir em uma composição. Cada um registra suas instâncias no global específico do runtime para que o HyperFrames possa buscar todas elas em uma única passada.

Restrições Críticas

Pré-requisito: hyperframes-core → Regras Inegociáveis (timeline única pausada, data-duration governa a duração, sem Math.random / Date.now / performance.now, sem repeat: -1, sem gsap.set no carregamento da página para clipes de cenas posteriores, sem tweens de display ou visibility bruto, e sem construção de timeline dentro de async / setTimeout / Promise). GSAP autoAlpha e definições de visibilidade de duração zero em limites explícitos de timeline permanecem permitidos pelo core. Use essas exceções apenas em elementos não-clipe ou wrappers dentro de um clipe; o framework é dono do ciclo de vida .clip. Não reafirme o contrato completo aqui.

Adições de ofício de animação sobre o contrato do core:

  • Constantes de layout pré-calculadas — nunca derive posições de getBoundingClientRect() no momento do tween. Medições de DOM no momento do tween dessincronizam porque o renderizador amostra em paralelo; calcule as coordenadas uma vez na configuração da composição e reutilize.
  • Movimento espacial usa apenas aliases de transformação GSAP (x, y, scale, rotation). A lista de permissões do core também permite opacity / color / backgroundColor / borderRadius para tweens de propriedades não espaciais — mas nunca width / height / top / left para mudanças de layout.

Scripts

node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

Lê cada timeline GSAP registrada em window.__timelines, enumera tweens, amostra bboxes, calcula flags, gera animation-map.json. Use-o para auditar coreografia (zonas mortas, consistência de stagger, avisos de ciclo de vida) após a autoria.

animation-map.mjs resolve pacotes auxiliares do projeto atual primeiro, então pode inicializar a versão do pacote HyperFrames empacotada. Defina HYPERFRAMES_SKILL_PKG_VERSION=<version> apenas ao executar o skill fora da instalação empacotada do CLI/skill e você precisar fixar essa versão de inicialização explicitamente.

Veja Também

  • hyperframes-core — estrutura de composição, atributos de dados, subcomposições, contrato de renderização determinística
  • hyperframes-creative — paletas, tipografia, narração, planejamento de batida (direção criativa não relacionada a animação)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Habilidades Relacionadas