Communitygithub.com

MengTo/Skills

使用 Lenis 平滑滚动、GSAP ScrollTrigger、滚动关联进度、交错文字显现、粘性卡片堆叠、视差背景、滚动擦除过渡、页脚显现以及沉浸式预加载器,创建电影般的滚动驱动着陆页。在分析或构建高端编辑式滚动体验、粘性项目堆叠、动态排版或逐节叙事时使用。

Skills 是什么?

该技能是一个完整的开发工具包,用于构建电影般的滚动叙事型着陆页,特别适合高端创意工作室、作品集和产品展示。它基于 Lenis(平滑滚动库)、GSAP 和 ScrollTrigger(滚动触发器)构建,提供一系列预定义的动画模式:交错的文字显现、粘性卡片堆叠(具有缩放和深度效果)、视差背景、滚动擦除过渡以及沉浸式预加载器。该技能强调克制且精致的动画语言(例如 power4.ease),避免弹跳或突兀的效果,以营造类似 Apple 的抛光感和 Awwwards 级别的交互体验。它支持所有主流平台(Web),并内置了`prefers-reduced-motion`降级方案,确保无障碍性。开发者可以按照其分层构建顺序(从静态页面到预加载器、文字显现、粘性堆叠和视差)逐步实现,最终形成一个具有叙事深度的统一、高性能的滚动体验。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/web-design/cinematic-scroll-storytelling

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

Skills preview

文档

电影式滚动叙事

使用时机

  • 页面应呈现为高级编辑式故事,随用户滚动而展开。
  • 用户提及滚动驱动叙事、滚动关联动画、粘性卡片堆叠、视差、分割文字、预加载器或电影式进展。
  • 作品集、工作室、产品或着陆页需要逐节显现并具有层次深度。
  • 实现可使用 GSAP、ScrollTrigger 和 Lenis。

效果词汇表

  • 滚动驱动叙事:各区域在滚动过程中以序列方式显现。
  • 滚动关联动画:进度直接与滚动挂钩(使用 scrub)。
  • 滚动触发动画:当区域进入视口时动画启动。
  • 交错显现:单词、行、卡片或元素以微小延迟进入。
  • 渐进显现:不透明度、缩放、模糊、裁剪或位置随滚动进度变化。
  • 粘性卡片堆叠:粘性卡片层叠、缩放,并在下一张卡片出现时后退。
  • 视差滚动:背景和前景层以不同速度移动。
  • 滚动擦除:动画通过 scrub: true 或 scrub: 1 跟随滚动条。
  • 动态排版:带遮罩的分割文字移动,通常逐词或逐行。
  • 预加载器:开场加载画面、进度条和入场过渡。

目标感受

  • 奢华编辑式网站。
  • 高端创意工作室作品集。
  • Apple 级别的动作打磨。
  • 现代 Awwwards 交互语言。
  • 沉浸式电影着陆页。

避免:

  • 弹跳、弹性或弹簧式运动。
  • 激进的缩放跳跃。
  • 浮夸的游戏风格效果。
  • 过多同时进行的滚动效果。
  • 使页面难以阅读的滚动劫持。

核心技术栈

npm i gsap lenis
import Lenis from "lenis";
import "lenis/dist/lenis.css";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";

gsap.registerPlugin(ScrollTrigger);

const reduceMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;

if (!reduceMotion) {
  const lenis = new Lenis({
    lerp: 0.08,
    smoothWheel: true,
    wheelMultiplier: 0.9,
  });

  lenis.on("scroll", ScrollTrigger.update);

  gsap.ticker.add((time) => {
    lenis.raf(time * 1000);
  });

  gsap.ticker.lagSmoothing(0);
}

window.addEventListener("load", () => ScrollTrigger.refresh());

动效令牌

  • 入场缓动:power3.out 或 power4.out。
  • 擦除场景:ease: "none" 搭配 scrub: 0.8 到 1.4。
  • 文字显现时长:0.8s 到 1.1s。
  • 卡片显现时长:0.9s 到 1.2s。
  • 单词交错:0.035s 到 0.07s。
  • 行交错:0.08s 到 0.14s。
  • 卡片交错:0.06s 到 0.1s。
  • 显现偏移:y: 24 到 48。
  • 模糊:4px 到 10px,然后为 0px。
  • 粘性卡片缩放深度:1 降至 0.92。

页面结构

  1. 预加载器:黑屏、进度条、品牌/标题、入场淡出。
  2. 英雄区:图片视差、遮罩标题显现、微妙的滚动提示。
  3. 介绍区:逐词动态排版。
  4. 故事区:滚动触发的淡入上移、模糊进入和裁剪显现。
  5. 近期项目:带缩放和层次深度的粘性卡片堆叠。
  6. 画廊或证明:滚动擦除的水平或渐进显现。
  7. 页脚:视差显现或缓慢向上交接。

标记模式

