Communitygithub.com

ASoudy/AGS - Auditoría y corrección de rendimiento de animacion…

Audita y soluciona problemas de rendimiento de animaciones como thrashing de layout, propiedades del compositor, movimiento vinculado al scroll y efectos de desenfoque. Úsalo cuando las animaciones titubeen, las transiciones sean bruscas o al revisar el rendimiento de animaciones CSS/JS.

¿Qué es AGS - Auditoría y corrección de rendimiento de animacion…?

Esta habilidad está diseñada para diagnosticar y solucionar problemas de rendimiento en animaciones de UI, abarcando tanto CSS como JavaScript (WAAPI, Motion, rAF, GSAP). Su propósito es identificar violaciones a buenas prácticas críticas, como el intercalado de lecturas y escrituras de layout en un mismo frame, la animación de propiedades costosas (paint, layout) en superficies grandes, o el uso incorrecto de eventos de scroll para animaciones. El skill se activa mediante comandos `/fixing-motion-performance` y puede aplicarse a archivos específicos para obtener un reporte detallado con la línea exacta de la violación, su impacto y una sugerencia de corrección concreta. Está priorizado en nueve categorías (desde patrones nunca permitidos hasta límites de herramientas) y proporciona ejemplos prácticos de corrección, como cambiar de animar `width` a `transform`. Es útil para desarrolladores que trabajan en entornos como Claude Code, Cursor o Codex, y debe usarse 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/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/fixing-motion-performance

Preguntar en tu IA favorita

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

Documentación

corrigiendo-rendimiento-de-movimiento

Arregla problemas de rendimiento en animaciones.

cómo usar

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

  • /corrigiendo-rendimiento-de-movimiento <archivo> Revisa el archivo contra todas las reglas a continuación y reporta:

    • violaciones (cita la línea exacta o 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 del stack existente.

Cuándo Usarlo

Consulta estas pautas cuando:

  • agregues o cambies animaciones UI (CSS, WAAPI, Motion, rAF, GSAP)
  • refactorices interacciones o transiciones bruscas
  • implementes movimiento vinculado al scroll o revelar al hacer scroll
  • animes layout, filtros, máscaras, gradientes o variables CSS
  • revises componentes que usan 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 nunca permitidoscrítico
2elegir el mecanismocrítico
3mediciónalto
4scrollalto
5pinturamedio-alto
6capasmedio
7desenfoque y filtrosmedio
8transiciones de vistabajo
9límites de herramientascrítico

referencia rápida

1. patrones nunca permitidos (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 combines múltiples sistemas de animación que midan o muten layout

2. elegir el mecanismo (crítico)

  • usa por defecto transform y opacity para el movimiento
  • usa animación 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 un solo uso 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 o opacity
  • agrupa todas las lecturas del DOM antes que las escrituras
  • no leas layout repetidamente durante una animación
  • prefiere transiciones estilo FLIP para efectos similares a layout
  • prefiere enfoques que agrupen medición y escrituras

4. scroll (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 pantalla
  • el movimiento vinculado al scroll no debe desencadenar 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 animes propiedades pesadas de pintura en contenedores grandes
  • no animes variables CSS para transform, opacity o posición
  • no animes variables CSS heredadas
  • delimita las variables CSS animadas localmente 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 forma temporal y quirúrgica
  • evita muchas capas promovidas o demasiado grandes
  • valida el comportamiento de las capas con herramientas cuando el rendimiento sea importante

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 muchas interacciones
  • 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 herramientas (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 primero las reglas críticas (patrones nunca permitidos, límites de herramientas)
  • elige el trabajo de renderizado menos costoso que coincida con la intención
  • para cualquier opció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 antes que teoría

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito arriba.
  • No trates el resultado como un sustituto de validación específica del entorno, pruebas o revisión por expertos.
  • Detente y pregunta 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.

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.

Skills relacionados