Communitygithub.com

AbobakrDiara61/railway-system

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

O que é railway-system?

Esta skill (ferramenta) é projetada para diagnosticar e corrigir problemas de desempenho de animação em interfaces web. Ela é útil para desenvolvedores que trabalham com animações CSS, JavaScript (incluindo requestAnimationFrame, GSAP, WAAPI) e Motion, especialmente quando enfrentam engasgos (jank), travamentos (stuttering) ou consumo excessivo de recursos. A skill oferece um conjunto de regras priorizadas, desde padrões críticos a evitar (como intercalar leituras e escritas de layout no mesmo frame) até práticas recomendadas (como animar apenas transform e opacity para efeitos contínuos). O fluxo de uso é simples: o usuário pode invocar a skill diretamente (`/fixing-motion-performance`) para aplicar as restrições a todo o trabalho de animação, ou passar um arquivo específico (`/fixing-motion-performance <arquivo>`) para obter uma revisão detalhada com violações, impacto e sugestões de correção. A skill respeita limites de ferramentas (não migra bibliotecas de animação não solicitadas) e fornece exemplos concretos de código (CSS e JS) para os problemas mais comuns.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/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 UI nesta conversa.

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

    • violações (cite a linha ou trecho exato)
    • 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 tecnológica existente.

Quando Usar

Consulte estas diretrizes quando:

  • adicionando ou alterando animações de UI (CSS, WAAPI, Motion, rAF, GSAP)
  • refatorando interações ou transições com travamentos
  • implementando movimento vinculado a rolagem ou revelar ao rolar
  • animando layout, filtros, máscaras, gradientes ou variáveis CSS
  • revisando componentes que usam will-change, transformações ou medições

glossário de etapas de renderização

  • composição: transform, opacity
  • pintura: color, borders, gradients, masks, images, filters
  • layout: tamanho, posição, fluxo, grid, flex

categorias de regras por prioridade

prioridadecategoriaimpacto
1padrões nuncacrítico
2escolha o mecanismocrítico
3mediçãoalto
4rolagemalto
5pinturamédio-alto
6camadasmédio
7desfoque e filtrosmédio
8transições de vistabaixo
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 rolagem
  • sem loops requestAnimationFrame sem uma condição de parada
  • não misture múltiplos sistemas de animação que cada um meça ou modifique layout

2. escolha o mecanismo (crítico)

  • use transform e opacity como padrão para movimento
  • use animação 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 aceitáveis mais frequentemente 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 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. rolagem (alto)

  • prefira Scroll ou View Timelines para movimento vinculado a 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 a rolagem não deve acionar layout ou pintura contínuos 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
  • limite variáveis CSS animadas localmente e evite herança

6. camadas (médio)

  • movimento do compositor requer promoção de camada, nunca assuma que já existe
  • 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ções de desfoque pequenas (<=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 vista (baixo)

  • use transições de vista apenas para mudanças no nível de navegação
  • evite transições de vista para UI com muita interação
  • evite transições de vista 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

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

/* vinculado a 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: agrupar 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 primeiro as regras críticas (padrões nunca, 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 habilidade apenas quando a tarefa claramente corresponder ao escopo descrito acima.
  • Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
  • 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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

Habilidades Relacionadas