Communitygithub.com

Im-Fran/landing-skills

Úsalo para añadir animaciones, efectos de scroll, paralaje, transiciones de página, interacciones de hover o cursor, 3D, WebGL, shaders o partículas a una página de aterrizaje, o al elegir entre GSAP, Motion, Lenis, Three.js, React Three Fiber, Rive o Lottie.

¿Qué es landing-skills?

Esta skill está diseñada para añadir movimiento y 3D a páginas de aterrizaje que ya funcionan sin ellos. Cada efecto añadido debe tener un propósito declarado, una variante de movimiento reducido y un fallback que deje la página completa. La skill se basa en inputs como `landing/direction.md` (que define la intención de movimiento) y la página estática construida por `landing-skills:landing-build`. Soporta plataformas como React (Vite, Next) y HTML/CSS/JavaScript plano, y elige automáticamente la variante correcta según el stack detectado en `package.json`. Los efectos cubiertos incluyen entradas de héroe, texto dividido, scroll progresivo, paralaje, interacciones (hover, presión, formularios), objetos 3D, WebGL, shaders y partículas. La skill prioriza CSS y scripts pequeños sobre librerías grandes, y proporciona recetas detalladas para cada caso, junto con reglas de seguridad que garantizan que la página funcione sin JavaScript, con movimiento reducido y con WebGL desactivado.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-motion

Preguntar en tu IA favorita

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

Documentación

Landing motion

Añade movimiento y 3D a una página de aterrizaje que ya funciona sin ellos. Cada efecto que añadas debe tener un propósito declarado, una variante de movimiento reducido y un fallback que deje la página completa. La página antes de empezar es el fallback: si un script falla, un navegador carece de una funcionalidad o el visitante solicita menos movimiento, obtiene esa página, no una en blanco.

Entradas

  1. landing/direction.md, sección Intención de movimiento y 3D. Este es el resumen de tu trabajo. Indica ninguno, o nombra cada momento y para qué sirve. Implementa lo que nombra. No añadas momentos que no nombre.
  2. La página estática construida por landing-skills:landing-build, o cualquier página existente. Debe mostrar todo el texto y la acción de conversión con JavaScript desactivado. Verifica eso primero: si no lo hace, arréglalo antes de añadir movimiento, porque cada receta aquí asume que la página estática es el fallback.
  3. landing/tokens.css si está presente. Usa sus colores en los shaders y fallbacks. Pon los tokens de movimiento (duraciones, easing) en tu propia hoja de estilo; deja tokens.css como lo escribió la dirección de arte.

