Página de Aterrizaje Parallax
Convierte un video corto en una página de aterrizaje cinemática de una sola pantalla donde el gesto de desplazamiento del usuario avanza el video 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.
Esta habilidad codifica los patrones probados en la referencia incluida en ../../examples/parasites/ (las páginas de aterrizaje github / lion / hope — tres páginas funcionales construidas con esta misma habilidad). Trata esa carpeta como la verdad definitiva si algo aquí es ambiguo.
Dónde se sitúa esta habilidad en la pirámide de YUV.AI
parallax-landing-page está en el nivel medio de la pirámide de habilidades de YUV.AI, junto a yuv-design-system, yuv-decks, yuv-viral-video y video-to-landing-page. El orquestador de nivel superior yuv-pilot enruta aquí cada vez que un clip de video de 5–15 segundos necesita convertirse en una página de aterrizaje de desplazamiento y scrubbing de una sola pantalla.
Esta habilidad trae su propio lenguaje visual (Anton + Caveat + Inter, paleta de acentos dorado/á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 las páginas de aterrizaje parallax de YUV.AI, puedes OPCIONALMENTE agregar una marca de agua de fénix + la URL canónica de Linktree en el área del pie de página como un hilo conductor 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 la apariencia característica.
Lo que estás construyendo
Cada página de aterrizaje es un viewport bloqueado con:
- Un lienzo que llena la pantalla, dibujando un fotograma a la vez (cover-fit, DPR ≤ 2)
- 5 escenas de texto posicionadas absolutamente (kicker + titular Anton mayúsculas + línea manuscrita Caveat), cada una con su propia ventana de progreso de desplazamiento
- Una navegación fija con el logo
PARALLAX // showcasey enlaces a las páginas hermanas - Un cargador que precarga cada fotograma antes de permitir la interacción del usuario
- Una viñeta + superposición de grano de película
- Una sugerencia de desplazamiento en la parte inferior que se desvanece cuando el usuario comienza a desplazarse
- Un contador de fotogramas en la parte inferior derecha (ej.
073 / 145) - Una escena final que es la sección CTA — sin una sección
.endseparada debajo
Peso total a 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
Valor predeterminado: ~/Documents/yuv-projects/landings/<slug>/ — guarda siempre las páginas de aterrizaje independientes aquí para que puedas encontrarlas 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 examples/parasites/ existente).
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# La habilidad crea <slug>/ aquí a medida que extrae fotogramas y construye el HTML.
Ruta final (Modo A — independiente): ~/Documents/yuv-projects/landings/<slug>/.
Ruta final (Modo B — integrar): el directorio showcase existente que el usuario eligió.
Informa al usuario de la ruta final al final de cada construcción.
Flujo de trabajo
Hay cuatro fases. No omitas fases — cada una alimenta a la siguiente.
Fase 1 — Descubrir
Confirma con el usuario:
- Ruta del video — dónde está el archivo MP4 fuente.
- Slug — nombre corto de carpeta/archivo (ej.
hope,marcus,desk). Una palabra, minúsculas, sin espacios. Este se convierte tanto en el nombre de la carpeta de fotogramas (<slug>/) como en el nombre del archivo HTML (<slug>.html). - Tema / tópico — ¿de qué trata esta página de aterrizaje? ¿Un lanzamiento de producto? ¿Un momento personal? ¿Un encuentro con la vida silvestre? 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 "agrégalo al showcase", se refiere al Modo B a continuación. - Color de acento — para el resaltado de script/CTA:
gold(#f5b042),amber(#ff8a3d),accent(rosa #ff4d6d),cream(#f5e9d4), o algo nuevo (agrégalo a:rooten style.css y escribe una nueva regla.script.<nombre>).
Si el usuario no ha especificado algunos de estos, propón valores predeterminados 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 a resolución nativa con -q:v 2 (JPEG casi sin pérdida), nombrándolos frame-001.jpg hasta frame-NNN.jpg (relleno 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 a q:v 2 da ~120–220 KB/fotograma en las mismas dimensiones — visiblemente más nítido. No reduzcas la escala; nunca la aumentes (infla los archivos sin agregar 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 duraciones de clips. 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 — Redactar 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> del 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 rellenado con ceros | 121 |
{{PREVIEW_FRAME_END}} | último fotograma rellenado con 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 abajo |
{{SCENE_N_*}} | kicker, 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 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 cinemático (fraseo del kicker, longitud del titular, tono de la línea manuscrita). El texto es donde esta habilidad se gana su reputación — un texto genérico hundirá una animación por lo demás hermosa.
Fase 4 — Vincular activos
Si la carpeta de destino ya tiene style.css y parallax.js (integración de showcase), no hagas nada — son compartidos. De lo contrario, cópialos 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 sigue los pasos en references/showcase-integration.md — agrega una tarjeta a index.html, agrega un enlace a la barra de navegación de cada página de aterrizaje existente y encadena el CTA en la escena final de la página de aterrizaje anterior.
Informa al usuario cómo ver:
Abre
<target>/<slug>.htmlmediantepython -m http.server 8000desde la carpeta principal (nofile://— Chromium puede contaminar el lienzo con orígenes de imágenes locales).
Contrato de archivos
<target>/
├── <slug>/ # carpeta de fotogramas
│ ├── <slug>.mp4 # el video fuente (conservado)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # la página de aterrizaje
├── style.css # compartido (copiar si es independiente)
├── parallax.js # compartido (copiar si es independiente)
└── index.html # el centro (solo si es independiente o integración)
El nombre de la carpeta de fotogramas y el nombre base 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 la redefinas)
new ParallaxPage({
folder: '<slug>', // carpeta que contiene frame-001.jpg, etc.
frameCount: 145, // número entero
prefix: 'frame-', // siempre 'frame-' para esta habilidad
scrollBudget: 4200, // píxeles de entrada acumulada para un pase completo
// opcional: padWidth (predeterminado 3), ext (predeterminado 'jpg')
})
La clase auto-asigna 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 (lo no negociable)
Estos están integrados 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 compases. El héroe (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 predeterminado de 0.25. - Sin sección
.enddebajo del scrub. La escena final contiene los CTA. Toda la página es un viewport bloqueado. - Anton + Caveat + Inter — Anton mayúsculas para todo lo negrita, Caveat para acentos manuscritos (dorado/ámbar/crema), Inter para cualquier texto principal. Nunca sustituyas, nunca agregues 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 buscar 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 resultado diverge visiblemente de esos, te has desviado; relee. 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 agregar a un centro existente.assets/landing-page-template.html— la estructura canónica con marcadores de posición.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. - Redacta
desk.htmldesde la plantilla. La navegación tiene solo un enlace: ella misma. - Hecho. Dile al usuario que sirva con
python -m http.server.
Agregar al showcase: el usuario agrega hope.mp4 a la carpeta existente de parásitos.
- Slug =
hope. Extrae →hope/frame-NNN.jpg. (Reutiliza style.css + parallax.js existentes). - Redacta
hope.htmldesde la plantilla. - Ejecuta la integración del showcase: agrega una tercera tarjeta a
index.html, agrega un enlaceHopea la barra de navegación engithub.htmlylion.html, encadena la escena final de la página de aterrizaje anterior con un CTANext: Hope →. - Si se introduce un nuevo color de acento, agrégalo a
:rooty agrega reglas.script.X+.cta.Xenstyle.css.