Communitygithub.com

ASoudy/AGS

Überprüfen und Beheben von Animations-Performance-Problemen, einschließlich Layout-Thrashing, Compositor-Eigenschaften, scrollgebundenen Animationen und Unschärfeeffekten. Verwenden Sie dies, wenn Animationen ruckeln, Übergänge hakeln oder Sie die CSS/JS-Animationsleistung überprüfen.

Was ist AGS?

Dieses Skill-Tool, ASoudy/AGS (Animation & Graphics Sanity), ist ein spezialisierter Assistent zur Diagnose und Behebung von UI-Animations-Performance-Problemen. Es hilft Entwicklern dabei, häufige Ursachen für Ruckeln und Haken zu identifizieren, wie Layout-Thrashing (ineffizientes Hintereinanderausführen von Lese- und Schreiboperationen), übermäßige Nutzung von Paint- oder Layout-Triggern, scrollgebundene Animationen, die auf window.scrollY basieren, sowie den Missbrauch von Unschärfe- und Filtereffekten. Das Skill bietet neun priorisierte Regelkategorien, von kritischen „Never Patterns“ bis zu Low-Priority-View-Transitions, und enthält konkrete Code-Fixes (z. B. Ersetzen von width- durch transform-Animationen oder Nutzung von Scroll-Timelines). Es unterstützt gängige Plattformen wie Claude Code, Cursor und Codex, indem es als markdownbasierte Anleitung in den Kontext eingefügt wird. Entwickler können das Skill mit `/fixing-motion-performance` aktivieren oder eine spezifische Datei (`/fixing-motion-performance <file>`) zur Überprüfung einreichen. Es ist besonders nützlich bei der Implementierung neuer Animationen, der Refaktorierung ruckelnder Interaktionen oder der Überprüfung von Komponenten, die will-change, transforms oder Layout-Messungen verwenden. Das Skill respektiert bestehende Animationsbibliotheken und rät von Migrationen ohne explizite Anfrage ab.

Funktioniert mit~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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Bewegungsperformance beheben

Beheben Sie Animations-Performance-Probleme.

Verwendung

  • /fixing-motion-performance Wendet diese Einschränkungen auf alle UI-Animationsarbeiten in dieser Konversation an.

  • /fixing-motion-performance <datei> Überprüft die Datei anhand aller untenstehenden Regeln und meldet:

    • Verstöße (zitieren Sie die genaue Zeile oder den Code-Ausschnitt)
    • warum es wichtig ist (ein kurzer Satz)
    • eine konkrete Lösung (Code-Vorschlag)

Migrieren Sie keine Animationsbibliotheken, es sei denn, dies wird ausdrücklich verlangt. Wenden Sie die Regeln innerhalb des bestehenden Stacks an.

Wann verwenden

Ziehen Sie diese Richtlinien heran, wenn:

  • UI-Animationen hinzugefügt oder geändert werden (CSS, WAAPI, Motion, rAF, GSAP)
  • ruckelnde Interaktionen oder Übergänge refaktoriert werden
  • scrollgebundene Animationen oder Einblendungen beim Scrollen implementiert werden
  • Layout, Filter, Masken, Verläufe oder CSS-Variablen animiert werden
  • Komponenten überprüft werden, die will-change, transforms oder Messungen verwenden

Glossar der Rendering-Schritte

  • composite: transform, opacity
  • paint: Farbe, Rahmen, Verläufe, Masken, Bilder, Filter
  • layout: Größe, Position, Fluss, Grid, Flex

Regelkategorien nach Priorität

PrioritätKategorieAuswirkung
1Never Patternskritisch
2Mechanismus wählenkritisch
3Messunghoch
4Scrollenhoch
5Paintmittel-hoch
6Ebenenmittel
7Unschärfe und Filtermittel
8View-Transitionsniedrig
9Werkzeuggrenzenkritisch

Kurzreferenz

1. Never Patterns (kritisch)

  • Layout-Lese- und Schreiboperationen nicht im selben Frame mischen
  • Layout nicht kontinuierlich auf großen oder bedeutenden Oberflächen animieren
  • Animation nicht über scrollTop, scrollY oder Scroll-Ereignisse steuern
  • Keine requestAnimationFrame-Schleifen ohne Abbruchbedingung
  • Nicht mehrere Animationssysteme mischen, die jeweils Layout messen oder mutieren

