Communitygithub.com

MengTo/Skills

Profil, auditiere und optimiere die Performance von Frontend-Seiten mit Schwerpunkt auf Animationen, Memory-Leak-Risiken, Langzeitverlangsamungen, CSS-Animationen, Canvas/WebGL-requestAnimationFrame-Schleifen, Marquee-Effekten, Skeletons, GSAP/Three/Matter-Effekten, Timern, Listenern und Observern.

Was ist Skills?

Diese Skill-Anleitung bietet einen strukturierten Workflow zur Optimierung von Web-Animationen im Frontend. Sie zielt darauf ab, die Performance zu verbessern, indem sie sicherstellt, dass Animationen außerhalb des Bildschirms gestoppt werden, sichtbare Animationen korrekt abgespielt werden und nach dem Verlassen einer Route alle Ressourcen freigegeben werden, um Memory-Leaks zu vermeiden. Der Prozess beginnt mit einer gründlichen Inspektion des Repository-Kontexts und einer Browser-basierten Basismessung. Dabei werden CSS-Animationen, Canvas/WebGL-Schleifen, Timer, Listener und andere ressourcenintensive Vorgänge erfasst. Anschließend wird ein minimaler Eingriff vorgenommen – in der Regel durch einen IntersectionObserver –, der eine visibilitätsgesteuerte Pausierung von Animationen ermöglicht. Die Skill unterstützt Plattformen wie Codex Browser (bevorzugt), React, Vite und Next.js. Sie behandelt sowohl CSS-Animationen als auch JavaScript-basierte Render-Schleifen (RAF, Canvas, WebGL) und stellt sicher, dass auch Pseudo-Elemente (::before, ::after) und komplexe Bibliotheken wie GSAP, Three.js oder Matter.js korrekt pausiert und bereinigt werden. Besonderes Augenmerk liegt auf der Vermeidung von Memory-Leaks durch gründliche Bereinigung von Timern, Observern, Listenern und asynchronen Ladeprozessen. Die Skill liefert klare Prüfkriterien, wie die Reduzierung der offscreen laufenden Animationen auf null und die Stabilität von DOM/Canvas-Zählern nach Routenwechseln, sowie eine evidenzbasierte Berichterstattung.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Web-Animationen optimieren

Kernregel

Messen Sie die tatsächliche Seite vor dem Bearbeiten. Ziel ist es nicht, Bewegungen zu entfernen, sondern dafür zu sorgen, dass Arbeiten außerhalb des Bildschirms gestoppt werden, sichtbare Bewegungen korrekt wieder aufgenommen werden und bei Routenwechseln/Mount-Bereinigung langlebige Ressourcen freigegeben werden.

Verwenden Sie Codex Browser, wenn verfügbar, insbesondere für localhost-Seiten. Verwenden Sie Chrome nur, wenn der Nutzer explizit danach fragt.

Arbeitsablauf

  1. Repository-Kontext inspizieren.

    • AGENTS.md oder lokale Anweisungen lesen.
    • Frühzeitig git status --short ausführen.
    • Seitenkomponenten, Animation-Hooks, CSS-Keyframes, requestAnimationFrame, setInterval, setTimeout, Canvas/WebGL/Physik-Komponenten, Media-Elemente, GSAP-Timelines/Tweens und bestehende Sichtbarkeits-Helfer finden.
    • Die Effekt-Bereinigung auf Event-Listener, Observer, RAF-Schleifen, Intervalle, Timer, externe Skripte, Media-Streams, WebGL-Texturen/Materialien/Geometrien/Renderer und asynchrone Arbeiten untersuchen, die nach dem Unmount abgeschlossen werden können.
    • Wenn der Arbeitsbaum nicht sauber ist, von Anfang an einen engen Staging-Bereich planen.
  2. Eine Baseline im Browser erfassen.

    • Die genaue Route öffnen, die der Nutzer genannt hat.
    • Profil oben, in der Mitte, im unteren Bereich/Footer und in einer mobilen Ansicht erstellen, wenn das Layout variieren könnte.
    • CSS-Animationen nach berechnetem animationName, animationPlayState und Sichtbarkeit zählen. ::before und ::after einbeziehen.
    • Canvase/WebGL-Elemente separat inspizieren; CSS-Profiling beweist nicht, dass RAF-Schleifen gestoppt haben.
    • Notieren, welche Animationsnamen außerhalb des Bildschirms laufen und welche DOM-Owner dafür verantwortlich sind.
    • Bei Anfragen zu Speicher/Leaks zusätzlich die Anzahl der Elemente/Canvase/Bilder/Iframes, verfügbare JS-Heap-Metriken, eine Leerlaufprobe nach 10-30 Sekunden und eine kurze Routenzyklus-Probe erfassen. Wenn Heap-APIs null zurückgeben oder die Browser-Sandbox Monkey-Patching blockiert, dies erwähnen und sich auf stabile beobachtbare Zählungen plus Quellenaudit verlassen.
    • Belastungstests begrenzt halten. Ein Browser-Tab-Absturz während des Profilings ist ein Hinweis auf Überlastung, aber die Ursache nicht überbewerten, es sei denn, sie wird durch einen minimalen Test reproduziert.
    • Siehe references/browser-profiling.md für einen wiederverwendbaren Codex Browser Evaluator.
  3. Den kleinsten Owner patchen, der die Bewegung kontrolliert.

    • Einen vorhandenen Page-Reveal/Visibility-Hook bevorzugen, falls die App einen hat.
    • Ansonsten einen IntersectionObserver hinzufügen, der eine stabile Klasse wie is-offscreen auf Abschnitte und animierte Kind-Elemente umschaltet.
    • CSS-Animationen mit gezielten Regeln pausieren:
