Communitygithub.com

BEKO2210/Firstbrain

Audite e corrija problemas de desempenho de animação, incluindo thrashing de layout, propriedades do compositor, animações vinculadas a scroll e efeitos de desfoque. Use quando animações travarem, transições engasgarem ou ao revisar desempenho de animações CSS/JS.

O que é Firstbrain?

Este skill, Firstbrain, é uma ferramenta especializada para auditar e corrigir problemas de desempenho em animações web. Ele fornece um conjunto abrangente de regras e diretrizes para desenvolvedores que trabalham com animações CSS, JavaScript, WAAPI, GSAP ou qualquer outra técnica de animação. O objetivo principal é identificar e solucionar gargalos de renderização, como thrashing de layout (intercalação de leitura e escrita no DOM), animações de propriedades de pintura pesadas e loops de animação sem controle, garantindo animações suaves e com 60fps. O skill é compatível com qualquer plataforma de desenvolvimento web (editores de código, agentes de IA como Claude Code ou Cursor) e organiza as regras por prioridade, desde padrões críticos a serem evitados até otimizações de camadas e filtros. Ele também oferece exemplos concretos de correção de código (como substituir animações de `width` por `transform`) e uma metodologia de revisão baseada em ações e sugestões práticas, em vez de teoria abstrata.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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

  • /fixing-motion-performance Aplique estas restrições a qualquer trabalho de animação de interface nesta conversa.

  • /fixing-motion-performance <arquivo> Revise o arquivo comparando com todas as regras abaixo e relate:

    • violações (cite a linha ou trecho exato)
    • por que é importante (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 stack 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 engasgos
  • implementar animação vinculada a scroll ou revelar ao scroll
  • animar layout, filtros, máscaras, gradientes ou variáveis CSS
  • revisar componentes que usam will-change, transforms ou medição

glossário de etapas de renderização

  • composite: transform, opacity
  • paint: color, borders, gradients, masks, images, filters
  • layout: size, position, flow, grid, flex

categorias de regras por prioridade

prioridadecategoriaimpacto
1padrões a evitarcrítico
2escolha do mecanismocrítico
3mediçãoalto
4scrollalto
5paintmédio-alto
6camadasmédio
7desfoque e filtrosmédio
8transições de visualizaçãobaixo
9limites da ferramentacrítico

referência rápida

1. padrões a evitar (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. escolha do mecanismo (crítico)

  • prefira transform e opacity para movimento
  • use animação via JavaScript apenas quando a interação exigir
  • animação de paint ou layout é aceitável apenas em superfícies pequenas e isoladas
  • efeitos únicos são aceitáveis com mais frequência 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 do DOM antes das escritas
  • não leia layout repetidamente durante uma animação
  • prefira transições estilo FLIP para efeitos semelhantes a layout
  • prefira abordagens que agrupam medição e escritas

4. scroll (alto)

  • prefira Scroll ou View Timelines para movimento vinculado a scroll quando disponíveis
  • use IntersectionObserver para visibilidade e pausa
  • não consulte a posição de scroll para animação
  • pause ou pare animações quando estiverem fora da tela
  • movimento vinculado a scroll não deve acionar layout contínuo ou paint em superfícies grandes

5. paint (médio-alto)

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

6. camadas (médio)

  • movimento no compositor requer promoção de camada, nunca assuma que acontece automaticamente
  • use will-change de forma temporária e cirúrgica
  • evite muitas camadas promovidas ou muito grandes
  • valide o comportamento de 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 for necessária interrupção ou cancelamento
  • trate mudanças de tamanho como potencialmente acionadoras de layout

9. limites da 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 a scroll: 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 as regras críticas primeiro (padrões a evitar, limites da ferramenta)
  • escolha o trabalho de renderização menos custoso 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

Conexões

  • Domínio: [[Design & Kreativitaet]]
  • Categoria: [[3D & Animation]]
  • Navegação: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

Habilidades Relacionadas