Communitygithub.com

scroll-motion

Fügen Sie einer Website scrollgesteuerte und Eintrittsanimationen mit GSAP, ScrollTrigger und Lenis hinzu, einschließlich Einblendungen, Parallaxe, fixierten Abschnitten, horizontalem Scrollen, Linienzeichnung, Zählern und Preloadern.

Was ist scroll-motion?

Dieses Skill ermöglicht es, einer Website hochwertige, scrollgesteuerte Animationen hinzuzufügen, die nicht nur dekorativ sind, sondern auch die Informationsstruktur der Seite unterstützen – etwa um neue Abschnitte anzukündigen, zusammengehörige Elemente zu gruppieren oder eine Erzählung zu führen. Es unterstützt die Plattformen GSAP, ScrollTrigger und Lenis und bietet vorgefertigte Effekte wie Parallaxe, Text-Einblendungen, fixierte Abschnitte, horizontales Scrollen, animierte Zähler und Preloader. Das Skill legt großen Wert auf Performance und Barrierefreiheit: Es animiert nur transform und opacity, beachtet die prefers-reduced-motion-Einstellung und bietet klare Richtlinien für Dauer, Easing und Stagger. Entwickler erhalten zudem praktische Tipps zur Fehlersuche, zum mobilen Einsatz und zum schlanken Workaround mit einfachen CSS-Übergängen, wenn kein GSAP benötigt wird. Referenzbeispiele befinden sich in einer separaten Snippets-Datei.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/scroll-motion

In Ihrer bevorzugten KI fragen

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

Dokumentation

Scroll motion (Scroll-Bewegung)

Bewegung sollte die Struktur erklären: was neu ist, was zusammengehört, was als Nächstes zu sehen ist. Animation, die nichts davon tut, ist nur Dekoration und kostet Performance, daher ist jeder untenstehende Effekt an einen Zweck gebunden.

Einrichtung

<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>

defer verhindert, dass die Skripte den ersten Seitenaufbau blockieren, und führt sie dennoch in der richtigen Reihenfolge aus, sodass main.js (der folgende Code) gsap sieht. Für die Produktion sollten genaue Versionen ([email protected]) angegeben oder die Dateien selbst gehostet werden.

gsap.registerPlugin(ScrollTrigger);

const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
  const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
  lenis.on("scroll", ScrollTrigger.update);
  gsap.ticker.add((t) => lenis.raf(t * 1000));
  gsap.ticker.lagSmoothing(0);
}

Jede Animation in if (!reduce) kapseln oder gsap.matchMedia() verwenden. Menschen mit Gleichgewichtsstörungen setzen diese Einstellung aus gutem Grund, und Inhalte müssen auch ohne Bewegung vollständig sichtbar sein.

Einen Effekt auswählen

ZweckEffektReferenzabschnitt
Einen neuen Abschnitt ankündigenMaskierte Überschriften-EinblendungEinblendungen
Zusammengehörigkeit zeigenGestaffeltes Einblenden von untenEinblendungen
Bildern Tiefe verleihenParallaxe, Clip-Pfad-EinblendungBilder
Eine Abfolge erzählenFixierte Schritte, gezeichnete LinieFixierung
Eine Bandbreite an Arbeiten zeigenHorizontaler ScrollFixierung
Eine Zahl hervorhebenCount-upDetails
Den initialen Ladevorgang abdeckenPreloaderDetails

Kopierfertiger Code für jeden Effekt befindet sich in references/snippets.md. Lies ihn, wenn du kurz davor bist, einen Effekt zu implementieren; für die Planung ist er nicht nötig.

Hausregeln

  • Nur transform und opacity animieren. Das Animieren von top, width, margin oder box-shadow löst bei jedem Frame Layout- oder Paint-Vorgänge aus und ruckelt auf Mittelklasse-Handys.
  • Dauern: 0,6 bis 1,0 s für Einblendungen, 0,2 bis 0,3 s für Hover. Längere Dauern wirken beim zweiten Besuch langsam.
  • Easing: power3.out für Eintritte, power2.inOut für Übergänge, none für scrubbede Animationen (scrub liefert das Easing).
  • Stagger: 0,06 bis 0,12 s. Begrenze die Gesamtzahl: Bei 12 Karten die ersten 6 staffeln und den Rest gemeinsam einblenden.
  • Einmal abspielen. Verwende once: true oder toggleActions: "play none none none". Jedes Zurückscrollen erneut zu animieren, ist ermüdend.
  • Ein Prunkstück pro Seite. Ein fixierter oder horizontaler Abschnitt ist einmal einprägsam und dreimal anstrengend.
  • Initialzustand in JS setzen, nicht in CSS. Wenn das Skript nicht lädt, bleiben CSS-versteckte Inhalte für immer verborgen.
  • Nach Layout-Änderungen aktualisieren: ScrollTrigger.refresh() aufrufen, nachdem Schriftarten und Bilder geladen wurden, sonst verschieben sich die Trigger-Positionen.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());

Mobilgeräte

  • Fixierung und horizontalen Scroll unter 768px mit gsap.matchMedia() deaktivieren; den Inhalt normal stapeln.
  • Lenis‘ weiches Scrollen auf Touch-Geräten kämpft oft mit dem nativen Momentum. Lass Touch-Scrollen (die Standardeinstellung) nativ, es sei denn, der Kunde besteht darauf.
  • Parallax-Distanzen auf kleinen Bildschirmen halbieren.

Fehlersuche

  • markers: true zu einem ScrollTrigger hinzufügen, um Start- und Endlinien zu sehen.
  • Ein Sprung am Anfang einer Fixierung bedeutet meist, dass das fixierte Element ein transform-Elternteil oder eine sich ändernde Höhe hat.
  • Animation wird zu früh ausgelöst: Bilder oberhalb wurden zu spät geladen. Setze explizite width und height auf Bilder.
  • Nichts animiert: Überprüfe, ob das Plugin registriert ist und der Selektor passt.

Ohne GSAP

Für einfache Einblendungen von unten auf einer kleinen Website reicht ein IntersectionObserver, der eine Klasse hinzufügt, plus ein CSS-Übergang aus – das spart etwa 70 KB. Siehe den letzten Abschnitt von references/snippets.md.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Verwandte Skills