Communitygithub.com

Zuhair-01/claude-skills-and-systems

Todo o conhecimento de animação para HyperFrames — regras atômicas de movimento, blueprints de cenas multifásicas, transições de cena, técnicas mais amplas de design de movimento E os sete adaptadores de runtime (GSAP padrão, além de 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 do 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, seguro para seek, determinístico.

O que é claude-skills-and-systems?

Este skill consolida todo o conhecimento de animação do sistema HyperFrames, oferecendo uma abordagem modular e eficiente para criar movimentos e animações em composições web. Ele é projetado para desenvolvedores que usam o ecossistema HyperFrames (como Claude Code, Cursor, Codex) e desejam implementar animações de forma rápida, consistente e determinística, sem depender de temporizadores ou loops infinitos. O skill é organizado em várias categorias: regras atômicas (receitas de movimento simples e reutilizáveis), blueprints (modelos de cena multifásicos prontos para uso), transições (entre cenas), técnicas (padrões de design de movimento) e adaptadores (APIs específicas de cada runtime, como GSAP, Lottie, Three.js, Anime.js, CSS, WAAPI e TypeGPU). Para a maioria dos casos, a abordagem recomendada é selecionar 2-4 regras atômicas e compô-las em uma timeline GSAP única e pausada, o que gera menos código e é mais rápido do que começar do zero com um blueprint. Blueprints são mais indicados para cenas complexas com 4-5 fases. O skill também fornece uma tabela de roteamento detalhada que mapeia cada necessidade (escolher regra, ler receita, consultar blueprint, autorar transição, ver técnica, auditar mapa de animação, consultar API de runtime) ao arquivo de documentação correspondente. Além disso, impõe restrições críticas para garantir determinismo e desempenho: proíbe medições de DOM em tempo de animação (usar constantes pré-calculadas), restringe propriedades animáveis a aliases de transform do GSAP (x, y, scale, rotation) e proíbe o uso de `Math.random`, `Date.now`, `repeat: -1`, entre outros. Por exemplo, para criar uma animação de fade-in e deslocamento, o desenvolvedor pode consultar `rules-index.md`, escolher as regras "fade-in" e "slide-up", e o skill gerará o código GSAP correspondente, garantindo compatibilidade com o contrato de composição HyperFrames. O script `animation-map.mjs` permite auditar a coreografia de uma composição existente, identificando zonas mortas e inconsistências de stagger.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/hyperframes-animation

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 único skill: regras (receitas atômicas), blueprints (modelos de cena multifásicos), transições (cena a cena), técnicas (padrões mais amplos de design de movimento) 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, cole-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 código executável de referência para uma coreografia complexa de 4-5 fases.

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

Roteamento

Se você quer…Leia
Escolher um padrão de movimento atômico por gatilho / tagrules-index.md
Ler a receita completa de uma regra (HTML / CSS / GSAP)rules/<nome>.md
Escolher um modelo de cena multifásicoblueprints-index.md
Ler a receita completa de um blueprintblueprints/<id>.md
Autorar uma transição de cena (orientada a CSS, entre dois clipes)transitions/overview.md, transitions/catalog.md
Consultar uma técnica mais ampla de design de movimentotechniques.md
Desfoque de movimento — efeito de obturador em um elemento e quando não usá-loreferences/motion-blur.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 prontos para usorules/gsap-effects.md
GSAP — transformações / desempenhoadapters/gsap-transforms-and-perf.md
GSAP — eases / staggeradapters/gsap-easing-and-stagger.md
GSAP — timeline / rótulosadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (exportações do After Effects, window.__hfLottie)adapters/lottie.md
Animação de personagens (ciclo de caminhada, mascote, fantoche articulado, gestos)adapters/lottie.md → Personagens
Three.js / WebGL (cenas 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(), seek currentTime)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é-criada (tipicamente exportações do After Effects), incluindo personagens que andam, gesticulam ou reagem.
  • Three.js para cenas 3D, movimento de câmera, visuais orientados por shaders.
  • Anime.js para tweens leves quando GSAP é exagero.
  • CSS para motivos simples e repetitivos, decoração, brilho — sem custo de animação em 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 todos 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 puro, e sem construção de timeline dentro de async / setTimeout / Promise). O autoAlpha do GSAP e configurações de visibilidade com duração zero em limites explícitos da 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 de .clip. Não reafirme o contrato completo aqui.

Acréscimos de criação 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 coordenadas uma vez na configuração da composição e reutilize.
  • Movimento espacial usa apenas aliases de transform do 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 <dir-composicao> \
  --out <dir-composicao>/.hyperframes/anim-map

Lê cada timeline GSAP registrada em window.__timelines, enumera tweens, amostra bboxes, calcula flags, gera animation-map.json. Use 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, depois pode inicializar a versão do pacote HyperFrames empacotado. Defina HYPERFRAMES_SKILL_PKG_VERSION=<versão> apenas ao executar o skill fora do CLI/instalação de skill empacotado 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ístico
  • hyperframes-creative — paletas, tipografia, narração, planejamento de batidas (direção criativa não relacionada a animação)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Habilidades Relacionadas