Communitygithub.com

AbobakrDiara61/railway-system

Audit- und Behebungs-Tool für Animations-Performance-Probleme wie Layout-Thrashing, Compositor-Eigenschaften, scroll-gebundene Bewegungen und Unschärfeeffekte. Verwende es, wenn Animationen ruckeln, Übergänge haken oder wenn du CSS/JS-Animations-Performance überprüfst.

Was ist railway-system?

Dieses Skill dient der Überprüfung und Optimierung von Animations-Performance in Webanwendungen. Es hilft, häufige Performance-Fehler wie Layout-Thrashing, ineffiziente Paint-Animationen und scroll-gebundene Bewegungen zu identifizieren und zu beheben. Das Skill priorisiert die Nutzung von Compositor-optimierten Eigenschaften (transform, opacity) und bietet konkrete Code-Vorschläge zur Behebung von Problemen. Es unterstützt verschiedene Animationssysteme (CSS, WAAPI, Motion, rAF, GSAP) und ist für Entwickler gedacht, die ruckelnde UI-Animationen oder träge Übergänge verbessern möchten, ohne die gesamte Animationsbibliothek zu migrieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/skills/fixing-motion-performance

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animations-Performance beheben

Behebt Probleme mit der Animations-Performance.

Verwendung

  • /fixing-motion-performance Wendet diese Einschränkungen auf sämtliche UI-Animationen in dieser Konversation an.

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

    • Verstöße (zitiere die genaue Zeile oder den Code-Ausschnitt)
    • warum es wichtig ist (ein kurzer Satz)
    • einen konkreten Fix (Code-Vorschlag auf Code-Ebene)

Migriere keine Animationsbibliotheken, es sei denn, es wird ausdrücklich darum gebeten. Wende die Regeln innerhalb des vorhandenen Stacks an.

Wann verwenden

Beziehe dich auf diese Richtlinien, wenn:

  • UI-Animationen hinzugefügt oder geändert werden (CSS, WAAPI, Motion, rAF, GSAP)
  • ruckelnde Interaktionen oder Übergänge refaktoriert werden
  • scroll-gebundene Bewegungen 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

  • Compositing: transform, opacity
  • Paint: color, borders, gradients, masks, images, filters
  • Layout: size, position, flow, grid, flex

Regelkategorien nach Priorität

PrioritätKategorieAuswirkung
1Niemals-MusterKritisch
2Mechanismus wählenKritisch
3MessungHoch
4ScrollenHoch
5PaintMittel-Hoch
6EbenenMittel
7Unschärfe und FilterMittel
8View-TransitionsNiedrig
9Tool-GrenzenKritisch

Kurzreferenz

1. Niemals-Muster (kritisch)

  • Layout-Reads und -Writes dürfen nicht im selben Frame gemischt werden
  • Layout darf nicht kontinuierlich auf großen oder bedeutenden Flächen animiert werden
  • Animationen dürfen nicht über scrollTop, scrollY oder Scroll-Ereignisse gesteuert werden
  • Keine requestAnimationFrame-Schleifen ohne Abbruchbedingung
  • Mehrere Animationssysteme, die Layout messen oder verändern, dürfen nicht gemischt werden

2. Mechanismus wählen (kritisch)

  • Standardmäßig transform und opacity für Bewegungen verwenden
  • JS-basierte Animationen nur verwenden, wenn die Interaktion sie erfordert
  • Paint- oder Layout-Animationen sind nur auf kleinen, isolierten Flächen akzeptabel
  • Einmalige Effekte sind häufiger akzeptabel als kontinuierliche Bewegungen
  • Technik herunterstufen ist besser, als Bewegung vollständig zu entfernen

3. Messung (hoch)

  • Einmal messen, dann über transform oder opacity animieren
  • Alle DOM-Reads vor den Writes bündeln
  • Layout nicht wiederholt während einer Animation auslesen
  • FLIP-ähnliche Übergänge für layout-ähnliche Effekte bevorzugen
  • Ansätze bevorzugen, die Messung und Writes bündeln

4. Scrollen (hoch)

  • Scroll- oder View-Timelines für scroll-gebundene Bewegungen bevorzugen, wenn verfügbar
  • IntersectionObserver für Sichtbarkeit und Pausieren verwenden
  • Scrollposition nicht für Animationen abfragen
  • Animationen pausieren oder stoppen, wenn sie nicht sichtbar sind
  • Scroll-gebundene Bewegungen dürfen kein kontinuierliches Layout oder Paint auf großen Flächen auslösen

5. Paint (mittel-hoch)

  • Paint-auslösende Animationen sind 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
  • Vererbte CSS-Variablen nicht animieren
  • Animierte CSS-Variablen lokal begrenzen und Vererbung vermeiden

6. Ebenen (mittel)

  • Compositor-Bewegungen erfordern Layer-Promotion, nicht darauf verlassen
  • will-change temporär und punktuell einsetzen
  • Viele oder große Promoted-Layer vermeiden
  • Ebenenverhalten mit Tooling validieren, wenn Performance wichtig ist

7. Unschärfe und Filter (mittel)

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

8. View-Transitions (niedrig)

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

9. Tool-Grenzen (kritisch)

  • Animationsbibliotheken nicht migrieren oder neu schreiben, es sei denn, es wird ausdrücklich darum gebeten
  • Diese Regeln innerhalb des vorhandenen Animationssystems anwenden
  • APIs nicht teilweise migrieren oder Stile innerhalb derselben Komponente mischen

Häufige Lösungen

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

/* scroll-gebunden: scroll-timeline statt JS verwenden */
/* vorher */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500);
/* nachher */  .reveal { animation: fade-in linear; animation-timeline: view(); }
// Messung: Reads vor Writes 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üfungsleitfaden

  • Zuerst kritische Regeln durchsetzen (Niemals-Muster, Tool-Grenzen)
  • Die kostengünstigste Renderarbeit wählen, die der Absicht entspricht
  • Für jede nicht standardmäßige Wahl die Einschränkung angeben, die sie rechtfertigt (Flächengröße, Dauer oder Interaktionsanforderung)
  • Bei der Überprüfung handlungsorientierte Hinweise und konkrete Alternativen bevorzugen, nicht nur Theorie

Einschränkungen

  • Verwende dieses Skill nur, wenn die Aufgabe eindeutig mit dem oben beschriebenen Umfang übereinstimmt.
  • Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
  • Halte inne und frage nach Klärung, 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.

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

Verwandte Skills