Communitygithub.com

ASoudy/AGS

Audita e corrige problemas de desempenho de animações, como layout thrashing, propriedades do compositor, animações vinculadas à rolagem e efeitos de desfoque. Use quando animações travarem, transições engasgarem ou ao revisar o desempenho de animações CSS/JS.

O que é AGS?

Este é um agente especializado em auditoria e correção de desempenho de animações na web, focado em identificar e resolver problemas como layout thrashing, animações acionadas por pintura, movimentos vinculados à rolagem e uso excessivo de desfoque. Ele suporta qualquer stack de animação (CSS, WAAPI, Motion, rAF, GSAP) e prioriza regras críticas, como nunca intercalar leituras e escritas de layout no mesmo frame, evitar animações contínuas de layout em superfícies grandes e preferir transformações e opacidade para movimento. O agente utiliza uma hierarquia de prioridades, desde padrões nunca permitidos (críticos) até limites de ferramentas, e fornece correções concretas em código, como substituir animações de largura por transformações ou usar Scroll Timelines em vez de eventos de rolagem no JavaScript. É ideal para desenvolvedores que precisam depurar jank em interfaces de usuário, revisar componentes animados ou otimizar o desempenho de transições e efeitos visuais sem migrar bibliotecas de animação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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

Corrige problemas de desempenho de animações.

como usar

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

  • /corrigindo-desempenho-de-movimento <arquivo> Revisa o arquivo contra todas as regras abaixo e relata:

    • 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 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 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 das 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 nunca permitidoscrítico
2escolha 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 permitidos (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 acione animação a partir de scrollTop, scrollY ou eventos de rolagem
  • sem loops requestAnimationFrame sem condição de parada
  • não misture múltiplos sistemas de animação que cada um meça ou mude o layout

2. escolha o mecanismo (crítico)

  • prefira transform e opacity para movimento
  • use animação orientada por 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 o movimento completamente

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 do tipo FLIP para efeitos semelhantes a layout
  • prefira abordagens que agrupem medição e escritas

4. rolagem (alto)

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

5. pintura (médio-alto)

  • animação que aciona 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 posição
  • não anime variáveis CSS herdadas
  • escopo de variáveis CSS animadas localmente e evite herança

6. camadas (médio)

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

7. desfoque e filtros (médio)

  • mantenha 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 acionadoras 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

/* layout thrashing: 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 — layout thrash
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 permitidos, limites de ferramenta)
  • escolha o trabalho de renderização menos custoso que corresponda à intenção
  • para qualquer escolha não padrão, indique 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 substituta para validação específica do ambiente, testes ou revisão de especialistas.
  • Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.

Individual skills in this repo

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

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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

Habilidades Relacionadas