main > section.is-offscreen .expensive-animation,
.expensive-animation.is-offscreen {
  animation-play-state: paused !important;
}
- Bei wiederholten Karten oder Platzhaltern das Karten-Shell und die animierten Nachkommen beobachten, nicht das gesamte Dokument.
- Bei Marquee/Ticker-Spuren die Spur pausieren, wenn ihr Abschnitt außerhalb des Bildschirms ist.
- Bei Skeleton-Ladern und Pseudo-Element-Glimmern bei Bedarf `::before`- und `::after`-Pause-Selektoren einschließen.
- Bei Canvas/WebGL/Physik-Schleifen die RAF-Schleife direkt steuern:
  - Starten, wenn der Canvas/Container sichtbar wird.
  - `requestAnimationFrame` abbrechen, wenn der Bildschirm verlassen wird.
  - Beim Wiedereintreten fortsetzen.
  - Observer trennen und Frames bei der Bereinigung abbrechen.
  - Einen nicht-visuellen Debug-Marker wie `data-animation-active` hinzufügen, wenn dies der Browser-Überprüfung hilft.
- `prefers-reduced-motion` respektieren, wenn die Komponente dies bereits tut, und vermeiden, React-Render-Schleifen für Scroll-/Animationsstatus einzuführen.
- Zur Härtung gegen Leaks:
  - Jedes vom Effekt erstellte Timeout/Interval löschen.
  - RAF vor dem Unmount und vor dem Neustarten einer Schleife abbrechen.
  - `IntersectionObserver`, `ResizeObserver`, `MutationObserver` und benutzerdefinierte Subscriptions trennen.
  - Globale/window/document-Listener mit derselben Handler-Referenz entfernen.
  - Three/WebGL-Texturen, Materialien, Geometrien, Renderer entsorgen und Renderer-DOM-Knoten entfernen.
  - GSAP-Tweens/Timelines für DOM-Knoten und mutable Objekte wie Shader-Uniforms beenden.
  - Media-Streams stoppen und getrennte Video/Audio-Quellen pausieren.
  - Asynchrone Lader mit einem `isDisposed`-Flag schützen und geladene Ressourcen entsorgen, wenn sie nach dem Unmount auflösen.
  - Bei der React-Bereinigung die `ref.current`-Werte innerhalb des Effekts erfassen, bevor die Bereinigung zurückgegeben wird, falls Lint warnt, dass sich der Ref ändern könnte.
  - Physik- oder Simulations-Frame-Deltas nach Sichtbarkeitspausen begrenzen, damit verzögerte Frames keine überdimensionierten Updates ausführen.

