Página de Aterrizaje con Paralaje
Convierte un video corto en una página de aterrizaje cinemática de una sola pantalla donde el desplazamiento del usuario avanza fotograma a fotograma mientras cinco escenas de texto dramático se funden. El documento nunca se desplaza realmente: la entrada de rueda/táctil/teclado se intercepta en JS y se convierte en progreso virtual de fotogramas.
Este skill codifica los patrones probados en la referencia incluida en ../../examples/parasites/ (los landings de github / lion / hope — tres páginas funcionales construidas con este mismo skill). Trata esa carpeta como la fuente de verdad si algo aquí es ambiguo.
Dónde se sitúa este skill en la pirámide de YUV.AI
parallax-landing-page está en el nivel medio de la pirámide de skills de YUV.AI, junto con yuv-design-system, yuv-decks, yuv-viral-video y video-to-landing-page. El orquestador de nivel superior yuv-pilot enruta aquí siempre que un clip de video de 5–15 segundos deba convertirse en un landing de un solo héroe con scroll scrub.
Este skill trae su propio lenguaje visual (Anton + Caveat + Inter, paleta de colores oro/ámbar/acento/crema) — NO llama a yuv-design-system. Los dos sistemas coexisten: yuv-design-system posee la paleta de marca en superficies web/app/presentación; parallax-landing-page posee la estética cinemática de scroll scrub específicamente. Para los landings de paralaje de YUV.AI, puedes añadir OPCIONALMENTE una marca de agua de fénix + la URL canónica de Linktree en el área del pie como un hilo de marca — consulta yuv-design-system/assets/ para el archivo de la marca de agua. NO intercambies la pila de tipos Anton/Caveat por la paleta Neon del sistema de diseño — eso perdería el aspecto característico.
Lo que estás construyendo
Cada landing es una única ventana gráfica bloqueada con:
- Un lienzo que llena la pantalla, dibujando un fotograma a la vez (cover-fit, DPR ≤ 2)
- 5 escenas de texto posicionadas absolutamente (entradilla + titular Anton en mayúsculas + línea manuscrita Caveat), cada una con su propia ventana de progreso de desplazamiento
- Una navegación fija con el logotipo
PARALLAX // showcasey enlaces a landings hermanos - Un cargador que precarga cada fotograma antes de permitir la interacción
- Una viñeta + superposición de grano de película
- Una pista de desplazamiento inferior que se desvanece cuando el usuario comienza a desplazarse
- Un contador de fotogramas en la esquina inferior derecha (p.ej.
073 / 145) - Una escena final que es la sección CTA — no hay una sección
.endseparada debajo
Peso total con q:v 2: aproximadamente 120–220 KB por fotograma × número de fotogramas. Un clip de 6 segundos a 24 fps = 145 fotogramas ≈ 25 MB. Un clip de 10 segundos = 241 fotogramas ≈ 53 MB.
Ubicación de guardado
Por defecto: ~/Documents/yuv-projects/landings/<slug>/ — guarda siempre los landings independientes aquí para que puedas encontrarlos de nuevo. Sobrescribe solo si el usuario elige explícitamente una ubicación diferente O si se selecciona el Modo B (integrar en el showcase existente examples/parasites/).
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# El skill crea <slug>/ aquí mientras extrae fotogramas y construye el HTML.
Ruta final (Modo A — independiente): ~/Documents/yuv-projects/landings/<slug>/.
Ruta final (Modo B — integración): el directorio de showcase existente que el usuario eligió.
Indica al usuario la ruta final al final de cada construcción.
Flujo de trabajo
Hay cuatro fases. No te saltes fases — cada una alimenta la siguiente.
Fase 1 — Descubrimiento
Confirma con el usuario:
- Ruta del video — dónde está el MP4 fuente.
- Slug — nombre corto de carpeta/archivo (p.ej.
hope,marcus,desk). Una palabra, minúsculas, sin espacios. Esto se convierte tanto en el nombre de la carpeta de fotogramas (<slug>/) como en el nombre del archivo HTML (<slug>.html). - Tema / asunto — ¿de qué trata este landing? ¿Un lanzamiento de producto? ¿Un momento personal? ¿Un encuentro con la naturaleza? Necesitas esto para escribir el texto.
- Modo de proyecto — independiente (carpeta nueva) o integrar en el showcase existente de parásitos en
examples/parasites/(parte superior de este repositorio). Si el usuario dice "añádelo al showcase", se refiere al Modo B a continuación. - Color de acento — para el script/destacado CTA:
gold(#f5b042),amber(#ff8a3d),accent(rosa #ff4d6d),cream(#f5e9d4), o algo nuevo (añádelo a:rooten style.css y escribe una nueva regla.script.<nombre>).
Si el usuario no ha especificado algunos de estos, propón valores por defecto y continúa — no te detengas en preguntas que puedan responder una vez que vean el resultado.
Fase 2 — Extraer fotogramas
Ejecuta el script de extracción incluido. Analiza el video con ffprobe y extrae cada fotograma en resolución nativa con -q:v 2 (JPEG casi sin pérdida), nombrándolos frame-001.jpg hasta frame-NNN.jpg (relleno de ceros de 3 dígitos).
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
Ejemplo:
python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
C:/Users/User/Documents/parasites/hope/hope.mp4 \
C:/Users/User/Documents/parasites/hope
El script imprime un bloque de metadatos JSON en stdout. Captúralo — necesitas frame_count y suggested_scroll_budget para el HTML.
Por qué -q:v 2: ezgif y herramientas similares re-comprimen agresivamente (~55 KB/fotograma). ffmpeg nativo con q:v 2 da ~120–220 KB/fotograma en las mismas dimensiones — visiblemente más nítido. No reduzcas la escala; nunca aumentes la escala (infla los archivos sin añadir detalle).
Por qué la fórmula del presupuesto de desplazamiento (≈26 px por fotograma): mantiene constante la sensación táctil de "píxeles de desplazamiento por fotograma avanzado" en todas las longitudes de clip. 145 fotogramas → ~4200, 241 fotogramas → ~6300, 90 fotogramas → ~2500 (mínimo). El script lo calcula por ti y lo limita a [2500, 8000].
Fase 3 — Crear la página
Lee la plantilla en <skill>/assets/landing-page-template.html. Es un archivo funcional completo con marcadores {{PLACEHOLDER}} y comentarios <!-- TODO: --> junto a las partes creativas. Escribe un nuevo archivo en <target>/<slug>.html con todo sustituido.
Lista de verificación de sustituciones (cada marcador debe ser reemplazado):
| Marcador | Qué poner | Ejemplo |
|---|---|---|
{{PAGE_TITLE}} | <title> HTML | Hope — The Fastest Heart in the Negev |
{{PAGE_DESCRIPTION}} | meta descripción, una frase | A moment with Hope, the cheetah of Midbarium. |
{{SLUG}} | nombre de carpeta (sin ruta, sin barra) | hope |
{{FRAME_COUNT}} | número entero de fotogramas | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN con ancho coincidente | 001 / 241 |
{{SCROLL_BUDGET}} | entero del JSON del extractor | 6300 |
{{PREVIEW_FRAME_MID}} | fotograma medio con relleno de ceros | 121 |
{{PREVIEW_FRAME_END}} | último fotograma con relleno de ceros | 241 |
{{LOADER_TITLE}} | una palabra, mayúsculas | HOPE |
{{LOADER_SCRIPT}} | línea manuscrita que termina en … | summoning the runner… |
{{NAV_LINKS_HTML}} | bloque completo de etiquetas <a> para la navegación | ver más abajo |
{{SCENE_N_*}} | entradilla, titular, línea manuscrita para cada una de las 5 escenas | ver guía de texto |
{{SCROLL_HINT_TEXT}} | indicación en mayúsculas de 2–4 palabras | SCROLL TO RUN |
{{CTA_BUTTONS_HTML}} | 2–4 etiquetas <a class="cta"> | ver más abajo |
{{ACCENT_CLASS}} | sufijo de color de acento para .script.X y .cta.X | amber |
Lee references/copy-guide.md para los patrones de texto cinematográfico (fraseo de la entradilla, longitud del titular, tono de la línea manuscrita). El texto es donde este skill se gana el pan — un texto genérico hundirá una animación por lo demás hermosa.
Fase 4 — Vincular los recursos
Si la carpeta de destino ya tiene style.css y parallax.js (integración en showcase), no hagas nada — están compartidos. De lo contrario, copia ambos desde <skill>/assets/ a la carpeta de destino:
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
Si se integra en un showcase existente, también haz los pasos en references/showcase-integration.md — añade una tarjeta a index.html, añade un enlace a cada landing existente en la barra de navegación, y añade el CTA de cadena en la escena final del landing anterior.
Indica al usuario cómo verlo:
Abre
<target>/<slug>.htmlmediantepython -m http.server 8000desde la carpeta padre (nofile://— Chromium puede contaminar el lienzo con orígenes de imagen locales).
Contrato de archivos
<target>/
├── <slug>/ # carpeta de fotogramas
│ ├── <slug>.mp4 # el fuente (conservado)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # la página de aterrizaje
├── style.css # compartido (copia si es independiente)
├── parallax.js # compartido (copia si es independiente)
└── index.html # el centro (solo si es independiente o integración)
El nombre de la carpeta de fotogramas y el nombre del archivo HTML DEBEN compartir el mismo slug — la opción folder en la llamada new ParallaxPage({folder: '<slug>', ...}) de la página es la ruta literal de la carpeta.
La API de ParallaxPage (ya está en parallax.js, no redefinir)
new ParallaxPage({
folder: '<slug>', // carpeta que contiene frame-001.jpg, etc.
frameCount: 145, // entero
prefix: 'frame-', // siempre 'frame-' para este skill
scrollBudget: 4200, // píxeles de entrada acumulada para un pase completo
// opcional: padWidth (por defecto 3), ext (por defecto 'jpg')
})
La clase auto-agrega body.scrub-page (que bloquea el desplazamiento mediante CSS), precarga todos los fotogramas, ejecuta un lerp impulsado por RAF (factor 0.22) hacia el fotograma objetivo derivado del desplazamiento, y funde las escenas cuyos rangos data-start/data-end incluyen el progreso actual.
Restricciones estrictas (los no negociables)
Están incorporadas en la referencia y rompen la experiencia si se violan:
- 5 escenas, ventanas de progreso fijas:
0.00–0.20,0.22–0.40,0.42–0.60,0.62–0.80,0.82–1.00. El espacio de 0.02 entre escenas es intencional — es un momento de "solo la imagen, sin texto" entre los compases. La heroína (escena 1) y la final (escena 5) usandata-fade="0.30"ydata-fade="0.18"respectivamente para que se mantengan más tiempo en los bordes; las escenas intermedias usan el valor por defecto 0.25. - Sin sección
.enddebajo del scrub. La escena final contiene los CTAs. Toda la página es una única ventana gráfica bloqueada. - Anton + Caveat + Inter — Anton en mayúsculas para todo lo negrita, Caveat para acentos manuscritos (oro/ámbar/crema), Inter para cualquier texto de cuerpo principal. Nunca sustituyas, nunca añadas una cuarta fuente.
- Blanco roto
#f5f1ea, nunca#fff— ya está en CSS comovar(--text). - Los nombres de los fotogramas son
frame-NNN.jpgrellenados con ceros al ancho del total (3 dígitos es el estándar ya que los clips tienen menos de 1000 fotogramas; el JS calcula automáticamente el ancho del contador a partir del total). - El slug es el nombre de la carpeta Y el nombre base del archivo HTML —
hope/,hope.html. Sin excepciones; los pasos de integración asumen esto.
Dónde mirar cuando te atasques
- El showcase de referencia incluido en este repositorio:
examples/parasites/— github.html, lion.html, hope.html, style.css, parallax.js, index.html. Si tu salida diverge visiblemente de esas, te has desviado; vuelve a leer. references/copy-guide.md— cómo escribir las 5 escenas para que realmente se sientan cinematográficas.references/showcase-integration.md— ediciones exactas necesarias al añadir a un centro existente.assets/landing-page-template.html— la estructura canónica con marcadores.assets/hub-template.html— solo se usa al crear un showcase completamente nuevo (3 tarjetas desde cero).
Dos ejemplos reales de invocación
Independiente: el usuario tiene un solo clip desk.mp4 y quiere una página de aterrizaje.
- Pregunta por el slug + tema. Ejecuta el extractor en
desk.mp4→./desk/frame-NNN.jpg. - Copia
style.css+parallax.jsa la raíz del proyecto. - Crea
desk.htmla partir de la plantilla. La navegación tiene solo un enlace: a sí misma. - Hecho. Indica al usuario que lo sirva con
python -m http.server.
Añadir a showcase: el usuario añade hope.mp4 a la carpeta existente de parásitos.
- Slug =
hope. Extrae →hope/frame-NNN.jpg. (Reutiliza style.css + parallax.js existentes). - Crea
hope.htmla partir de la plantilla. - Ejecuta la integración del showcase: añade una tercera tarjeta a
index.html, agrega un enlaceHopea la barra de navegación engithub.htmlylion.html, encadena la escena final del landing anterior con un CTANext: Hope →. - Si introduces un nuevo color de acento, añádelo a
:rooty añade reglas.script.X+.cta.Xenstyle.css.