Communitygithub.com

Abduovv/Arcadia-frontend

Behebe ruckelhafte Seitenladevorgänge, bei denen alles auf einmal erscheint. Bereitstellt produktionsreife Framer-Motion-Rezepte für choreografierte Seiteneingänge, gestaffelte Listen, modale Übergänge, Filterüberblendungen, Live-Daten-Animationen und Mikrointeraktionen.

Was ist Arcadia-frontend?

Dieses Skill behebt das häufigste Animationsproblem in Crypto- und modernen Web-UI: ein unkoordiniertes Erscheinen aller Elemente gleichzeitig ohne Choreografie, Staffelung oder Federphysik – ein Problem, das sich selbst bei korrektem Code ruckelig anfühlt. Es bietet eine Sammlung produktionserprobter Framer-Motion-Rezepte für verschiedene Anwendungsfälle: choreografierte Seitenentrance mit ASCII-Storyboards und benannten Timing-Konstanten, indexbasierte Staffelung für Listen und Kartenraster, mehrschichtige Modal- und Popover-Übergänge, Höhenübergänge bei Tab- und Filterwechseln (mittels ResizeObserver statt layout-Prop), Live-Daten-Animationen (rollende Zahlen, SVG-Tortendiagramme, Chart-Morphing) sowie Mikrointeraktionen (Hover-Feedback, Chevron-Drehung, Tooltips). Das Skill folgt einem Spring-First-Ansatz (bevorzugt Federphysik vor dauerbasierter Easing) und definiert sieben unverhandelbare Regeln, darunter die Verwendung eines einzigen integer-Stage-States für komplexe Sequenzen, das Verbot von `layout` auf Eltern- und Kind-Elementen gleichzeitig, robuste reduced-motion-Handhabung und die Unterscheidung zwischen Mount- (dramatisch) und Update-Animationen (subtil). Es richtet sich an Entwickler, die Seiten- oder Komponentenebene animieren, fehlerhafte Animationscodes überprüfen oder schnell nach Produktionsmustern suchen möchten, und interagiert eng mit den Skills `frontend-design-guidelines` (für grundlegende Animationsregeln), `number-formatting` (für Live-Zahlen) und `brand-design` (für Farbkontexte).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Abduovv/Arcadia-frontend/tree/HEAD/.agents/skills/page-load-animations

In Ihrer bevorzugten KI fragen

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

Dokumentation

Präambel (zuerst ausführen)

_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//'  || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRY: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"page-load-animations","phase":"build","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"page-load-animations","phase":"build","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi

Wenn TEL_PROMPTED no ist: Frage den Benutzer vor Beginn des Skill-Workflows nach der Telemetrie. Verwende AskUserQuestion:

Hilf superstack, besser zu werden! Wir verfolgen, welche Skills verwendet werden und wie lange sie dauern – kein Code, keine Dateipfade, keine personenbezogenen Daten. Änderungen jederzeit in ~/.superstack/config.json möglich.

Optionen:

  • A) Ja, hilf superstack zu verbessern (anonym)
  • B) Nein danke

Wenn A: Führe dieses Bash aus:

echo '{"telemetryTier":"anonymous"}' > ~/.superstack/config.json
_TEL_TIER="anonymous"
touch ~/.superstack/.telemetry-prompted

Wenn B: Führe dieses Bash aus:

echo '{"telemetryTier":"off"}' > ~/.superstack/config.json
_TEL_TIER="off"
touch ~/.superstack/.telemetry-prompted

Dies geschieht nur einmal. Wenn TEL_PROMPTED yes ist, überspringe dies vollständig und fahre mit dem Skill-Workflow fort.

Falscher Skill? Siehe SKILL_ROUTER.md für alle verfügbaren Skills.

Seitenlade-Animationen

Muster, adaptiert von kampferprobten Framer-Motion-Rezepten. Ursprüngliche Inspiration: suzi-ux-motions.

Produktionsreife Framer-Motion-Rezepte, damit Seitenladevorgänge absichtsvoll und nicht chaotisch wirken. Dieses Skill existiert, weil das häufigste Animationsproblem in Crypto-Benutzeroberflächen nicht fehlende Animation ist – sondern dass alles gleichzeitig ohne Choreografie, Staffelung oder Federphysik erscheint. Das Ergebnis fühlt sich selbst dann defekt an, wenn der Code korrekt ist.

Dieses Skill stellt die Implementierungsrezepte bereit. Für Animationstheorie (wann animieren, Dauerstufen, Easing-Kurven, reduzierte Bewegung) siehe frontend-design-guidelines/references/animation.md. Dieses Skill übernimmt alle diese grundlegenden Einschränkungen.

