Communitygithub.com

AbobakrDiara61/railway-system

Auditer et corriger les problèmes de performance d'animation, y compris les secousses de mise en page, 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 sont saccadées ou lors de la révision des performances des animations CSS/JS.

Qu'est-ce que railway-system ?

Cette compétence, 'fixing-motion-performance', permet d'auditer et de corriger les problèmes de performance d'animation dans les interfaces utilisateur. Elle est particulièrement utile lorsque les animations saccadent, que les transitions sont saccadées ou lors de la révision des performances des animations CSS et JavaScript. La compétence couvre différents aspects de la performance, notamment le choix des mécanismes d'animation, les mesures, les animations liées au défilement, la peinture, les couches, les effets de flou et les transitions de vue. Elle s'applique à toute modification d'animation UI, qu'il s'agisse de CSS, WAAPI, Motion, requestAnimationFrame ou GSAP. Le fonctionnement se base sur un ensemble de règles catégorisées par priorité, allant des 'patterns jamais à utiliser' (critique) aux 'limitations des outils' (critique). L'utilisateur peut invoquer la compétence pour qu'elle analyse un fichier spécifique et signale les violations, en proposant des correctifs concrets au niveau du code. Les plateformes supportées incluent les environnements de développement web où les animations CSS et JavaScript sont utilisées, comme les frameworks front-end modernes (React, Vue, etc.), bien que la compétence elle-même soit indépendante du framework. En résumé, elle offre un guide structuré pour optimiser les performances des animations, en privilégiant les transformations et l'opacité, et en évitant les patterns coûteux qui dégradent l'expérience utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/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

fixing-motion-performance

Corriger les problèmes de performance d'animation.

Comment utiliser

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

  • /fixing-motion-performance <fichier> Révise le fichier par rapport à toutes les règles ci-dessous et signale :

    • 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 utiliser

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

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

Glossaire des étapes de rendu

  • composite : transform, opacity
  • peinture : color, borders, gradients, masks, images, filters
  • mise en page : size, position, flow, grid, flex

Catégories de règles par priorité

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

Référence rapide

1. Patterns jamais utilisés (critique)

  • n'intercalez pas les lectures et écritures de mise en page dans la même trame
  • n'animez pas la mise en page en continu sur de grandes surfaces ou surfaces significatives
  • ne pilotez pas d'animation à partir de scrollTop, scrollY ou d'événements scroll
  • pas de boucle requestAnimationFrame sans condition d'arrêt
  • ne mélangez pas plusieurs systèmes d'animation qui mesurent ou modifient la mise en page

2. Choisir le mécanisme (critique)

  • privilégiez transform et opacity pour le mouvement
  • utilisez l'animation JavaScript uniquement lorsque l'interaction le nécessite
  • l'animation de peinture ou de mise en page n'est acceptable que sur des surfaces petites et isolées
  • les effets uniques sont plus acceptables que le mouvement continu
  • préférez une technique moins gourmande plutôt que de supprimer complètement l'animation

3. Mesure (élevé)

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

4. Défilement (élevé)

  • privilégiez les Scroll ou View Timelines pour les animations liées au défilement lorsqu'elles sont disponibles
  • utilisez IntersectionObserver pour la visibilité et la mise en pause
  • ne sondez 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 mise en page 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 des éléments petits et isolés
  • n'animez pas de propriétés lourdes en peinture sur de grands conteneurs
  • n'animez pas de variables CSS pour transform, opacity ou position
  • n'animez pas de variables CSS héritées
  • limitez les variables CSS animées localement et évitez l'héritage

6. Couches (moyen)

  • le mouvement du compositeur nécessite une promotion de couche, ne la supposez jamais
  • utilisez will-change de manière temporaire et chirurgicale
  • évitez un grand nombre ou de grandes couches promues
  • validez le comportement des couches avec des 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 uniques
  • 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
  • considérez les changements de taille comme potentiellement déclencheurs de mise en page

9. Limites des outils (critique)

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

Corrections courantes

/* secousses de mise en page : animer transform au lieu de width */
/* avant */ .panel { transition: width 0.3s; }
/* après */  .panel { 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 — secousses de mise en page
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 = ''; });

Guide de révision

  • appliquez d'abord les règles critiques (patterns jamais utilisés, 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 cette compétence uniquement lorsque la tâche correspond clairement au champ d'application décrit ci-dessus.
  • Ne considérez pas le résultat comme un substitut à une validation, un test ou une révision experte spécifiques à l'environnement.
  • 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.

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