Communitygithub.com

correção-de-desempenho-de-animação

Audite e corrija problemas de desempenho de animação, incluindo thrashing de layout, propriedades do compositor, movimento vinculado à rolagem e efeitos de desfoque. Use quando animações apresentarem travamentos, transições com oscilações ou ao revisar desempenho de animações CSS/JS.

O que é correção-de-desempenho-de-animação?

Esta skill é projetada para desenvolvedores que precisam diagnosticar e corrigir problemas de desempenho em animações de UI, seja em CSS, JavaScript (incluindo WAAPI, rAF) ou bibliotecas como Motion e GSAP. Ela fornece um conjunto abrangente de regras categorizadas por prioridade e impacto, desde padrões que nunca devem ser usados (como intercalar leituras e escritas de layout no mesmo frame) até práticas recomendadas para mecanismos de animação, medição, rolagem, pintura, camadas, desfoque e filtros, além de transições de visualização. A skill também orienta o uso de ferramentas, enfatizando que bibliotecas de animação não devem ser migradas a menos que explicitamente solicitado. Com exemplos concretos de correções comuns (como substituir `width` por `transform` para evitar thrashing de layout) e uma abordagem de revisão que prioriza regras críticas, a ferramenta ajuda a garantir animações suaves e eficientes, evitando gargalos de renderização. É compatível com qualquer plataforma que utilize animações web, sendo útil tanto durante o desenvolvimento quanto em revisões de código.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/skills/fixing-motion-performance

Perguntar na sua IA favorita

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

Documentação

corrigindo-desempenho-de-movimento

Corrija problemas de desempenho de animação.

como usar

  • /corrigindo-desempenho-de-movimento Aplique estas restrições a qualquer trabalho de animação de UI nesta conversa.

  • /corrigindo-desempenho-de-movimento <arquivo> Revise o arquivo de acordo com todas as regras abaixo e relate:

    • violações (cite a linha exata ou trecho)
    • por que isso importa (uma frase curta)
    • uma correção concreta (sugestão em nível de código)

Não migre bibliotecas de animação a menos que explicitamente solicitado. Aplique as regras dentro da pilha existente.

Quando Usar

Consulte estas diretrizes quando:

  • adicionar ou alterar animações de UI (CSS, WAAPI, Motion, rAF, GSAP)
  • refatorar interações ou transições com oscilações
  • implementar movimento vinculado à rolagem ou revelar ao rolar
  • animar layout, filtros, máscaras, gradientes ou variáveis CSS
  • revisar componentes que usam will-change, transformações ou medições

glossário de etapas de renderização

  • composição: transform, opacity
  • pintura: cor, bordas, gradientes, máscaras, imagens, filtros
  • layout: tamanho, posição, fluxo, grid, flex

categorias de regras por prioridade

prioridadecategoriaimpacto
1padrões nuncacrítico
2escolher o mecanismocrítico
3mediçãoalto
4rolagemalto
5pinturamédio-alto
6camadasmédio
7desfoque e filtrosmédio
8transições de visualizaçãobaixo
9limites de ferramentacrítico

referência rápida

1. padrões nunca (crítico)

  • não intercale leituras e escritas de layout no mesmo frame
  • não anime layout continuamente em superfícies grandes ou significativas
  • não conduza animação a partir de scrollTop, scrollY ou eventos de scroll
  • sem loops de requestAnimationFrame sem condição de parada
  • não misture múltiplos sistemas de animação que cada um meça ou mute o layout

2. escolher o mecanismo (crítico)

  • prefira transform e opacity para movimento
  • use animação orientada a JS apenas quando a interação exigir
  • animação de pintura ou layout é aceitável apenas em superfícies pequenas e isoladas
  • efeitos únicos são mais aceitáveis ​​do que movimento contínuo
  • prefira rebaixar a técnica em vez de remover totalmente o movimento