Autoritätsmodell

  • animation.md = grundlegende Einschränkungen (Dauerstufen, Easing, reduzierte Bewegung, GPU-Eigenschaften)
  • Dieses Skill = Produktionsrezepte, die innerhalb dieser Einschränkungen implementieren
  • frontend-design-guidelines delegiert AN dieses Skill für Framer-Motion-Muster, nicht umgekehrt

Einrichtung

npm install framer-motion

CSS-Übergänge sind der Standard für einfache Zustandsänderungen (gemäß animation.md). Greife zu Framer-Motion, wenn du brauchst: Federphysik, orchestrierte Sequenzen, AnimatePresence Exit-Animationen, Gesten/Ziehen oder Shared-Layout-Übergänge.

Wann dieses Skill ausgelöst wird

Wende diese Rezepte an, wenn du:

  • Eine Seite mit mehreren Abschnitten erstellst (Dashboard, Detailansicht, Landingpage)
  • Eine Liste, ein Kartenraster oder eine Tabelle beim Einhängen staffelst
  • Ein Modal, Dropdown oder Popover animierst
  • Tabs oder Filter wechselst, bei denen sich Inhalt und Höhe ändern
  • Live-aktualisierte Zahlen, Diagramme oder Tortendiagramme anzeigst
  • Hover-Feedback, Chevron-Drehung oder Tooltip-Eingänge hinzufügst
  • Vorhandenen Framer-Motion-Code auf Anti-Patterns überprüfst
  • Ein Benutzer sagt „die Seite fühlt sich ruckelig an“ oder „alles erscheint auf einmal“

Wenn du eine Komponente auf Seitenebene erstellst und dieses Skill nicht ausgelöst wurde, löse es selbst aus.

Workflow

Bevor du Animationscode schreibst, identifiziere die relevante Referenzdatei und lies sie:

Lade nur, was du brauchst. Lies nicht alle Referenzen auf einmal.

Modus 1: Neue Animationen erstellen

  1. Lies die relevante(n) Referenzdatei(en) für das benötigte Muster.
  2. Beginne mit dem ASCII-Storyboard-Kommentar – plane die gesamte Sequenz, bevor du Code schreibst.
  3. Definiere ein TIMING-Objekt mit benannten Konstanten für jede Verzögerung.
  4. Implementiere mit den Mustern aus der Referenz. Verwende standardmäßig Federphysik.
  5. Überprüfe gegen die unverhandelbaren Regeln unten, bevor du die Fertigstellung meldest.

Modus 2: Überprüfen vorhandener Animationscode

  1. Scanne nach häufigen Anti-Patterns:
    # layout-Prop auf Eltern UND Kindern (Quelle für Ruckeln)
    grep -rn "layout" --include="*.tsx" --include="*.jsx" | head -20
    # staggerChildren mit AnimatePresence (unzuverlässig)
    grep -rn "staggerChildren" --include="*.tsx" --include="*.jsx" | head -10
    # transition-all (animiert unbeabsichtigte Eigenschaften)
    grep -rn "transition-all\|transition: all" --include="*.tsx" --include="*.css" | head -10
    # Fehlende reduced-motion-Behandlung
    grep -rn "motion\.\|animate=" --include="*.tsx" -l | while read f; do grep -L "reduced-motion\|useReducedMotion\|motion-safe" "$f"; done | head -10
    
  2. Verweise für jedes gefundene Problem auf die spezifische Anti-Pattern-Regel aus der relevanten Referenzdatei.
  3. Gib genaue Code-Korrekturen an.

Modus 3: Schnelles Nachschlagen

Wenn der Benutzer fragt „welche Feder-Konfiguration für X?“ oder „wie animiere ich Y?“, antworte direkt aus den Referenzdateien und Feder-Voreinstellungen, ohne einen vollständigen Workflow auszuführen.

Unverhandelbare Regeln

  1. ASCII-Storyboard-Kommentar. Jede animierte Seite beginnt mit einem Zeitlinienkommentar, der die gesamte Sequenz auf einen Blick zeigt. Zeiten sind absolut ab Einhängen, rechtsbündig.
  2. Benannte Timing-Konstanten. Jede Verzögerung kommt in ein TIMING-Objekt am Anfang der Datei. Keine magischen Zahlen in setTimeout oder delay-Props.
  3. Spring-first. Bevorzuge Federphysik gegenüber dauerbasiertem Easing für natürliche, unterbrechbare Bewegung. Verwende Dauer nur für Ein- und Ausblendungen sowie Tooltips.
  4. Stufengetriebene Sequenzierung. Ein einzelner Integer-Zustand steuert mehrteilige Sequenzen. Keine verstreuten Boolean-Flags.
  5. stage >= N Muster. Abschnitte bleiben sichtbar, sobald sie erscheinen. Niemals stage === N.
  6. Niemals layout auf Eltern UND Kindern. Dies ist die häufigste Ursache für ruckelige Filteranimationen. Verwende stattdessen AnimatedHeight mit ResizeObserver.
  7. Niemals staggerChildren mit AnimatePresence. Es funktioniert nicht zuverlässig. Verwende manuelles delay: i * stagger.
  8. Respektiere prefers-reduced-motion. Von animation.md übernommen. Jede Animation muss sich elegant degradieren lassen.
  9. Mount- vs. Update-Unterscheidung. Mount-Animationen sind dramatisch (600ms, ausdrucksstarkes Easing). Update-Animationen sind subtil (150ms, sanftes Easing). Unterschiedliche Phasen, unterschiedliche Konfigurationen.

