Página principal animada
El producto final es un sitio web estático (HTML/CSS/JS, sin compilación) compuesto por tres capas:
- Escenario del personaje: Lienzo a pantalla completa que muestra fotogramas de un personaje generado por IA. En la pantalla de inicio reproduce fotogramas de un "bucle de seguimiento visual" según la dirección del cursor; al desplazarse a otra sección, reproduce un "clip de transición" entre las dos secciones, sincronizando el progreso del scroll con la reproducción. En modo vertical móvil, el personaje se sitúa en la mitad superior de la pantalla.
- Secciones de contenido: Pantalla de inicio / Currículum / Portafolio / Trabajos destacados / Final. El texto se superpone sobre el escenario, evitando el lado donde se encuentra el personaje.
- Decoración y efectos dibujados a mano: Garabatos (que aparecen con un trazo inicial y luego vibran como animación dibujada a mano), manchas de color que se deforman lentamente, burbujas de diálogo que siguen la cabeza del personaje, círculos dibujados a mano y subrayados con pincel, ondas de distorsión al pasar el cursor sobre el personaje (React Bits "Ripple Distortion", WebGL, distorsiona solo el escenario; si no es compatible, se degrada a un efecto de estela fluorescente), texto que aparece letra por letra y pegatinas flotantes de dibujos animados.
La plantilla predeterminada es de estilo "garabato oscuro + personaje 3D" (fondo casi negro + amarillo/verde neón, púrpura/azul/naranja, títulos escritos a mano con rotulador, personaje 3D con pegatinas 2D), todo en inglés. Para cambiar el estilo, basta con modificar theme (colores, fuentes) y decor (decoraciones) de cada sección, sin tocar el motor.
El atractivo visual del sitio depende en un 70% de que los activos sean coherentes y continuos (mismo personaje, mismo fondo, el último fotograma de una sección es el primero de la siguiente) y en un 30% del diseño. Por eso, este skill dedica la mayor parte a la planificación y verificación de activos; el código ya está escrito en template/ y normalmente solo se modifican site.config.js y algo de CSS.
Estructura de directorios
template/ Plantilla ejecutable directamente (incluye activos de relleno en assets/demo/)
site.config.js Todo el texto, rutas de activos y parámetros de interacción
js/ css/ Motor y estilos, no se modifican normalmente
tools/calibrate.html Herramienta de calibración de fotogramas clave de seguimiento visual
scripts/frames.py Convierte videos/imágenes en secuencias de fotogramas para la web (necesita ffmpeg)
scripts/check-site.mjs Verifica que la configuración y los activos estén completos
scripts/fetch-reactbits.mjs Descarga React Bits "Ripple Distortion" en el sitio (ondas de distorsión al pasar el cursor; no se distribuye con la plantilla por licencia)
scripts/cutout.py Convierte pegatinas/personajes con fondo de color sólido a webp con fondo transparente (--split para dividir colecciones de pegatinas)
scripts/serve.py Servidor de previsualización local (sin caché, al recargar se ven los cambios)
scripts/shoot.mjs Capturas de verificación: Chrome sin interfaz + eventos de ratón reales, captura por secciones (escritorio/móvil)
scripts/make-demo-assets.py Regenera activos de relleno (generalmente no es necesario)
references/
01_planning.md Lista de preguntas para la entrevista, cómo definir las secciones y la "hoja de ruta del personaje"
02_asset_prompts.md Plantillas de prompts para personaje, fondo, seguimiento visual, transiciones, portadas de proyectos; verificación (incluye método práctico para herramientas que solo aceptan el primer fotograma)
03_building_iterating.md Descripción de campos de configuración, problemas comunes y soluciones, cómo dar retroalimentación
04_deployment.md Netlify / Vercel / GitHub Pages / Cloudflare, y cómo añadir trabajos posteriormente
05_open_source_design_references.md Sitios personales open source/analizados que vale la pena estudiar (léase cuando el usuario diga "no se ve lo suficientemente profesional")
Flujo de trabajo
Después de cada paso, muestra al usuario el resultado real (capturas de pantalla, mosaicos de fotogramas o previsualización local) y confirma antes de continuar. Si el usuario no es técnico, no le hagas leer la configuración; solo muéstrale las imágenes.
1. Entrevista y planificación → leer references/01_planning.md
Primero, averigua: de quién es la página, qué contenido incluir (currículum, portafolio, contacto), de dónde viene el personaje (foto propia, IP existente o nuevo diseño), qué estilo le gusta (pide al usuario 1-2 imágenes de referencia o sitios web), qué herramientas de generación de imágenes/video tiene. Luego, escribe un plan.md en el directorio del sitio: orden de las secciones, texto de cada sección, postura y posición del personaje en cada sección, y qué acción realiza el personaje en cada transición. Esta "hoja de ruta del personaje" es la base de todos los activos posteriores: la postura y la posición deben coordinarse con el diseño (si el texto está a la izquierda, el personaje estará a la derecha).
2. Activos → leer references/02_asset_prompts.md
El orden es importante; cada paso usa el resultado del anterior como referencia:
- Imagen final del personaje: De frente, cuerpo entero o medio busto, expresión clara. Si ya existe una IP, mantén las características reconocibles (cara, peinado, accesorios distintivos); la ropa puede cambiar según el tema.
- Fondo base: Una imagen sin personaje, compartida en todo el sitio y también como fondo de todos los videos, para que no parpadee al cambiar de clip.
- Imágenes clave de postura: Una por sección (personaje + mismo fondo + mismo ángulo de cámara), correspondientes a la postura y posición planificadas.
- Bucle de seguimiento visual: Desde la postura de frente, mira en 8 direcciones y vuelve al centro. Cuando la herramienta de video pueda aceptar fotograma inicial y final, genera segmentos y únelos con
frames.py gaze-join; cuando solo pueda aceptar el fotograma inicial (común en muchas herramientas de imagen a video), usa el método "estrella": 8 clips cortos que parten del fotograma clave de la pantalla de inicio, cada uno girando hacia una dirección y haciendo una expresión. Luego usaframes.py gaze-starpara combinarlos (una sola secuencia larga con 8 direcciones haría que el modelo se desvíe progresivamente). - Clips de transición: Usa dos imágenes clave de postura adyacentes como fotograma inicial y final para generar la animación intermedia. Cuando solo se pueda pasar el fotograma inicial, genera en cadena (el último fotograma de un clip es el primero del siguiente); si en el fotograma inicial de un clip no se ve la cara del personaje, usa el "método inverso" (primero genera la imagen final de la postura, luego genera el movimiento inverso y lo invierte), de lo contrario la herramienta alterará la cara final.
- Portadas de proyectos: Si el usuario ya tiene imágenes de sus proyectos, úsalas directamente; la relación de aspecto 16:10 es la más adecuada.
Si el usuario solo puede generar imágenes, no videos, la plantilla también funciona: el seguimiento visual usa 9 imágenes (frente + 8 direcciones, con transiciones de fundido), y las transiciones usan dos imágenes de postura con blend: true. Los comandos y la configuración específicos están en la "Ruta C" del documento 02. El efecto será más débil, pero debes informar claramente al usuario de las diferencias.
Cuando no haya ningún activo (primera versión sin activos): Primero monta el sitio para que el usuario vea el diseño y la interacción: copia la plantilla, completa el texto, los colores y los proyectos en site.config.js con la información del usuario, pero conserva el personaje de relleno de la plantilla. En este caso, ten en cuenta:
- Las burbujas de diálogo y el texto no deben decir cosas como "soy un zorro" que no coincidan con el personaje de relleno; usa frases neutras.
- Al entregar, explica primero: "La persona en la pantalla es un marcador de posición. Para reemplazarlo con tu personaje, primero necesitas generar estas imágenes/videos" y adjunta la lista de activos del
plan.md. check-site.mjste recordará qué elementos siguen usando activos de relleno. Antes de entregar al usuario, comunícale esta información tal cual.
Si el entorno actual tiene herramientas de generación de imágenes/video (por ejemplo, MCP de generación de imágenes y video), úsalas directamente; si la herramienta solo acepta el fotograma inicial, genera en cadena según el método del documento 02. Si no hay herramientas de video, el usuario generará los activos en plataformas como Jimeng, Kling, Vidu, Conch, etc. En ese caso, proporciona los prompts completos, qué imágenes subir como fotograma inicial y final, la duración y la relación de aspecto, y explica cómo verificar los videos recibidos.
Cada lote de activos debe verificarse antes de integrarse: extrae fotogramas y combínalos en una sola imagen (ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg) y revisa cada punto de la lista de verificación del documento 02. Si hay problemas, descríbelos con precisión (en qué segundo, qué cambió, cómo se ve) y modifica los prompts para regenerar.
3. Construcción del sitio → leer references/03_building_iterating.md
cp -r <skill>/template <directorio_del_sitio> # Primero copia la plantilla, no modifiques la original
cd <directorio_del_sitio>
node <skill>/scripts/fetch-reactbits.mjs . # Ondas de distorsión al pasar el cursor; si falla la descarga, se degrada automáticamente a liquid
python3 <skill>/scripts/frames.py extract transicion1.mp4 assets/clips/t1 # Cada clip de transición
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze clip1.mp4 clip2.mp4 … # Seguimiento visual (fotogramas inicial y final por segmento)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=izquierda.mp4 UL=arriba_izquierda.mp4 … # Seguimiento visual (solo fotograma inicial: método estrella)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000 # Abre http://localhost:8000 (sin caché)
Copia los fragmentos de configuración que imprime frames.py en site.config.js, luego completa el texto, los colores (theme.bg usa el color de fondo predominante que reporta el script, para que la página y el video se integren sin costuras) y las fuentes. Para el video de seguimiento visual (si no se compone por segmentos), usa http://localhost:8000/tools/calibrate.html para calibrar los fotogramas clave y la posición de la cabeza.
Las imágenes de referencia determinan theme y decor: primero, según el documento 03 "El estilo a partir de la imagen de referencia", escribe el color de fondo, los colores de acento, la fuente de los títulos, el lenguaje decorativo y el estilo del personaje; luego modifica la configuración. La plantilla usa inglés por defecto (el texto fijo de la interfaz se modifica en ui); cuando se mezclen chino e inglés, asegúrate de que la fuente del título en inglés vaya seguida de una fuente china (por ejemplo, "Permanent Marker", "ZCOOL QingKe HuangYou"). Si la imagen de referencia es de otro sitio, solo toma prestada la dirección estilística, no copies el personaje, nombre, texto ni diseño.
4. Iteración
En el navegador, desplázate de principio a fin y revisa cada punto de la lista de verificación del documento 03: que el seguimiento visual en la pantalla de inicio sea suave en las 8 direcciones, que al salir de la pantalla de inicio el personaje vuelva al centro antes de la transición, que no haya saltos al inicio y final de cada clip de transición, que el texto y los garabatos no tapen la cara del personaje, que el portafolio se abra y cierre correctamente, que el carrusel de proyectos funcione, que el personaje final no quede oculto por paneles, y que funcione bien en modo vertical móvil.
Corrige solo un tipo de problema a la vez y luego vuelve a comprobar. Así, el efecto de cada cambio es claro y no arruinarás partes que ya funcionan bien. El documento 03 incluye problemas comunes y sus soluciones.
5. Despliegue → leer references/04_deployment.md
Se recomienda Netlify Drop (arrastra la carpeta a la web para obtener un enlace público). Antes del despliegue, ejecuta check-site.mjs de nuevo para confirmar que no haya activos de relleno ni archivos faltantes.
Al entregar, deja claro
- Dónde está el directorio del sitio, cómo previsualizarlo localmente, cómo modificar el texto y cambiar proyectos (qué parte de
site.config.jsmodificar). - Qué verificaciones se realizaron realmente (en qué navegador y tamaño de pantalla; las capturas de
shoot.mjssolo demuestran que el diseño es correcto, la fluidez de la animación debe verse en el navegador real), y qué no se probó (por ejemplo, en un dispositivo móvil real). - El tamaño de los activos y el tiempo de carga inicial; si es grande, proporciona métodos de compresión.