4. Verhalten überprüfen, nicht nur Builds. - Route neu laden und dieselben Top/Mid/Footer/Mobile-Profile erneut ausführen. - Zielergebnis: offscreenRunningCount: 0 für die getesteten Seitenabschnitte. - Bestätigen, dass sichtbare Animationen noch laufen oder beim Hineinscrollen wieder aufgenommen werden. - Bestätigen, dass RAF/Canvas-Schleifen außerhalb des Bildschirms inaktiv und im sichtbaren Bereich aktiv sind, oder anderweitig die Abbrechung aus dem Quell- oder Laufzeitzustand nachweisen. - Bei Leak-Audits die Vorher-/Nachher-Routenzyklen und Leerlaufproben vergleichen. DOM/Canvas/Bild-Zähler sollten nach wiederholter Navigation zur gleichen Baseline zurückkehren, wobei kleine erwartete Änderungen durch asynchrone Inhalte toleriert werden. - Eine normale Seiteninteraktion wie Suche/Filter/Navigation durchführen, damit der Observer dynamische Inhalte nicht unterbricht. - Konsolenwarnungen/-fehler in einem frischen Tab überprüfen.

  1. Lokale Prüfungen durchführen.
    • Die normalen Gates des Repositorys verwenden. Bei React/Vite-Apps sind dies oft:
git diff --check
npm run lint
npm run build
- Bekannte nicht-fatale Warnungen getrennt von Fehlern erwähnen.

6. Eng committen, wenn es die Repo-/Benutzeranweisungen erfordern. - Wenn nicht verwandte, nicht bereinigte Änderungen existieren, einen isolierten Index verwenden:

rm -f /tmp/<task>-index
GIT_INDEX_FILE=/tmp/<task>-index git read-tree HEAD
# Nur die beabsichtigten Hunks auf den temporären Index anwenden.
GIT_INDEX_FILE=/tmp/<task>-index git diff --cached --check
GIT_INDEX_FILE=/tmp/<task>-index git commit -m "Offscreen-<Seite>-Animationen pausieren"
git restore --staged <dateien> 2>/dev/null || true
- Niemals breite Dateien aus einem nicht sauberen Arbeitsbaum stagen, es sei denn, jeder Hunk gehört zur Aufgabe.

7. Mit Nachweisen berichten. - Mit Ergebnissen beginnen: was noch lief, was leakanfällig aussah und was nicht gemessen werden konnte. - Quellenaudit-Risiken von Live-Browser-Messungen trennen. - Die genauen abgetasteten Routen, Offscreen-Animation-Zählungen, Stabilität der DOM/Canvas-Zähler, Routenzyklus-Ergebnis und lokale Prüfungen einschließen. - Einschränkungen klar benennen, insbesondere nicht verfügbare Heap-Zähler oder blockierte Browser-Instrumentierung.

Gute Fix-Muster

  • Abschnittsebene is-offscreen plus Elementebene is-offscreen für lange Abschnitte, in denen Animationen untergeordneter Elemente unterhalb der Falzlinie weiterlaufen können.
  • Gemeinsame Sichtbarkeits-Selektor-Konstanten pro Route, z. B. COURSES_PAGE_ANIMATION_VISIBILITY_SELECTOR.
  • IntersectionObserver-Schwellwerte um 0.01 für die Animationssteuerung.
  • Direkte RAF-Schleifensteuerung für WebGL/Canvas-Effekte; CSS animation-play-state kann JavaScript-Render-Schleifen nicht pausieren.
  • Frame-Delta-Begrenzungen für Physik-Schleifen, die nach einer Pause oder einem verzögerten Frame fortgesetzt werden.
  • Erfasste Bereinigungs-Refs für React-Refs, die von GSAP/WebGL-Effekten verwendet werden.
  • isDisposed-Guards für Bild/Video/Textur/Daten-Lader, die nach dem Unmount auflösen können.
  • Kurze Leerlauf- und Routenzyklus-Proben, um akkumulierende DOM-Knoten, Canvase, Iframes oder nicht freigegebene Medien zu erfassen.

Vermeiden

  • Alle Animationen entfernen, um das Profil zu bestehen.
  • Sichtbare Hero-Animationen pausieren, weil ein übergeordneter Selektor zu breit ist.
  • Annahme, dass animation-play-state Pseudo-Elemente oder JavaScript-RAF-Schleifen abdeckt.
  • Sich auf eine einzige Messung am Seitenanfang bei langen Seiten verlassen.
  • Nicht verfügbare Heap-Zähler als Beweis für das Fehlen eines Memory-Leaks behandeln.
  • Unbegrenzte Belastungsschleifen im Browser ausführen; begrenzte Zyklen verwenden und Abstürze ohne Überbetonung der Kausalität aufzeichnen.
  • Screenshots allein als Performance-Nachweis verwenden.
  • Nicht zusammenhängende lokale Hunks im Commit mitnehmen.

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.

Verwandte Skills