<div class="preloader" data-preloader>
  <div class="preloader__bar" data-preloader-bar></div>
</div>

<main>
  <section class="hero" data-parallax-section>
    <img data-parallax-layer data-speed="-0.18" src="/hero.jpg" alt="">
    <h1 data-split-reveal>设计以电影般的克制自然展开。</h1>
  </section>

  <section data-story-section>
    <p data-split-reveal="words">每一块都在静谧中抵达。</p>
  </section>

  <section class="project-stack" data-sticky-stack>
    <article data-stack-card>项目一</article>
    <article data-stack-card>项目二</article>
    <article data-stack-card>项目三</article>
  </section>

  <footer data-footer-parallax>...</footer>
</main>

预加载器序列

使用预加载器设定电影基调,然后交接至英雄区显现。

function initPreloader() {
  const loader = document.querySelector("[data-preloader]");
  const bar = document.querySelector("[data-preloader-bar]");
  if (!loader) return Promise.resolve();

  if (reduceMotion) {
    loader.remove();
    return Promise.resolve();
  }

  return new Promise((resolve) => {
    const tl = gsap.timeline({
      defaults: { ease: "power3.out" },
      onComplete: () => {
        loader.remove();
        resolve();
      },
    });

    tl.fromTo(bar, { scaleX: 0, transformOrigin: "left" }, { scaleX: 1, duration: 1.1 })
      .to(loader, { yPercent: -100, duration: 0.9, ease: "power4.inOut" }, "+=0.15");
  });
}

分割文字显现

使用遮罩溢出容器。避免分割包含链接或有意义的内联标记的文字。

function splitWords(element) {
  if (element.dataset.splitReady === "true") return;

  const text = element.textContent || "";
  const parts = text.split(/(\s+)/);
  element.textContent = "";
  element.setAttribute("aria-label", text.trim());

  parts.forEach((part) => {
    if (!part.trim()) {
      element.appendChild(document.createTextNode(part));
      return;
    }

    const mask = document.createElement("span");
    const word = document.createElement("span");
    mask.className = "split-word-mask";
    word.className = "split-word";
    word.textContent = part;
    mask.setAttribute("aria-hidden", "true");
    mask.appendChild(word);
    element.appendChild(mask);
  });

  element.dataset.splitReady = "true";
}

function initSplitReveals() {
  if (reduceMotion) {
    gsap.set("[data-split-reveal]", { autoAlpha: 1 });
    return;
  }

  gsap.utils.toArray("[data-split-reveal]").forEach((element) => {
    splitWords(element);
    const words = element.querySelectorAll(".split-word");

    gsap.fromTo(
      words,
      { yPercent: 110, autoAlpha: 0, filter: "blur(8px)" },
      {
        yPercent: 0,
        autoAlpha: 1,
        filter: "blur(0px)",
        duration: 0.95,
        ease: "power4.out",
        stagger: 0.05,
        scrollTrigger: {
          trigger: element,
          start: "top 82%",
          once: true,
        },
      }
    );
  });
}
.split-word-mask {
  display: inline-block;
  overflow: hidden;
  vertical-align: top;
}

.split-word {
  display: inline-block;
  will-change: transform, opacity, filter;
}

滚动触发显现

用于普通区域。它们应播放一次,且感觉沉稳,而非抽搐。

function initSectionReveals() {
  if (reduceMotion) {
    gsap.set("[data-story-section], [data-reveal-item]", { autoAlpha: 1, clearProps: "all" });
    return;
  }

  gsap.utils.toArray("[data-story-section]").forEach((section) => {
    const items = section.querySelectorAll("[data-reveal-item]");
    const targets = items.length ? items : section.children;

    gsap.fromTo(
      targets,
      { y: 36, autoAlpha: 0, filter: "blur(8px)" },
      {
        y: 0,
        autoAlpha: 1,
        filter: "blur(0px)",
        duration: 1,
        ease: "power4.out",
        stagger: 0.08,
        scrollTrigger: {
          trigger: section,
          start: "top 82%",
          once: true,
        },
      }
    );
  });
}

滚动关联进度

使用擦除时间线实现电影式进展。保持擦除动画线性,让滚动位置控制时间。

function initProgressionScenes() {
  if (reduceMotion) return;

  gsap.utils.toArray("[data-progress-scene]").forEach((scene) => {
    const media = scene.querySelector("[data-progress-media]");
    const copy = scene.querySelectorAll("[data-progress-copy]");

    gsap.timeline({
      scrollTrigger: {
        trigger: scene,
        start: "top top",
        end: "+=140%",
        scrub: 1.1,
        pin: true,
        anticipatePin: 1,
      },
    })
      .fromTo(media, { scale: 1.08 }, { scale: 1, ease: "none" })
      .fromTo(copy, { autoAlpha: 0, y: 40 }, { autoAlpha: 1, y: 0, stagger: 0.15, ease: "none" }, 0.15);
  });
}

