Communitygithub.com

ASoudy/AGS

Auditez et corrigez les problèmes de performance d'animation, y compris les trashing de layout, les propriétés du compositeur, les animations liées au défilement et les effets de flou. À utiliser lorsque les animations saccadent, les transitions hoquettent ou lors de la révision des performances des animations CSS/JS.

Qu'est-ce que AGS ?

Ce skill est conçu pour les développeurs et les agents IA comme Claude Code, Cursor ou Codex afin d'auditer et de corriger les problèmes de performance d'animation dans les applications web. Il fournit des règles strictes pour éviter le « layout thrashing », les animations coûteuses en peinture, et les animations basées sur le défilement. Le skill catégorise les problèmes par priorité (critique, élevée, moyenne, faible) et propose des correctifs concrets, comme l'utilisation de `transform` et `opacity` au lieu de `width` ou `scrollTop`. Il supporte les technologies CSS, WAAPI, Motion, rAF, GSAP et View Transitions, et insiste sur le fait de ne pas migrer les bibliothèques d'animation sans demande explicite. Il est particulièrement utile pour revoir des fichiers, identifier les violations exactes et suggérer des correctifs de code. Ses limites incluent le fait de ne pas remplacer une validation environnementale spécifique et de demander des clarifications si les entrées ou les permissions nécessaires sont manquantes.

Compatible avec~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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

correction-performance-mouvement

Corrigez les problèmes de performance d'animation.

comment utiliser

  • /fixing-motion-performance Appliquez ces contraintes à tout travail d'animation UI dans cette conversation.

  • /fixing-motion-performance <fichier> Examinez le fichier par rapport à toutes les règles ci-dessous et signalez :

    • les violations (citez la ligne ou l'extrait exact)
    • pourquoi c'est important (une phrase courte)
    • un correctif concret (suggestion au niveau du code)

Ne migrez pas les bibliothèques d'animation sauf demande explicite. Appliquez les règles dans la pile existante.

Quand l'utiliser

Référez-vous à ces directives lorsque :

  • vous ajoutez ou modifiez des animations UI (CSS, WAAPI, Motion, rAF, GSAP)
  • vous refactorisez des interactions ou des transitions saccadées
  • vous implémentez des animations liées au défilement ou un dévoilement au défilement
  • vous animez le layout, les filtres, les masques, les dégradés ou les variables CSS
  • vous examinez des composants qui utilisent will-change, les transformations ou les mesures

glossaire des étapes de rendu

  • composite : transform, opacity
  • paint : couleur, bordures, dégradés, masques, images, filtres
  • layout : taille, position, flux, grille, flex

catégories de règles par priorité

prioritécatégorieimpact
1motifs interditscritique
2choisir le mécanismecritique
3mesureélevé
4défilementélevé
5paintmoyen-élevé
6couchesmoyen
7flou et filtresmoyen
8transitions de vuefaible
9limites des outilscritique

référence rapide

1. motifs interdits (critique)

  • n'entrelacez pas les lectures et écritures de layout dans la même trame
  • n'animez pas le layout en continu sur des surfaces grandes ou significatives
  • ne pilotez pas l'animation depuis scrollTop, scrollY ou les événements scroll
  • pas de boucles requestAnimationFrame sans condition d'arrêt
  • ne mélangez pas plusieurs systèmes d'animation qui mesurent ou mutent chacun le layout

2. choisir le mécanisme (critique)

  • privilégiez transform et opacity pour les mouvements
  • utilisez l'animation JavaScript uniquement lorsque l'interaction l'exige
  • l'animation paint ou layout est acceptable uniquement sur des surfaces petites et isolées
  • les effets ponctuels sont plus souvent acceptables que le mouvement continu
  • préférez dégrader la technique plutôt que de supprimer complètement le mouvement

3. mesure (élevé)

  • mesurez une fois, puis animez via transform ou opacity
  • regroupez toutes les lectures DOM avant les écritures
  • ne lisez pas le layout de manière répétée pendant une animation
  • préférez les transitions de type FLIP pour les effets de type layout
  • préférez les approches qui regroupent la mesure et les écritures

4. défilement (élevé)

  • préférez les Scroll Timelines ou View Timelines pour les animations liées au défilement lorsqu'elles sont disponibles
  • utilisez IntersectionObserver pour la visibilité et la pause
  • n'interrogez pas la position de défilement pour l'animation
  • mettez en pause ou arrêtez les animations lorsqu'elles sont hors écran
  • les animations liées au défilement ne doivent pas déclencher de layout ou paint continu sur de grandes surfaces

5. paint (moyen-élevé)

  • l'animation qui déclenche du paint est autorisée uniquement sur des éléments petits et isolés
  • n'animez pas les propriétés lourdes en paint sur de grands conteneurs
  • n'animez pas les variables CSS pour transform, opacity ou position
  • n'animez pas les variables CSS héritées
  • limitez les variables CSS animées localement et évitez l'héritage

6. couches (moyen)

  • l'animation du compositeur nécessite la promotion de couche, ne la supposez jamais
  • utilisez will-change de manière temporaire et chirurgicale
  • évitez les couches promues nombreuses ou grandes
  • validez le comportement des couches avec les outils lorsque la performance est importante

7. flou et filtres (moyen)

  • gardez l'animation de flou petite (<=8px)
  • utilisez le flou uniquement pour des effets courts et ponctuels
  • n'animez jamais le flou en continu
  • n'animez jamais le flou sur de grandes surfaces
  • préférez opacity et translate avant le flou

8. transitions de vue (faible)

  • utilisez les transitions de vue uniquement pour les changements au niveau de la navigation
  • évitez les transitions de vue pour les UI riches en interactions
  • évitez les transitions de vue lorsque l'interruption ou l'annulation est nécessaire
  • traitez les changements de taille comme potentiellement déclencheurs de layout

9. limites des outils (critique)

  • ne migrez ni ne réécrivez les bibliothèques d'animation sauf demande explicite
  • appliquez ces règles dans le système d'animation existant
  • ne migrez jamais partiellement les API ni ne mélangez les styles dans le même composant

correctifs courants

/* layout thrashing : animez transform au lieu de width */
/* avant */ .panel { transition: width 0.3s; }
/* après */  .panel { transition: transform 0.3s; }

/* lié au défilement : utilisez scroll-timeline au lieu de JS */
/* avant */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* après */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// mesure : regroupez les lectures avant les écritures (FLIP)
// avant — layout thrash
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// après — mesurez une fois, animez via 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 = ''; });

directives de révision

  • appliquez d'abord les règles critiques (motifs interdits, limites des outils)
  • choisissez le travail de rendu le moins coûteux qui correspond à l'intention
  • pour tout choix non par défaut, énoncez la contrainte qui le justifie (taille de surface, durée ou besoin d'interaction)
  • lors de la révision, privilégiez des notes exploitables et des alternatives concrètes plutôt que de la théorie

Limitations

  • Utilisez ce skill uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
  • Ne considérez pas la sortie comme un substitut à une validation environnementale spécifique, à des tests ou à une revue experte.
  • Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.

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 associés