Communitygithub.com

MengTo/Skills

Profilage, audit et optimisation des performances des pages frontend, en mettant l'accent sur les animations, les risques de fuite mémoire, les ralentissements sur les sessions longues, les animations CSS, les boucles requestAnimationFrame canvas/WebGL, les marquees, les squelettes, les effets GSAP/Three/Matter, les minuteries, les écouteurs et les observateurs.

Qu'est-ce que Skills ?

Ce skill est conçu pour aider un agent IA à auditer et optimiser les performances des animations sur les pages web frontend, en particulier sur les frameworks modernes comme React, Vite ou Next.js, via le navigateur Codex. Il fournit un workflow structuré en 7 étapes : inspection du contexte du repo, capture d'une baseline dans le navigateur avec profilage précis (top, milieu, footer, mobile), puis patching ciblé pour mettre en pause les animations hors écran, libérer les ressources (RAF, observateurs, timers, WebGL, GSAP) et prévenir les fuites mémoire. Le skill met l'accent sur des bonnes pratiques comme l'utilisation d'IntersectionObserver avec des seuils faibles (0.01), la gestion directe des boucles RAF pour les WebGL/canvas, le nettoyage systématique dans les effets React, et la validation avant/après par des profils comparatifs. Il déconseille les solutions brutales (supprimer toutes les animations) et insiste sur des preuves chiffrées (comptage d'animations offscreen, stabilité du DOM, cycles de navigation). Le rapport final doit inclure les routes échantillonnées, les comptages, la stabilité des comptes DOM/canvas, et les limites de l'instrumentation disponible. Ce skill est idéal pour des tâches comme « rendre les animations performantes », « mettre en pause les animations hors écran », « corriger le défilement saccadé », ou « réduire l'utilisation CPU/GPU ».

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/codex/optimize-web-animations

Demander à votre IA préférée

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

Documentation

Optimiser les Animations Web

Règle Fondamentale

Mesurez la vraie page avant d'éditer. Le but n'est pas de supprimer le mouvement, mais d'arrêter le travail hors écran, de reprendre correctement le mouvement visible, et de libérer les ressources persistantes lors du nettoyage de route/démontage.

Utilisez Codex Browser lorsque disponible, surtout pour les pages localhost. N'utilisez pas Chrome sauf demande explicite de l'utilisateur.

Workflow

  1. Inspecter le contexte du dépôt.

    • Lisez AGENTS.md ou les instructions locales.
    • Exécutez git status --short tôt.
    • Trouvez les composants de page, les hooks d'animation, les keyframes CSS, requestAnimationFrame, setInterval, setTimeout, les composants canvas/WebGL/physique, les éléments média, les timelines/tweens GSAP et les utilitaires de visibilité existants.
    • Recherchez le nettoyage des effets : écouteurs d'événements, observateurs, boucles RAF, intervalles, timers, scripts externes, flux médias, textures/matériaux/géométries/rendus WebGL, et travaux asynchrones pouvant se terminer après le démontage.
    • Si l'arbre de travail est sale, planifiez un staging étroit dès le départ.
  2. Capturer une baseline dans le navigateur.

    • Ouvrez la route exacte nommée par l'utilisateur.
    • Profitez en haut, au milieu, en bas/contenu inférieur, et sur une fenêtre mobile si la disposition peut différer.
    • Comptez les animations CSS via animationName, animationPlayState et la visibilité. Incluez ::before et ::after.
    • Inspectez les éléments canvas/WebGL séparément ; le profilage CSS ne prouve pas que les boucles RAF se sont arrêtées.
    • Enregistrez quels noms d'animations tournent hors écran et les propriétaires DOM responsables.
    • Pour les demandes de mémoire/fuite, enregistrez également les comptages d'éléments/canvas/images/iframes, les métriques heap JS exposées si disponibles, un échantillon au repos après 10-30 secondes, et un court échantillon de cycle de route. Si les API heap retournent null ou que le sandbox du navigateur bloque le monkey-patching, dites-le et basez-vous sur des comptages stables observables plus l'audit du code source.
    • Limitez les tests de stress. Un crash d'onglet pendant le profilage est une preuve de surcharge, mais ne sur-attribuez pas la cause sauf si elle est reproduite par un test minimal.
    • Voir references/browser-profiling.md pour un évaluateur Codex Browser réutilisable.
  3. Patcher le plus petit propriétaire qui contrôle le mouvement.

    • Privilégiez un hook de révélation/visibilité de page existant si l'application en a un.
    • Sinon, ajoutez un IntersectionObserver qui bascule une classe stable telle que is-offscreen sur les sections et les éléments enfants animés.
    • Mettez en pause les animations CSS avec des règles ciblées :
main > section.is-offscreen .expensive-animation,
.expensive-animation.is-offscreen {
  animation-play-state: paused !important;
}
  • Pour les cartes répétées ou les placeholders, observez la coque de la carte et les descendants animés, pas tout le document.
  • Pour les pistes de marquee/ticker, mettez la piste en pause lorsque sa section est hors écran.
  • Pour les squelettes et les lueurs de pseudo-éléments, incluez les sélecteurs de pause ::before et ::after si nécessaire.
  • Pour les boucles canvas/WebGL/physique, contrôlez la boucle RAF directement :
    • Démarrez lorsque le canvas/conteneur intersecte.
    • Annulez requestAnimationFrame quand il est hors écran.
    • Reprenez lors de la ré-entrée.
    • Déconnectez les observateurs et annulez les frames lors du nettoyage.
    • Ajoutez un marqueur de débogage non visuel comme data-animation-active lorsque cela aide la vérification dans le navigateur.
  • Respectez prefers-reduced-motion si le composant le fait déjà, et évitez d'introduire des boucles de rendu React pour l'état de défilement/d'animation.
  • Pour le renforcement contre les fuites :
    • Effacez chaque timeout/interval créé par l'effet.
    • Annulez RAF avant le démontage et avant de redémarrer une boucle.
    • Déconnectez IntersectionObserver, ResizeObserver, MutationObserver et les abonnements personnalisés.
    • Supprimez les écouteurs globaux/window/document avec la même référence de handler.
    • Disposez les textures/matériaux/géométries/rendus Three/WebGL et supprimez les nœuds DOM du rendu.
    • Tuez les tweens/timelines GSAP pour les nœuds DOM et les objets mutables comme les uniforms de shader.
    • Arrêtez les flux médias et mettez en pause les sources vidéo/audio détachées.
    • Protégez les chargeurs asynchrones avec un drapeau isDisposed et disposez les ressources chargées si elles se résolvent après le démontage.
    • Dans le nettoyage React, capturez les valeurs ref.current dans l'effet avant de retourner le nettoyage si le lint avertit que la ref peut changer.
    • Limitez les deltas de trame de physique ou simulation après les pauses de visibilité pour que les trames retardées n'exécutent pas de mises à jour surdimensionnées.
  1. Vérifier le comportement, pas seulement les builds.

    • Rechargez la route et réexécutez les mêmes profils haut/milieu/bas/mobile.
    • Résultat cible : offscreenRunningCount: 0 pour les sections de page testées.
    • Confirmez que les animations visibles tournent encore ou reprennent lorsqu'on fait défiler pour les voir.
    • Confirmez que les boucles RAF/canvas signalent inactives hors écran et actives dans la vue, ou prouvez autrement la cancellation depuis l'état source/runtime.
    • Pour les audits de fuite, comparez les cycles de route avant/après et les échantillons au repos. Les comptages DOM/canvas/images doivent revenir à la même baseline après une navigation répétée, en tenant compte de petits changements asynchrones attendus.
    • Exercez une interaction de page normale comme la recherche/le filtrage/la navigation pour que l'observateur ne casse pas le contenu dynamique.
    • Vérifiez les avertissements/erreurs de la console dans un nouvel onglet.
  2. Effectuer des vérifications locales.

    • Utilisez les portes normales du dépôt. Pour les applications React/Vite, c'est souvent :
git diff --check
npm run lint
npm run build
  • Mentionnez séparément les avertissements non fatals connus des échecs.
  1. Commiter étroitement lorsque demandé par le dépôt ou les instructions de l'utilisateur.
    • Si des modifications sales non liées existent, utilisez un index isolé :
rm -f /tmp/<task>-index
GIT_INDEX_FILE=/tmp/<task>-index git read-tree HEAD
# Appliquez uniquement les morceaux souhaités à l'index temporaire.
GIT_INDEX_FILE=/tmp/<task>-index git diff --cached --check
GIT_INDEX_FILE=/tmp/<task>-index git commit -m "Pause offscreen <page> animations"
git restore --staged <files> 2>/dev/null || true
  • Ne staguez jamais des fichiers larges depuis un arbre de travail sale sauf si chaque morceau appartient à la tâche.
  1. Rapporter avec des preuves.
    • Commencez par les conclusions : ce qui tournait encore, ce qui semblait sujet aux fuites, et ce qui n'a pas pu être mesuré.
    • Séparez les risques d'audit du code source des mesures en direct dans le navigateur.
    • Incluez la route exacte échantillonnée, le nombre d'animations hors écran, la stabilité des comptages DOM/canvas, le résultat du cycle de route, et les vérifications locales.
    • Énoncez clairement les limites, en particulier les compteurs heap indisponibles ou l'instrumentation bloquée par le navigateur.

Bons Patrons de Correction

  • is-offscreen au niveau section ET is-offscreen au niveau élément pour les longues sections où les animations enfants en dessous du pli peuvent encore tourner.
  • Constantes de sélecteur de visibilité partagées par route, comme COURSES_PAGE_ANIMATION_VISIBILITY_SELECTOR.
  • Seuils IntersectionObserver autour de 0.01 pour le contrôle d'animation.
  • Contrôle direct de la boucle RAF pour les effets WebGL/canvas ; animation-play-state CSS ne peut pas mettre en pause les boucles de rendu JavaScript.
  • Limites de delta de trame pour les boucles de physique qui reprennent après une trame en pause ou retardée.
  • Nœuds de nettoyage capturés pour les refs React utilisées par les effets GSAP/WebGL.
  • Garde isDisposed pour les chargeurs d'image/vidéo/texture/données qui peuvent se résoudre après le démontage.
  • Sondes courtes au repos et de cycle de route pour attraper l'accumulation de nœuds DOM, canvases, iframes ou médias non libérés.

À Éviter

  • Supprimer toutes les animations pour faire passer le profil.
  • Mettre en pause le mouvement héroïque visible parce qu'un sélecteur ancêtre est trop large.
  • Supposer que animation-play-state couvre les pseudo-éléments ou les boucles RAF JavaScript.
  • Se fier à une unique mesure en haut de page sur les longues pages.
  • Considérer les compteurs heap indisponibles comme une preuve qu'il n'y a pas de fuite mémoire.
  • Exécuter des boucles de stress illimitées dans le navigateur ; utilisez des cycles limités et enregistrez les crashes sans sur-affirmer la causalité.
  • Utiliser des captures d'écran seules comme preuve de performance.
  • Laisser traîner des morceaux locaux non liés dans le commit.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

MengTo/Skills

Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography, zoom-follow framing, ffprobe/thumbnail verification, and optional native recording compatibility checks. Use when the user asks to record or re-record browser actions, show cursor clicks and zooms, make Dribbble/UI inspiration or product demo recordings, or asks whether Codex, Playwright, or an MCP can produce a natural browser demo video.

MengTo/Skills

Generate ElevenLabs text-to-speech audio from scripts or inline text using local voice profiles. Use when the user asks for ElevenLabs, text-to-speech, TTS, narration, voiceover, speech audio, or voice generation; load voice names, voice ids, emails, owners, and account-specific defaults only from local config outside the skill.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Create cinematic scroll-driven landing pages with Lenis smooth scrolling, GSAP ScrollTrigger, scroll-linked progression, staggered text reveals, sticky card stacks, parallax backgrounds, scroll-scrubbed transitions, footer reveals, and immersive preloaders. Use when analyzing or building premium editorial scroll experiences, sticky project stacks, kinetic typography, or section-by-section storytelling.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

Skills associés