粘性卡片堆叠

使用 position: sticky 进行布局,使用 ScrollTrigger 实现层叠缩放/深度。较早的卡片应在后续卡片出现时后退。

[data-sticky-stack] {
  position: relative;
}

[data-stack-card] {
  position: sticky;
  top: 12vh;
  transform-origin: center top;
  will-change: transform, opacity;
}
function initStickyCardStack() {
  if (reduceMotion) return;

  gsap.utils.toArray("[data-sticky-stack]").forEach((stack) => {
    const cards = gsap.utils.toArray(stack.querySelectorAll("[data-stack-card]"));

    cards.forEach((card, index) => {
      const nextCard = cards[index + 1];
      if (!nextCard) return;

      gsap.to(card, {
        scale: 0.92 + index * 0.015,
        autoAlpha: 0.72,
        y: -24,
        ease: "none",
        scrollTrigger: {
          trigger: nextCard,
          start: "top 78%",
          end: "top 24%",
          scrub: true,
          invalidateOnRefresh: true,
        },
      });
    });
  });
}

视差

将视差用于英雄区图片、背景层和页脚显现。保持距离较小。

function initParallax() {
  if (reduceMotion) return;

  gsap.utils.toArray("[data-parallax-layer]").forEach((layer) => {
    const speed = Number(layer.dataset.speed || -0.16);
    const section = layer.closest("[data-parallax-section]") || layer;

    gsap.to(layer, {
      y: () => window.innerHeight * speed,
      ease: "none",
      scrollTrigger: {
        trigger: section,
        start: "top bottom",
        end: "bottom top",
        scrub: 1,
        invalidateOnRefresh: true,
      },
    });
  });
}

页脚视差显现:

function initFooterReveal() {
  if (reduceMotion) return;

  const footer = document.querySelector("[data-footer-parallax]");
  if (!footer) return;

  gsap.fromTo(
    footer,
    { yPercent: -12, autoAlpha: 0.85 },
    {
      yPercent: 0,
      autoAlpha: 1,
      ease: "none",
      scrollTrigger: {
        trigger: footer,
        start: "top bottom",
        end: "top 45%",
        scrub: 1,
      },
    }
  );
}

构建顺序

  1. 先构建静态页面。
  2. 添加预加载器和英雄区入场。
  3. 添加分割文字显现。
  4. 添加逐节显现。
  5. 添加粘性卡片堆叠进度。
  6. 添加视差层。
  7. 仅在故事需要的地方添加擦除固定的场景。
  8. 添加减少动效和触摸的降级方案。
  9. 在桌面端和移动端进行浏览器质量保证。

提示词模板

使用平滑的 Lenis 滚动、GSAP ScrollTrigger 动画、交错的文字显现、粘性卡片堆叠进度、视差背景、滚动擦除过渡、逐节叙事以及沉浸式预加载器动画,创建一个电影般滚动驱动的着陆页。运用层次深度、缩放过渡、渐进不透明度变化和流畅的视口触发动效,打造高级编辑体验。

质量保证检查清单

  • 禁用 JavaScript 时内容可读。
  • 减少动效的用户看到静态内容,且无平滑滚动层。
  • 滚动触发显现仅播放一次。
  • 滚动关联场景有意使用 scrub。
  • 粘性卡片不会与页脚重叠或卡住页面。
  • 视差运动保持微妙,不影响可读性。
  • 即使图片加载缓慢,预加载器也能可靠退出。
  • ScrollTrigger.refresh() 在图片/字体/布局变化后运行。
  • 移动端具有简化的固定或性能下降时不固定。

Individual skills in this repo

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

MengTo/Skills

Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography, zoom-follow framing, ffprobe/thumbnail verification, and optional native recording compatibility checks. Use when the user asks to record or re-record browser actions, show cursor clicks and zooms, make Dribbble/UI inspiration or product demo recordings, or asks whether Codex, Playwright, or an MCP can produce a natural browser demo video.

MengTo/Skills

Generate ElevenLabs text-to-speech audio from scripts or inline text using local voice profiles. Use when the user asks for ElevenLabs, text-to-speech, TTS, narration, voiceover, speech audio, or voice generation; load voice names, voice ids, emails, owners, and account-specific defaults only from local config outside the skill.

MengTo/Skills

Profile, audit, and optimize frontend page performance with emphasis on animation work, memory-leak risks, long-session slowdowns, CSS animations, canvas/WebGL requestAnimationFrame loops, marquees, skeletons, GSAP/Three/Matter effects, timers, listeners, and observers. Use when the user asks to make animations performant, pause offscreen animations, look for memory leaks, profile pages that slow the computer over time, fix janky scrolling, reduce CPU/GPU use, or repeat the "only play in view" optimization on React/Vite/Next/frontend pages using Codex Browser.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

相关技能