Communitygithub.com

BEKO2210/Firstbrain

Auditar y corregir problemas de rendimiento en animaciones, incluyendo thrashing de layout, propiedades del compositor, movimiento vinculado al scroll y efectos de desenfoque. Úsalo cuando las animaciones se entrecorten, las transiciones sean bruscas o al revisar el rendimiento de animaciones CSS/JS.

¿Qué es Firstbrain?

Este skill de agente de IA está diseñado para diagnosticar y solucionar problemas de rendimiento en animaciones web. Es útil para desarrolladores que trabajan con animaciones CSS, JavaScript (incluyendo librerías como GSAP, Motion, WAAPI) y necesitan garantizar animaciones fluidas a 60fps. El skill se enfoca en nueve categorías de reglas priorizadas, desde patrones críticos como no mezclar lecturas y escrituras de layout en el mismo frame, hasta pautas para efectos de desenfoque y transiciones de vista. Soporta plataformas como Cursor y Claude Code, y funciona analizando archivos específicos o aplicando restricciones a toda la conversación. El agente revisa el código, señala violaciones exactas, explica por qué importan y sugiere correcciones concretas sin migrar librerías de animación a menos que se solicite explícitamente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/fixing-motion-performance

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

reparación-rendimiento-movimiento

Corregir problemas de rendimiento en animaciones.

cómo usar

  • /reparación-rendimiento-movimiento Aplica estas restricciones a cualquier trabajo de animación de UI en esta conversación.

  • /reparación-rendimiento-movimiento <archivo> Revisa el archivo contra todas las reglas a continuación e informa:

    • violaciones (cita la línea exacta o el fragmento)
    • por qué importa (una oración corta)
    • una corrección concreta (sugerencia a nivel de código)

No migres librerías de animación a menos que se solicite explícitamente. Aplica las reglas dentro del stack existente.

Cuándo Usar

Consulta estas pautas cuando:

  • agregues o cambies animaciones de UI (CSS, WAAPI, Motion, rAF, GSAP)
  • refactorices interacciones o transiciones bruscas
  • implementes movimiento vinculado al scroll o revelación al hacer scroll
  • animes layout, filtros, máscaras, degradados o variables CSS
  • revises componentes que usen will-change, transformaciones o mediciones

glosario de pasos de renderizado

  • composición: transform, opacity
  • pintura: color, bordes, degradados, máscaras, imágenes, filtros
  • layout: tamaño, posición, flujo, grid, flex

categorías de reglas por prioridad

prioridadcategoríaimpacto
1patrones prohibidoscrítico
2elegir el mecanismocrítico
3mediciónalto
4scrollalto
5pinturamedio-alto
6capasmedio
7desenfoque y filtrosmedio
8transiciones de vistabajo
9límites de la herramientacrítico

referencia rápida

1. patrones prohibidos (crítico)

  • no intercalar lecturas y escrituras de layout en el mismo frame
  • no animar layout continuamente en superficies grandes o significativas
  • no impulsar animaciones desde scrollTop, scrollY o eventos de scroll
  • no usar bucles requestAnimationFrame sin una condición de parada
  • no mezclar múltiples sistemas de animación que midan o muten el layout

2. elegir el mecanismo (crítico)

  • usar por defecto transform y opacity para movimiento
  • usar animación impulsada por JS solo cuando la interacción lo requiera
  • la animación de pintura o layout es aceptable solo en superficies pequeñas y aisladas
  • los efectos de una sola vez son aceptables más a menudo que el movimiento continuo
  • preferir degradar la técnica antes que eliminar el movimiento por completo

3. medición (alto)

  • medir una vez, luego animar mediante transform u opacity
  • agrupar todas las lecturas del DOM antes de las escrituras
  • no leer layout repetidamente durante una animación
  • preferir transiciones estilo FLIP para efectos similares a layout
  • preferir enfoques que agrupen medición y escrituras

4. scroll (alto)

  • preferir Scroll o View Timelines para movimiento vinculado al scroll cuando estén disponibles
  • usar IntersectionObserver para visibilidad y pausa
  • no sondear la posición de scroll para animación
  • pausar o detener animaciones cuando estén fuera de pantalla
  • el movimiento vinculado al scroll no debe provocar layout o pintura continua en superficies grandes

5. pintura (medio-alto)

  • la animación que desencadena pintura solo está permitida en elementos pequeños y aislados
  • no animar propiedades pesadas de pintura en contenedores grandes
  • no animar variables CSS para transform, opacity o posición
  • no animar variables CSS heredadas
  • limitar el ámbito de las variables CSS animadas localmente y evitar la herencia

6. capas (medio)

  • el movimiento del compositor requiere promoción de capa, nunca asumirlo
  • usar will-change de forma temporal y quirúrgica
  • evitar muchas o grandes capas promovidas
  • validar el comportamiento de capas con herramientas cuando el rendimiento importe

7. desenfoque y filtros (medio)

  • mantener la animación de desenfoque pequeña (<=8px)
  • usar desenfoque solo para efectos cortos y de una sola vez
  • nunca animar desenfoque continuamente
  • nunca animar desenfoque en superficies grandes
  • preferir opacity y translate antes que desenfoque

8. transiciones de vista (bajo)

  • usar transiciones de vista solo para cambios a nivel de navegación
  • evitar transiciones de vista en UI con mucha interacción
  • evitar transiciones de vista cuando se requiera interrupción o cancelación
  • tratar los cambios de tamaño como potencialmente desencadenantes de layout

9. límites de la herramienta (crítico)

  • no migrar ni reescribir librerías de animación a menos que se solicite explícitamente
  • aplicar estas reglas dentro del sistema de animación existente
  • nunca migrar APIs parcialmente ni mezclar estilos dentro del mismo componente

correcciones comunes

/* thrashing de layout: animar transform en lugar de width */
/* antes */ .panel { transition: width 0.3s; }
/* después */  .panel { transition: transform 0.3s; }

/* vinculado al scroll: usar scroll-timeline en lugar de JS */
/* antes */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* después */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// medición: agrupar lecturas antes de escrituras (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// después — medir una vez, animar mediante transform
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });

guía de revisión

  • aplicar primero las reglas críticas (patrones prohibidos, límites de la herramienta)
  • elegir el trabajo de renderizado menos costoso que coincida con la intención
  • para cualquier elección no predeterminada, indicar la restricción que la justifica (tamaño de superficie, duración o requisito de interacción)
  • al revisar, preferir notas accionables y alternativas concretas sobre teoría

Conexiones

  • Dominio: [[Diseño y Creatividad]]
  • Categoría: [[3D y Animación]]
  • Navegación: [[Resumen de Skills]], [[Inicio]]

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

Skills relacionados