Communitygithub.com

AbobakrDiara61/railway-system

Auditar y corregir problemas de rendimiento en animaciones, incluyendo thrashing de layout, propiedades del compositor, animaciones vinculadas al desplazamiento y efectos de desenfoque. Úsalo cuando las animaciones tartamudeen, las transiciones sean entrecortadas o al revisar el rendimiento de animaciones CSS/JS.

¿Qué es railway-system?

Esta skill está diseñada para desarrolladores que trabajan con animaciones en la web y necesitan diagnosticar y corregir problemas de rendimiento. Proporciona un conjunto exhaustivo de reglas organizadas por prioridad para evitar patrones críticos como el thrashing de layout (lectura y escritura entremezcladas en el mismo frame), el abuso de animaciones JS basadas en scroll, y el uso excesivo de propiedades costosas de pintura y filtros. La skill es compatible con cualquier pila tecnológica existente y no impone migraciones de librerías de animación a menos que se solicite explícitamente. Funciona analizando código CSS, JavaScript o configuraciones de animación, y ofrece sugerencias concretas de corrección. Está pensada para ser invocada en conversaciones donde se estén creando o modificando animaciones, refactorizando interacciones con tirones, o revisando componentes que usen transformaciones, mediciones de layout o propiedades de composición. La habilidad prioriza el uso de transform y opacity para movimiento continuo, fomenta la medición por lotes (batch) antes de escribir en el DOM, y recomienda herramientas como Scroll Timelines e IntersectionObserver para animaciones vinculadas al desplazamiento. Su utilidad principal es ayudar a los desarrolladores a identificar rápidamente violaciones de buenas prácticas de rendimiento y ofrecer correcciones accionables sin abstraerse demasiado en teoría.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/skills/fixing-motion-performance

Preguntar en tu IA favorita

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

Documentación

arreglando-rendimiento-de-movimiento

Corrige problemas de rendimiento en animaciones.

cómo usar

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

  • /arreglando-rendimiento-de-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é es importante (una frase 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 de la pila existente.

Cuándo Usar

Consulta estas pautas cuando:

  • agregues o cambies animaciones UI (CSS, WAAPI, Motion, rAF, GSAP)
  • refactorices interacciones o transiciones entrecortadas
  • implementes movimiento vinculado al scroll o revelar al hacer scroll
  • anime 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 a evitarcrítico
2elegir el mecanismocrítico
3mediciónalto
4desplazamientoalto
5pinturamedio-alto
6capasmedio
7desenfoque y filtrosmedio
8transiciones de vistabajo
9límites de la herramientacrítico

referencia rápida

1. patrones a evitar (crítico)

  • no intercales lecturas y escrituras de layout en el mismo frame
  • no animes layout continuamente en superficies grandes o significativas
  • no impulses animaciones desde scrollTop, scrollY o eventos de scroll
  • no uses bucles requestAnimationFrame sin una condición de parada
  • no mezcles múltiples sistemas de animación que midan o muten el layout

2. elegir el mecanismo (crítico)

  • predetermina usar transform y opacity para el movimiento
  • usa 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 más aceptables que el movimiento continuo
  • prefiere degradar la técnica antes que eliminar el movimiento por completo

3. medición (alto)

  • mide una vez, luego anima mediante transform u opacity
  • agrupa todas las lecturas del DOM antes de las escrituras
  • no leas layout repetidamente durante una animación
  • prefiere transiciones tipo FLIP para efectos similares a layout
  • prefiere enfoques que agrupen medición y escrituras

4. desplazamiento (alto)

  • prefiere Scroll o View Timelines para movimiento vinculado al scroll cuando estén disponibles
  • usa IntersectionObserver para visibilidad y pausa
  • no consultes la posición de scroll para animación
  • pausa o detén las animaciones cuando estén fuera de la pantalla
  • el movimiento vinculado al scroll no debe desencadenar layout o pintura continuos en superficies grandes

5. pintura (medio-alto)

  • la animación que desencadena pintura solo está permitida en elementos pequeños y aislados
  • no animes propiedades pesadas de pintura en contenedores grandes
  • no animes variables CSS para transform, opacity o posición
  • no animes variables CSS heredadas
  • limita las variables CSS animadas al ámbito local y evita la herencia

6. capas (medio)

  • el movimiento del compositor requiere promoción de capa, nunca lo des por sentado
  • usa will-change de manera temporal y quirúrgica
  • evita muchas capas o capas grandes promovidas
  • valida el comportamiento de las capas con herramientas cuando el rendimiento importe

7. desenfoque y filtros (medio)

  • mantén la animación de desenfoque pequeña (<=8px)
  • usa desenfoque solo para efectos cortos y de una sola vez
  • nunca animes desenfoque continuamente
  • nunca animes desenfoque en superficies grandes
  • prefiere opacity y translate antes que desenfoque

8. transiciones de vista (bajo)

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

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

  • no migres ni reescribas librerías de animación a menos que se solicite explícitamente
  • aplica estas reglas dentro del sistema de animación existente
  • nunca migres APIs parcialmente ni mezcles estilos dentro del mismo componente

correcciones comunes

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

/* vinculado a scroll: usa 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: agrupa lecturas antes de escrituras (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// después — mide una vez, anima 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

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

Limitaciones

  • Usa esta skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación específica del entorno, las pruebas o la revisión de expertos.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

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

Skills relacionados