2. Mechanismus wählen (kritisch)

  • Standardmäßig transform und opacity für Bewegung verwenden
  • JavaScript-gesteuerte Animationen nur verwenden, wenn die Interaktion es erfordert
  • Paint- oder Layout-Animation ist nur auf kleinen, isolierten Oberflächen akzeptabel
  • Einmal-Effekte sind häufiger akzeptabel als kontinuierliche Bewegung
  • Technik downgraden statt Bewegung komplett entfernen

3. Messung (hoch)

  • Einmal messen, dann über transform oder opacity animieren
  • Alle DOM-Lesevorgänge vor den Schreibvorgängen bündeln
  • Layout nicht wiederholt während einer Animation messen
  • FLIP-ähnliche Übergänge für layoutartige Effekte bevorzugen
  • Ansätze bevorzugen, die Messungen und Schreibvorgänge bündeln

4. Scrollen (hoch)

  • Scroll- oder View-Timelines für scrollgebundene Bewegung bevorzugen, wenn verfügbar
  • IntersectionObserver für Sichtbarkeit und Pausieren verwenden
  • Scroll-Position nicht für Animation abfragen
  • Animationen pausieren oder stoppen, wenn das Element nicht sichtbar ist
  • Scrollgebundene Bewegung darf kein kontinuierliches Layout oder Paint auf großen Oberflächen auslösen

5. Paint (mittel-hoch)

  • Paint-auslösende Animation ist nur auf kleinen, isolierten Elementen erlaubt
  • Paint-intensive Eigenschaften nicht auf großen Containern animieren
  • CSS-Variablen für transform, opacity oder position nicht animieren
  • Geerbte CSS-Variablen nicht animieren
  • Animiere CSS-Variablen lokal begrenzen und Vererbung vermeiden

6. Ebenen (mittel)

  • Compositor-Bewegung erfordert Ebenen-Promotion, nie annehmen
  • will-change zeitlich begrenzt und gezielt einsetzen
  • Viele oder große Promoted-Layer vermeiden
  • Ebenenverhalten mit Werkzeugen validieren, wenn Performance wichtig ist

7. Unschärfe und Filter (mittel)

  • Unschärfe-Animation klein halten (<=8px)
  • Unschärfe nur für kurze, einmalige Effekte verwenden
  • Unschärfe nie kontinuierlich animieren
  • Unschärfe nie auf großen Oberflächen animieren
  • opacity und translate vor Unschärfe bevorzugen

8. View-Transitions (niedrig)

  • View-Transitions nur für Navigationsänderungen verwenden
  • View-Transitions für interaktionsintensive UI vermeiden
  • View-Transitions vermeiden, wenn Unterbrechung oder Abbruch erforderlich ist
  • Größenänderungen als potenziell layoutauslösend behandeln

9. Werkzeuggrenzen (kritisch)

  • Animationsbibliotheken nicht migrieren oder umschreiben, es sei denn, dies wird ausdrücklich verlangt
  • Diese Regeln innerhalb des bestehenden Animationssystems anwenden
  • APIs nicht teilweise migrieren oder Stile innerhalb derselben Komponente mischen

Häufige Lösungen

/* Layout-Thrashing: Statt width besser transform animieren */
/* vorher */ .panel { transition: width 0.3s; }
/* nachher */  .panel { transition: transform 0.3s; }

/* Scrollgebunden: Statt JS scroll-timeline verwenden */
/* vorher */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* nachher */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// Messung: Lesevorgänge vor Schreibvorgängen bündeln (FLIP)
// vorher — Layout-Thrashing
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// nachher — einmal messen, über transform animieren
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 = ''; });

Überprüfungsrichtlinien

  • Kritische Regeln zuerst durchsetzen (Never Patterns, Werkzeuggrenzen)
  • Die kostengünstigste Render-Arbeit wählen, die der Absicht entspricht
  • Bei jeder nicht standardmäßigen Wahl die Einschränkung nennen, die sie rechtfertigt (Oberflächengröße, Dauer oder Interaktionsanforderung)
  • Bei Überprüfungen handlungsorientierte Hinweise und konkrete Alternativen gegenüber theoretischen Ausführungen bevorzugen

Einschränkungen

  • Verwenden Sie dieses Skill nur, wenn die Aufgabe eindeutig zum oben beschriebenen Umfang passt.
  • Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
  • Fragen Sie nach und holen Sie Klarstellungen ein, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.

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.

Verwandte Skills