Communitygithub.com

BEKO2210/Firstbrain

Auditer et corriger les problèmes de performance d'animation, y compris les thrashings de layout, les propriétés de composition, les mouvements liés au défilement et les effets de flou. À utiliser lorsque les animations saccadent, les transitions sont saccadées ou lors de la révision des performances des animations CSS/JS.

Qu'est-ce que Firstbrain ?

Cette compétence est conçue pour les développeurs souhaitant auditer et optimiser les performances des animations dans leurs interfaces utilisateur. Elle fournit un ensemble structuré de règles et de bonnes pratiques couvrant les motifs à éviter (comme le thrashing de layout), le choix du mécanisme d'animation, la gestion des mesures, le défilement, la peinture, les calques, le flou et les filtres, ainsi que les limites des outils. La compétence s'applique à tout projet utilisant CSS, WAAPI, Motion, requestAnimationFrame ou GSAP, sans préconiser le changement de bibliothèque d'animation. Son utilité réside dans la réduction des saccades et l'amélioration de la fluidité en orientant les développeurs vers des alternatives performantes (transform/opacity plutôt que layout, scroll-timeline plutôt qu'écouteurs JS, etc.). La compétence s'active via les commandes `/fixing-motion-performance` (application générale) ou `/fixing-motion-performance <fichier>` (audit ciblé avec rapports ligne par ligne). Elle propose également des correctifs concrets en CSS et JavaScript pour les cas courants de thrashing et de mouvements liés au défilement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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

Corriger les problèmes de performance d'animation.

comment utiliser

  • /correction-performance-mouvement Appliquer ces contraintes à tout travail d'animation UI dans cette conversation.

  • /correction-performance-mouvement <fichier> Examiner le fichier selon toutes les règles ci-dessous et signaler :

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

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

Quand l'utiliser

Se référer à ces directives lors :

  • de l'ajout ou de la modification d'animations UI (CSS, WAAPI, Motion, rAF, GSAP)
  • du refactoring d'interactions ou de transitions saccadées
  • de l'implémentation de mouvements liés au défilement ou de dévoilement au défilement
  • de l'animation de layout, filtres, masques, dégradés ou variables CSS
  • de la révision de composants utilisant will-change, transformations ou mesures

glossaire des étapes de rendu

  • composition : transform, opacity
  • peinture : 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 à ne jamais fairecritique
2choisir le mécanismecritique
3mesureélevé
4défilementélevé
5peinturemoyen-élevé
6calquesmoyen
7flou et filtresmoyen
8transitions de vuefaible
9limites des outilscritique

référence rapide

1. motifs à ne jamais faire (critique)

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

2. choisir le mécanisme (critique)

  • par défaut, utiliser transform et opacity pour le mouvement
  • utiliser l'animation pilotée par JS uniquement lorsque l'interaction l'exige
  • l'animation de peinture ou de layout n'est acceptable que sur de petites surfaces isolées
  • les effets uniques sont plus acceptables que les mouvements continus
  • préférer une technique moins coûteuse à la suppression complète du mouvement

3. mesure (élevé)

  • mesurer une fois, puis animer via transform ou opacity
  • regrouper toutes les lectures DOM avant les écritures
  • ne pas lire le layout de manière répétée pendant une animation
  • privilégier les transitions de type FLIP pour les effets de layout
  • privilégier les approches qui regroupent mesures et écritures

4. défilement (élevé)

  • privilégier les Scroll Timelines ou View Timelines pour les mouvements liés au défilement lorsqu'elles sont disponibles
  • utiliser IntersectionObserver pour la visibilité et la mise en pause
  • ne pas interroger la position de défilement pour l'animation
  • mettre en pause ou arrêter les animations lorsqu'elles sont hors écran
  • les mouvements liés au défilement ne doivent pas déclencher de layout ou de peinture continue sur de grandes surfaces

5. peinture (moyen-élevé)

  • l'animation déclenchant de la peinture n'est autorisée que sur de petits éléments isolés
  • ne pas animer des propriétés coûteuses en peinture sur de grands conteneurs
  • ne pas animer des variables CSS pour transform, opacity ou position
  • ne pas animer des variables CSS héritées
  • limiter la portée des variables CSS animées localement et éviter l'héritage

6. calques (moyen)

  • le mouvement par composition nécessite une promotion de calque, ne jamais la supposer
  • utiliser will-change de manière temporaire et chirurgicale
  • éviter un grand nombre de calques promus ou des calques de grande taille
  • valider le comportement des calques avec des outils lorsque la performance est importante

7. flou et filtres (moyen)

  • garder l'animation de flou petite (<=8px)
  • n'utiliser le flou que pour des effets courts et uniques
  • ne jamais animer le flou en continu
  • ne jamais animer le flou sur de grandes surfaces
  • privilégier opacity et translate avant le flou

8. transitions de vue (faible)

  • utiliser les transitions de vue uniquement pour les changements de navigation
  • éviter les transitions de vue pour les UI riches en interactions
  • éviter les transitions de vue lorsque l'interruption ou l'annulation est nécessaire
  • traiter les changements de taille comme potentiellement déclencheurs de layout

9. limites des outils (critique)

  • ne pas migrer ou réécrire les bibliothèques d'animation sauf demande explicite
  • appliquer ces règles dans le système d'animation existant
  • ne jamais migrer partiellement des API ou mélanger les styles dans le même composant

correctifs courants

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

/* lié au défilement : utiliser 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 : regrouper les lectures avant les écritures (FLIP)
// avant — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// après — mesurer une fois, animer 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 = ''; });

conseils de révision

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

Connexions

  • Domaine : [[Design & Kreativitaet]]
  • Catégorie : [[3D & Animation]]
  • Navigation : [[Skills Uebersicht]], [[Home]]

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