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.jsonmö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-guidelinesdelegiert 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:
- Orchestrieren eines Seiteneingangs → references/page-choreography.md
- Staffeln einer Liste oder eines Kartenrasters → references/list-stagger.md
- Animieren eines Modals, Dropdowns oder Popovers → references/popups-modals.md
- Wechseln von Tabs/Filtern mit Höhenänderungen → references/filter-transitions.md
- Rollende Zahlen, Diagramm-Morphing, Tortendiagramm-Enthüllungen → references/live-data.md
- Button-Feedback, Chevron-Drehung, Tooltips → references/hover-micro.md
- Nachschlagen einer Feder-Voreinstellung oder Easing-Kurve → references/spring-presets.md
Lade nur, was du brauchst. Lies nicht alle Referenzen auf einmal.
Modus 1: Neue Animationen erstellen
- Lies die relevante(n) Referenzdatei(en) für das benötigte Muster.
- Beginne mit dem ASCII-Storyboard-Kommentar – plane die gesamte Sequenz, bevor du Code schreibst.
- Definiere ein TIMING-Objekt mit benannten Konstanten für jede Verzögerung.
- Implementiere mit den Mustern aus der Referenz. Verwende standardmäßig Federphysik.
- Überprüfe gegen die unverhandelbaren Regeln unten, bevor du die Fertigstellung meldest.
Modus 2: Überprüfen vorhandener Animationscode
- 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 - Verweise für jedes gefundene Problem auf die spezifische Anti-Pattern-Regel aus der relevanten Referenzdatei.
- 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
- 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.
- Benannte Timing-Konstanten. Jede Verzögerung kommt in ein TIMING-Objekt am Anfang der Datei. Keine magischen Zahlen in
setTimeoutoderdelay-Props. - Spring-first. Bevorzuge Federphysik gegenüber dauerbasiertem Easing für natürliche, unterbrechbare Bewegung. Verwende Dauer nur für Ein- und Ausblendungen sowie Tooltips.
- Stufengetriebene Sequenzierung. Ein einzelner Integer-Zustand steuert mehrteilige Sequenzen. Keine verstreuten Boolean-Flags.
stage >= NMuster. Abschnitte bleiben sichtbar, sobald sie erscheinen. Niemalsstage === N.- Niemals
layoutauf Eltern UND Kindern. Dies ist die häufigste Ursache für ruckelige Filteranimationen. Verwende stattdessenAnimatedHeightmitResizeObserver. - Niemals
staggerChildrenmitAnimatePresence. Es funktioniert nicht zuverlässig. Verwende manuellesdelay: i * stagger. - Respektiere
prefers-reduced-motion. Vonanimation.mdübernommen. Jede Animation muss sich elegant degradieren lassen. - Mount- vs. Update-Unterscheidung. Mount-Animationen sind dramatisch (600ms, ausdrucksstarkes Easing). Update-Animationen sind subtil (150ms, sanftes Easing). Unterschiedliche Phasen, unterschiedliche Konfigurationen.
Design-Prinzipien
- Storyboard-first — plane die Sequenz, bevor du Code schreibst
- Spring-first — Federphysik vor dauerbasiertem Easing
- Benannte Konstanten — jeder Timing-Wert wird deklariert, nicht inline
- Stufengetrieben — ein einzelner Integer-Zustand orchestriert komplexe Sequenzen
- Datengetrieben — wiederholte Elemente verwenden
.map()mit indexbasierten Verzögerungen, keine kopierten Blöcke - Messen, nicht raten —
ResizeObserverfü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 vonanimation.mdfür Einschränkungen maßgeblich; dieses Skill ist maßgeblich für Implementierungsrezepte.number-formatting— für Live-aktualisierte Zahlenanzeigen verwendenumber-formattingfü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 >= NMuster - 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.