3. medição (alto)

  • meça uma vez, depois anime via transform ou opacity
  • agrupe todas as leituras de DOM antes das escritas
  • não leia layout repetidamente durante uma animação
  • prefira transições no estilo FLIP para efeitos semelhantes a layout
  • prefira abordagens que agrupam medição e escritas

4. rolagem (alto)

  • prefira Linhas do Tempo de Rolagem ou Visualização para movimento vinculado à rolagem quando disponível
  • use IntersectionObserver para visibilidade e pausa
  • não consulte a posição de rolagem para animação
  • pause ou pare animações quando estiver fora da tela
  • movimento vinculado à rolagem não deve desencadear layout contínuo ou pintura em superfícies grandes

5. pintura (médio-alto)

  • animação que desencadeia pintura é permitida apenas em elementos pequenos e isolados
  • não anime propriedades pesadas de pintura em contêineres grandes
  • não anime variáveis CSS para transform, opacity ou position
  • não anime variáveis CSS herdadas
  • limite variáveis CSS animadas localmente e evite herança

6. camadas (médio)

  • movimento do compositor requer promoção de camada, nunca assuma
  • use will-change temporária e cirurgicamente
  • evite muitas ou grandes camadas promovidas
  • valide o comportamento das camadas com ferramentas quando o desempenho for importante

7. desfoque e filtros (médio)

  • mantenha a animação de desfoque pequena (<=8px)
  • use desfoque apenas para efeitos curtos e únicos
  • nunca anime desfoque continuamente
  • nunca anime desfoque em superfícies grandes
  • prefira opacity e translate antes de desfoque

8. transições de visualização (baixo)

  • use transições de visualização apenas para mudanças no nível de navegação
  • evite transições de visualização para UI com muita interação
  • evite transições de visualização quando interrupção ou cancelamento for necessário
  • trate mudanças de tamanho como potencialmente desencadeadoras de layout

9. limites de ferramenta (crítico)

  • não migre ou reescreva bibliotecas de animação a menos que explicitamente solicitado
  • aplique estas regras dentro do sistema de animação existente
  • nunca migre APIs parcialmente ou misture estilos dentro do mesmo componente

correções comuns

/* thrashing de layout: anime transform em vez de width */
/* antes */ .painel { transition: width 0.3s; }
/* depois */  .painel { transition: transform 0.3s; }

/* vinculado à rolagem: use scroll-timeline em vez de JS */
/* antes */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* depois */  .revelar { animation: fade-in linear; animation-timeline: view(); }
// medição: agrupe leituras antes das escritas (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// depois — meça uma vez, anime via transform
const primeiro = el.getBoundingClientRect();
el.classList.add('movido');
const ultimo = el.getBoundingClientRect();
el.style.transform = `translateX(${primeiro.left - ultimo.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });

orientação de revisão

  • aplique regras críticas primeiro (padrões nunca, limites de ferramenta)
  • escolha o trabalho de renderização menos caro que corresponda à intenção
  • para qualquer escolha não padrão, declare a restrição que a justifica (tamanho da superfície, duração ou requisito de interação)
  • ao revisar, prefira notas acionáveis ​​e alternativas concretas em vez de teoria

Limitações

  • Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como um substituto para validação específica de ambiente, teste ou revisão de especialista.
  • Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.

Individual skills in this repo

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

AlperTuncOrtak/crypto-data-pipeline

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

AlperTuncOrtak/crypto-data-pipeline

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

AlperTuncOrtak/crypto-data-pipeline

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

AlperTuncOrtak/crypto-data-pipeline

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

AlperTuncOrtak/crypto-data-pipeline

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

AlperTuncOrtak/crypto-data-pipeline

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

AlperTuncOrtak/crypto-data-pipeline

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

AlperTuncOrtak/crypto-data-pipeline

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

AlperTuncOrtak/crypto-data-pipeline

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

AlperTuncOrtak/crypto-data-pipeline

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Habilidades Relacionadas