Communitygithub.com

Narración Cinemática con Scroll

Crea páginas de aterrizaje cinematográficas impulsadas por el scroll, con desplazamiento suave de Lenis, ScrollTrigger de GSAP, progresión vinculada al scroll, revelaciones de texto escalonadas, pilas de tarjetas fijas, fondos con paralaje, transiciones cepilladas por scroll, revelaciones de pie de página y precargadores inmersivos. Úsalo al analizar o construir experiencias editoriales de scroll premium, pilas de proyectos fijas, tipografía cinética o narración sección por sección.

¿Qué es Narración Cinemática con Scroll?

Esta habilidad se centra en la creación de experiencias de narración visual impulsadas por el scroll, utilizando una combinación de Lenis para un desplazamiento suave y GSAP con ScrollTrigger para animaciones complejas vinculadas al progreso del scroll. Está diseñada para desarrolladores que buscan construir páginas de aterrizaje, portafolios o sitios editoriales de alto nivel, con un enfoque en la elegancia y la sofisticación visual, similar a la de sitios como Awwwards o Apple. La habilidad proporciona una guía completa desde la configuración inicial, pasando por efectos como revelación de texto dividido, pilas de tarjetas fijas con profundidad, fondos con paralaje y transiciones cepilladas, hasta la implementación de un precargador inmersivo. Es compatible con proyectos que utilicen GSAP, ScrollTrigger y Lenis, y ofrece tokens de movimiento, patrones de marcado y fragmentos de código JavaScript y CSS listos para usar.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Narración Cinemática con Scroll preview

Documentación

¿Qué hace Narración Cinemática con Scroll?

Cuándo Usarlo

  • Cuando una página debe sentirse como una historia editorial premium que se desarrolla mientras el usuario se desplaza.
  • El usuario menciona narración impulsada por scroll, animación vinculada al scroll, pilas de tarjetas fijas, paralaje, texto dividido, precargador o progresión cinemática.
  • Un portafolio, estudio, producto o página de aterrizaje necesita revelaciones sección por sección con profundidad en capas.
  • La implementación puede usar GSAP, ScrollTrigger y Lenis.

Vocabulario de Efectos

  • Narración impulsada por scroll: las secciones se revelan en secuencia mientras se desplaza.
  • Animación vinculada al scroll: el progreso está directamente ligado al scroll con scrub.
  • Movimiento activado por scroll: la animación comienza cuando una sección entra en el viewport.
  • Revelación escalonada: palabras, líneas, tarjetas o elementos entran con pequeños retrasos.
  • Revelación progresiva: opacidad, escala, desenfoque, recorte o cambios de posición a lo largo del progreso del scroll.
  • Pila de tarjetas fijas: las tarjetas fijas se superponen, escalan y retroceden a medida que llega la siguiente tarjeta.
  • Desplazamiento con paralaje: las capas de fondo y primer plano se mueven a diferentes velocidades.
  • Cepillado por scroll: la animación sigue la barra de desplazamiento mediante scrub: true o scrub: 1.
  • Tipografía cinética: movimiento de texto dividido enmascarado, generalmente palabra por palabra o línea por línea.
  • Precargador: pantalla de carga inicial, barra de progreso y transición de introducción.

Sensación Objetivo

  • Sitio web editorial de lujo.
  • Portafolio de estudio creativo de alta gama.
  • Pulido de movimiento al nivel de Apple.
  • Lenguaje de interacción moderno tipo Awwwards.
  • Página de aterrizaje cinematográfica e inmersiva.

Evitar:

  • Movimiento rebotante, elástico o con resorte.
  • Saltos de escala agresivos.
  • Efectos llamativos de estilo videojuego.
  • Demasiados efectos de scroll simultáneos.
  • Secuestro del scroll que hace que la página sea difícil de leer.

Pila Central

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());

Tokens de Movimiento

  • Ease de entrada: power3.out o power4.out.
  • Escenas cepilladas: ease: "none" con scrub: 0.8 a 1.4.
  • Duración de revelación de texto: 0.8s a 1.1s.
  • Duración de revelación de tarjeta: 0.9s a 1.2s.
  • Escalonamiento de palabras: 0.035s a 0.07s.
  • Escalonamiento de líneas: 0.08s a 0.14s.
  • Escalonamiento de tarjetas: 0.06s a 0.1s.
  • Desplazamiento de revelación: y: 24 a 48.
  • Desenfoque: 4px a 10px, luego 0px.
  • Profundidad de escala de tarjeta fija: 1 hasta 0.92.

Anatomía de la Página

  1. Precargador: pantalla negra, barra de progreso, marca/título, desvanecimiento de introducción.
  2. Hero: paralaje de imagen, revelación de titular enmascarado, sutil señal de scroll.
  3. Introducción: tipografía cinética palabra por palabra.
  4. Secciones de la historia: revelaciones de desvanecimiento, desenfoque y recorte activadas por scroll.
  5. Proyectos recientes: pila de tarjetas fijas con escala y profundidad en capas.
  6. Galería o prueba: revelaciones horizontales o progresivas cepilladas por scroll.
  7. Pie de página: revelación con paralaje o transición ascendente lenta.

Patrón de Marcado

<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>Diseño que se despliega con moderación cinemática.</h1>
  </section>

  <section data-story-section>
    <p data-split-reveal="words">Cada bloque llega con intención silenciosa.</p>
  </section>

  <section class="project-stack" data-sticky-stack>
    <article data-stack-card>Proyecto Uno</article>
    <article data-stack-card>Proyecto Dos</article>
    <article data-stack-card>Proyecto Tres</article>
  </section>

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

Secuencia del Precargador

Usa un precargador para establecer el tono cinemático y luego hacer la transición a la revelación del hero.

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");
  });
}

Revelación de Texto Dividido

Usa contenedores de desbordamiento enmascarados. Evita dividir texto que contenga enlaces o marcado en línea significativo.

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;
}

Revelaciones Activadas por Scroll

Úsalas para secciones normales. Deben reproducirse una vez y sentirse compuestas, no nerviosas.

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,
        },
      }
    );
  });
}

Progresión Vinculada al Scroll

Usa líneas de tiempo cepilladas para la progresión cinemática. Mantén la animación cepillada lineal y deja que la posición del scroll haga la temporización.

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);
  });
}

Pila de Tarjetas Fijas

Usa position: sticky para el diseño y ScrollTrigger para la escala/profundidad en capas. Las tarjetas anteriores deben retroceder a medida que llegan las siguientes.

[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,
        },
      });
    });
  });
}

Paralaje

Usa paralaje para imágenes de héroe, capas de fondo y revelaciones de pie de página. Mantén la distancia pequeña.

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,
      },
    });
  });
}

Revelación de pie de página con paralaje:

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,
      },
    }
  );
}

Orden de Construcción

  1. Construir la página estática primero.
  2. Agregar precargador y entrada del hero.
  3. Agregar revelaciones de texto dividido.
  4. Agregar revelaciones sección por sección.
  5. Agregar progresión de pila de tarjetas fijas.
  6. Agregar capas de paralaje.
  7. Agregar escenas fijas cepilladas solo donde la historia las necesite.
  8. Agregar fallbacks de movimiento reducido y táctiles.
  9. Ejecutar QA del navegador en escritorio y móvil.

Plantilla de Prompt

Crea una página de aterrizaje cinematográfica impulsada por el scroll con desplazamiento suave de Lenis, animaciones GSAP ScrollTrigger, revelaciones de texto escalonadas, progresión de pila de tarjetas fijas, fondos con paralaje, transiciones cepilladas por scroll, narración sección por sección y una animación de precargador inmersiva. Usa profundidad en capas, transiciones de escala, cambios progresivos de opacidad y movimiento suave activado por viewport para una experiencia editorial premium.

Lista de Verificación QA

  • El contenido es legible con JavaScript deshabilitado.
  • Los usuarios con movimiento reducido ven contenido estático y sin capa de desplazamiento suave.
  • Las revelaciones activadas por scroll se reproducen una vez.
  • Las escenas vinculadas al scroll usan scrub intencionalmente.
  • Las tarjetas fijas no se superponen al pie de página ni bloquean la página.
  • El movimiento de paralaje se mantiene sutil y no perjudica la legibilidad.
  • El precargador sale de manera confiable incluso si las imágenes cargan lentamente.
  • ScrollTrigger.refresh() se ejecuta después de cambios de diseño, imágenes y fuentes.
  • En móvil, el anclaje se simplifica o se elimina si el rendimiento baja.

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.

Skills relacionados