Cuando falta una entrada:

  • Sin direction.md: pregunta al usuario qué debería moverse y por qué. Si no puedes preguntar, el valor predeterminado es ninguno (ver "Decidir qué se mueve"); dilo en tu resumen.
  • Sin página estática: detente y construye una primero (landing-skills:landing-build), o pídela. El movimiento superpuesto en una página que solo existe en JavaScript es cómo una escena 3D fallida arrastra consigo el titular y la llamada a la acción.
  • El stack: lee package.json. React (Vite, Next) obtiene las variantes de React donde una receta las tiene; todo lo demás obtiene la variante de HTML, CSS y JavaScript plano. Una aplicación React solo de cliente (todo renderizado en un #root vacío) falla la verificación sin JavaScript por construcción: el texto debe estar en el HTML primero, mediante renderizado del servidor, prerenderizado o el patrón isla en references/webgl-3d.md.

Decidir qué se mueve

Empieza desde la intención en direction.md. Escribe, para cada momento que nombre: el elemento, el rol (entrada, retroalimentación, vinculado al scroll, ambiental o 3D interactivo) y qué aprende el visitante de él. Si no puedes terminar esa frase, elimina el momento.

ninguno es una respuesta válida, a menudo la correcta, y el valor predeterminado cuando la intención falta. Muchas páginas están completas sin movimiento más allá de estados de retroalimentación, especialmente cuando las fotografías o el texto las sostienen; una página con casi ningún movimiento no pierde nada por ello.

Bajo ninguno esto es una verificación corta, no un trabajo nuevo. landing-skills:landing-build ya escribe estados hover, focus, presión y deshabilitado y un script de formulario con estados de envío, éxito y error. Abre la página en un navegador y confirma cuatro cosas:

  1. Tabulación muestra un anillo de enfoque visible en cada enlace, botón y campo.
  2. Los estados hover y presión responden en botones y enlaces.
  3. Después de enviar un formulario, aparece el mensaje de estado y toma el foco (references/interaction.md, "Retroalimentación de envío de formulario", añade esto si falta).
  4. Nada se mueve por sí solo: sin reproducción automática, sin bucle, sin revelación.

Opcionalmente, añade temporización a los estados hover y presión (references/interaction.md, "Estados hover y presión"). Luego detente. Si no pudiste abrir un navegador, dilo y enumera cada uno de los cuatro como "no ejecutado"; no informes la página como verificada.

Cuando la intención nombra momentos:

  • Un momento emblemático por página. La secuencia del héroe, la demostración del producto, el objeto 3D. Todo lo demás es más silencioso que él.
  • Varía por rol, nunca por sección. La retroalimentación es rápida (100 a 200 ms), las entradas son más lentas, el movimiento vinculado al scroll sigue el scroll. Aplicar el mismo fade-up, easing y stagger a cada sección es el patrón de página generada más reconocible, y no enseña nada al visitante.
  • La mayor parte del contenido no se mueve. El texto que el visitante está leyendo nunca se mueve: sin paralaje en párrafos, sin revelación que oculte un bloque hasta que se desplace hacia él.
  • Demuestra, no decores. El movimiento que muestra cómo funciona el producto (una secuencia de estados, una vista explosionada, un antes y después) vale su costo. El movimiento que solo dice "esta página está animada" no lo vale.

Lee references/foundations.md antes de escribir cualquier movimiento. Contiene las duraciones, easing y la lista de patrones que se leen como generados, cada uno con qué hacer en su lugar.

Ajustar recetas a la página

Las recetas se adjuntan a la página que existe; no la reestilizan.

  • La página estática de landing-skills:landing-build deja un sustituto para cada momento que la dirección nombra: una imagen de póster o un marcador de posición etiquetado en su tamaño final. Marca ese elemento con data-moment="<nombre>" (el nombre de Intención de movimiento y 3D) si la construcción no lo ha hecho, y adjunta la receta a él: añade la clase contenedora de la receta a ese elemento, o selecciónalo por el atributo.
  • Cada sección de Código de una receta comienza con una línea que nombra las clases que añade, como nuevas para esta skill, y las clases de la construcción que usa sin cambios. Añade las nuevas clases; nunca redefin las propias de la construcción (.hero, .hero__title, .button, .section, .split, y el resto). Donde una receta necesite un diseño que el elemento de la construcción no tiene, envuélvelo en un nuevo elemento propio.
  • Usa los tokens de la construcción (--color-*, --space-*, --radius-control) para cualquier color o tamaño que necesite una receta, nunca un nuevo valor literal.

Elegir una receta

Elige el escalón más bajo que produzca el efecto: CSS, luego un script pequeño, luego GSAP o Motion, luego WebGL. Cada receta tiene Usar cuando, Evitar cuando, Código, Movimiento reducido y Costo; las recetas 3D añaden Fallback.

NecesidadLeer
Duraciones, easing, springs, stagger, qué se lee como generadoreferences/foundations.md
Entrada de héroe, titular de texto dividido, revelación con clip-path o máscara, contadorreferences/entrances-text.md
Progreso de scroll, entrada vinculada al scroll, narración fija, secciones fijadas o horizontales, scroll suavereferences/scroll.md
Capas de profundidad en scroll, profundidad de puntero, paralaje de imagen o video, paralaje en Reactreferences/parallax.md
Temporización de hover y presión, retroalimentación de envío de formulario, botón magnético, seguidor de cursor, inclinación, arrastre, dial escalonado, transiciones de vistareferences/interaction.md
Objeto 3D para rotar, vista explosionada en scroll, un contexto para dos etapas separadas, modelo glTF, isla de React Three Fiberreferences/webgl-3d.md
Qué importar y omitir, archivos de decodificador no utilizados en la construcción, hacer pósters, compresión de modelos y texturasreferences/webgl-assets.md
Ruta de cámara impulsada por scroll, fondo de shader, partículas, distorsión de imagen, WebGPUreferences/webgl-effects.md
Qué biblioteca, su licencia y tamaño, cuándo CSS es suficientereferences/libraries.md
Variantes de movimiento reducido, fallback de WebGL, pausa, presupuestos, proteger el héroereferences/safety.md

Para cualquier trabajo 3D o WebGL, lee primero references/safety.md (las recetas de escena importan sus ayudantes), luego "Antes de cualquier escena" en references/webgl-3d.md, luego solo la receta que necesitas.

Barreras de seguridad

Estas se aplican a todos los efectos. references/safety.md tiene el código.

  1. El héroe se pinta sin JavaScript. El titular, el lead y la llamada a la acción están en el HTML y son visibles en la primera pintura. No inicies el titular o la imagen del héroe con opacidad 0: un elemento con opacidad 0 no es candidato a Largest Contentful Paint hasta que se muestre, por lo que una entrada larga retrasa LCP. Carga el código 3D después del evento load, con una imagen de póster en su lugar hasta que se dibuje el primer fotograma.
  2. Reduce, no elimines. La propia declaración de la dirección sobre movimiento reducido gana; lo que sigue es el valor predeterminado. Bajo prefers-reduced-motion: reduce, elimina paralaje, animación de scroll borroso, bucles de reproducción automática y gran desplazamiento. Mantén la retroalimentación y los fundidos cortos. Una escena 3D se carga solo si es estática y controlada por el usuario; saltarla y mostrar los pósters es la opción correcta más simple. Escribe la variante reducida por efecto, y escucha el cambio de preferencia mientras la página está abierta. Una regla global que pone a cero la duración de cada animación es en sí misma una señal reconocida.
  3. WebGL es opcional. Verifica un contexto antes de descargar cualquier código 3D. En React, envuelve el canvas en un límite de error. Maneja la pérdida de contexto. El fallback es una imagen real, nunca un cuadro vacío.
  4. Un solo canvas. Un segundo contexto WebGL duplica la memoria y el trabajo de GPU. Pon los momentos 3D relacionados en un canvas fijo.
  5. Nada se ejecuta fuera de pantalla. Los canvases, videos y bucles se detienen cuando están fuera de vista o cuando la pestaña está oculta.
  6. El scroll nunca vuelve a renderizar un framework. Lee la posición de scroll en el bucle de fotogramas o deja que CSS lo maneje. Sin setState por evento de scroll o por fotograma.
  7. Anima solo transform y opacity. Nunca top, left, width, o height.
  8. Autoalojamiento de cada recurso. Los modelos, decodificadores, mapas de entorno y fuentes provienen de tu origen. Algunos ayudantes usan CDNs de terceros por defecto; anúlalos.
  9. La interacción tiene una ruta de teclado. Cualquier cosa que el puntero pueda rotar, arrastrar o alternar, el teclado también puede hacerlo.

Definición de terminado

Verifica cada elemento en un navegador. Una herramienta de navegador es lo mejor; sin una, usa el script de captura de landing-skills:landing-review para capturas de pantalla y di qué verificaciones no pudiste hacer.

  • Cada momento nombrado en Intención de movimiento y 3D existe, y no se añadió nada más allá de los estados de retroalimentación.
  • Con JavaScript desactivado: todo el texto y la acción de conversión están presentes.
  • Con movimiento reducido emulado: la página está completa y legible, nada se reproduce automáticamente, sin paralaje, sin borroso; los estados de retroalimentación aún responden.
  • Con WebGL desactivado (indicador de Chromium --disable-webgl): el póster o la imagen estática se muestra donde estaría la escena, y el texto del héroe y la llamada a la acción no se ven afectados.
  • El texto del héroe es visible antes de que se haya cargado cualquier código 3D (limita la red para verificar).
  • Ninguna sección comparte la misma animación de entrada por defecto; el momento emblemático es el único grande.
  • Los canvases dejan de dibujar cuando se desplazan fuera de vista (panel de Rendimiento, o un contador de llamadas de dibujo como en references/safety.md).
  • El panel de red no muestra ninguna solicitud a un host de terceros para recursos 3D.
  • En una compilación de producción, three.js y otro código 3D están en un fragmento que no forma parte del paquete de entrada.
  • Teclado: cada rotación, arrastre y alternancia funciona con teclas; el foco se mantiene visible.

El detector de señales detect-tells.mjs pertenece a landing-skills:landing-review y es una ayuda opcional. Si está disponible, ejecútalo en la página; marca señales a nivel de patrón como atributos de revelación estándar y el interruptor de eliminación de movimiento reducido. La verificación requerida es visual: desplaza toda la página una vez con movimiento activado y una vez con movimiento reducido, y confirma que cada cosa en movimiento tiene el rol que escribiste para ella.

Termina con un breve resumen para el usuario: cada momento añadido y su propósito, bibliotecas añadidas con sus licencias, los recursos aún necesarios (por ejemplo, un modelo real para reemplazar un sustituto primitivo, una imagen de póster) y cualquier verificación que no pudiste ejecutar.

Individual skills in this repo

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

Skills relacionados