Communitygithub.com

scroll-narrative

Úsalo cuando un sitio web, página de aterrizaje, producto, portafolio o caso de estudio deba contar una historia en lugar de enumerar bloques — páginas con scrollytelling, narrativa, cinematográficas, basadas en capítulos, líneas de tiempo, viajes, antes/después, o cuando una página se siente como un catálogo aburrido de secciones.

¿Qué es scroll-narrative?

Este skill está diseñado para construir páginas web que cuentan una historia a medida que el usuario se desplaza, reemplazando el diseño tradicional basado en bloques. Es ideal para marcas, pequeñas empresas, viajes, artesanía, servicios con resultados visibles, o cualquier caso donde el contenido deba sentirse como una narrativa en lugar de un catálogo. Soporta dispositivos narrativos como eje temporal, ruta, zoom, transformación, cuenta atrás o personaje. El skill guía desde la concepción de la historia (héroe, deseo, obstáculo, giro, después) hasta la estructura detallada con un "beat sheet", reglas de ritmo, pautas de contenido visual y textual, y la implementación técnica usando `storymotion.css` y `storymotion.js` junto con el skill `web-motion`. También incluye una checklist de calidad y recomendaciones para accesibilidad y rendimiento en móviles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

Preguntar en tu IA favorita

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

Documentación

Narrativa de Desplazamiento

No todos los sitios necesitan una historia. Decide primero: una narrativa completa (marcas, pequeñas empresas, viajes, lugares, artesanía, servicios con resultados visibles), una escena narrativa única (SaaS, aplicaciones: normalmente "cómo funciona"), o ninguna (tiendas, documentación, paneles, formularios: solo animación para retroalimentación, usa solo web-motion). Para parcial, aplica este skill solo a esa escena.

Un sitio narrativo es una historia que el visitante recorre con la rueda de desplazamiento. Los hechos se tejen en la trama, no se apilan como bloques de características. El movimiento (consulta el skill web-motion) es cómo pasa el tiempo en esa historia.

1. Encuentra la historia antes de cualquier código

Responde en una línea cada uno:

  • Héroe — quién o qué seguimos (el visitante, el producto, un lugar, un plato, un día).
  • Deseo — qué quieren o hacia dónde van.
  • Obstáculo — qué se interpone (el problema que resuelve el producto).
  • Giro — el momento en que las cosas cambian (el producto, la cumbre, el primer bocado).
  • Después — el mundo después del giro, y la única acción que el visitante realiza ahora.

Luego elige un dispositivo narrativo que estructure todo el desplazamiento:

DispositivoDesplazamiento significaBueno para
Eje temporalamanecer → noche, 1920 → hoy, día 1 → día 30restaurantes, eventos, historia, rutinas
Rutamoverse a lo largo de una ruta o mapaviajes, logística, expediciones, bienes raíces
Zoomciudad → calle → habitación → detallearquitectura, productos, artesanía
Transformacióncrudo → terminado, antes → despuésservicios, renovación, SaaS, fitness
Cuenta atráshacia un lanzamiento o un momento cumbrefestivales, lanzamientos, estrenos
Personajeseguir el día de una personaaplicaciones, servicios B2C

2. Escribe la hoja de ritmos

Guárdala como beats.md antes de construir. Una fila por ritmo:

#RitmoTitular (≤ 8 palabras)Cuerpo (≤ 40 palabras)Hecho entretejidoVisualMovimientoLongitud de desplazamiento

Arco estándar (6–9 ritmos):

  1. Gancho — la primera pantalla. En 3 segundos: qué es esto, el número clave, la acción principal. Sin "desplázate hacia abajo para descubrir" sin nada más.
  2. Contexto — el mundo antes; el héroe y el deseo.
  3. Viaje (2–4 ritmos) — progreso a través del dispositivo; cada ritmo lleva un hecho como punto de la trama ("a las 6 a.m. el pan ya está listo — 140 hogazas").
  4. Giro — la escena más grande: normalmente una etapa fijada (200–300 vh) avanzada mediante desplazamiento.
  5. Prueba — números, caras, reseñas, contados como el resultado de la historia.
  6. Resolución + CTA — donde aterriza la historia, y una acción clara. Repite la acción del gancho.

3. Reglas de ritmo

  • Una idea, un visual, un movimiento por ritmo.
  • Alterna denso y espaciado: después de una escena fijada, una foto calmada a sangre o una sola oración.
  • Como máximo ~3 escenas fijadas por página; cada fijación debe merecer su longitud de desplazamiento.
  • Total de página: 6–12 altos de viewport en escritorio. Más largo solo si cada pantalla aún tiene novedades.
  • El texto aparece con el momento que describe, nunca antes.
  • El visitante siempre sabe dónde está: etiqueta de capítulo + indicador de progreso.
  • El desplazamiento mismo habla la historia: el indicador usa el dispositivo narrativo como su metáfora (hora, km, escala, año, número de capítulo) y la paleta y tipografía del sitio; los capítulos se marcan en él y se nombran al pasar el ratón.

4. Contenido y artesanía

  • Las fotos son la protagonista: solo alta resolución, nítidas al 100 % de recorte; srcset responsivo.
  • Escribe como una persona, palabras llanas; sin "desatar", "elevar", "sin fisuras".
  • Los números son puntos de la trama, no una cuadrícula de estadísticas — a menos que la cuadrícula sea el clímax.
  • Cada ritmo debe sobrevivir a movimiento reducido y sin JS: sigue siendo una buena página larga.
  • Móvil no es un escritorio encogido: fijaciones más cortas (150–200 vh), etapa apilada, tipografía más grande.

5. Construcción

  1. Construye sobre storymotion.css + storymotion.js (en web-motion/assets/; escenas fijadas con --p, leyendas de paso, revelaciones, contadores, etiqueta de capítulo, indicador de desplazamiento arrastrable, cargador, idiomas, movimiento reducido) y las recetas en web-motion/references/recipes.md.
  2. Mapea cada ritmo a una sección; los ritmos fijados se convierten en .scene > .stage con leyendas [data-step]; la lógica personalizada por fotograma escucha el evento progress de la escena.
  3. Agrega movimiento según web-motion; verifica a 375 px y 1440 px con movimiento reducido activado y desactivado.

Lista de verificación antes de terminar:

  • El gancho supera la prueba de 3 segundos.
  • Cada ritmo tiene exactamente un trabajo y un hecho.
  • La historia se lee en orden con JS desactivado.
  • La etiqueta de capítulo y el indicador coinciden con la hoja de ritmos.
  • El CTA al final repite la acción del gancho.

Skills relacionados