Design-Prinzipien

  1. Storyboard-first — plane die Sequenz, bevor du Code schreibst
  2. Spring-first — Federphysik vor dauerbasiertem Easing
  3. Benannte Konstanten — jeder Timing-Wert wird deklariert, nicht inline
  4. Stufengetrieben — ein einzelner Integer-Zustand orchestriert komplexe Sequenzen
  5. Datengetrieben — wiederholte Elemente verwenden .map() mit indexbasierten Verzögerungen, keine kopierten Blöcke
  6. Messen, nicht raten — ResizeObserver für dynamische Höhen, niemals fest codierte Pixelhöhen

Integration mit anderen Skills

  • frontend-design-guidelines — das allgemeine UI-Skill. Es delegiert Framer-Motion-Arbeit an dieses Skill. Wenn beide ausgelöst werden, sind die Basisregeln von animation.md für Einschränkungen maßgeblich; dieses Skill ist maßgeblich für Implementierungsrezepte.
  • number-formatting — für Live-aktualisierte Zahlenanzeigen verwende number-formatting für die Formatierungsspezifikation und dieses Skill für das rollende Ziffern-Animationsmuster.
  • brand-design — Markenfarben können die Animationsfarbwahl beeinflussen (positive/negative Indikatoren, Akzenthighlights).

Ressourcen

references/

  • references/page-choreography.md — Stufengetriebener Seiteneingang mit ASCII-Storyboards, TIMING-Objekten, Abschnittskonfigurationen, Feder-Voreinstellungen und dem stage >= N Muster
  • references/list-stagger.md — Indexbasierte Staffelungsverzögerungen, StaggerItem-Wrapper, Timing/Offset-Richtlinien und Anti-Patterns
  • references/popups-modals.md — Dreischichtige Modal-Animation (Hintergrund, Panel, Inhaltsstaffelung), Dropdown-Muster, Schließverhalten
  • references/filter-transitions.md — AnimatedHeight mit ResizeObserver, Überblendung mit keyed Wrapper, kritisches layout-Anti-Pattern
  • references/live-data.md — Rollende Ziffern (Spielautomat), SVG-Tortendiagramm-Enthüllungen, Diagramm-Morphing, Mount- vs. Update-Phasenverwaltung
  • references/hover-micro.md — CSS vs. Framer-Motion-Entscheidungsmatrix, Button-Feedback, Chevron-Drehung, Tooltip-Eingang, Kopier-Feedback
  • references/spring-presets.md — Alle Voreinstellungen als Tabellen + JSON: Feder-Konfigurationen, Easing-Kurven, Staffelungswerte, Dauer-Voreinstellungen

Skill-übergreifende Referenzen

  • frontend-design-guidelines/references/animation.md — grundlegende Einschränkungen, die dieses Skill übernimmt (Dauerstufen, Easing, reduzierte Bewegung, GPU-Eigenschaften)
  • number-formatting — für Zahlenanzeigeregeln (Formatierung, nicht Animation)

Kurzstart

# Auslöser:
#   "Behebe meinen Seitenladevorgang – alles erscheint auf einmal"
#   "Füge diesem Dashboard Eintrittsanimationen hinzu"
#   "Die Modal-Animation fühlt sich ruckelig an"
#   "Wie staffele ich diese Karten?"
#   "Welche Feder-Konfiguration soll ich für ein Dropdown verwenden?"
#   "Füge eine rollende Zahlenanimation zur Kontostandanzeige hinzu"
#   Wird automatisch ausgelöst beim Erstellen von Komponenten auf Seitenebene

Telemetrie (zuletzt ausführen)

Nach Abschluss des Skill-Workflows (Erfolg, Fehler oder Abbruch) protokolliere das Telemetrie-Ereignis. Bestimme das Ergebnis aus dem Workflow-Ergebnis: success bei normalem Abschluss, error bei Fehler, abort bei Benutzerabbruch.

Führe dieses Bash aus:

_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"page-load-animations","phase":"build","event":"completed","outcome":"OUTCOME","duration_s":"'"$_TEL_DUR"'","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi

Ersetze OUTCOME je nach Workflow-Ergebnis mit success/error/abort.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills