Pipeline de Sitio Web Animado
De extremo a extremo: URL de entrada, URL desplegada en Netlify de salida. Cuatro pasos, sin preguntas intermedias. Las salidas se organizan bajo $PWD/sites/<slug>/ para que múltiples sitios coexistan en un mismo proyecto padre.
Cuándo se activa
- Extrae la URL del mensaje del usuario o del argumento
$1. Si de alguna manera no hay URL, pregunta una vez y detente. De lo contrario, procede en silencio. - Deriva el slug y el nombre del sitio a partir del host de la URL:
- host
acmegrowthpartners.com→ slugacme-growth, nombre del sitioAcme Growth Partners(en título) - Quita
www., elimina el TLD, reemplaza puntos por guiones, pasa a minúsculas. Para nombres amigables usa un título sensible basado en el reconocimiento de la marca (ej.acmegrowthpartners.com→Acme Growth Partners, noAcmegrowthpartners). Usa el slug solo para nombres de archivo y URLs.
- host
- Confirma los requisitos previos en paralelo:
npx playwright --version(dependencia de extracción de libro de marca)grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<tu-directorio-proyecto>/.env"(clave API de KIE.ai)command -v netlify(CLI de Netlify para el paso de despliegue)mkdir -p "$PWD/sites/<slug>"
Si falla algún requisito, muestra el problema exacto y detente. No intentes instalar Playwright, Netlify ni adivinar claves API.
Paso 1 — Libro de Marca (omitible)
Condición de omisión: todos los archivos $PWD/sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, reference.png existen Y reference.png se modificó en las últimas 24h. Si se omite, registra "→ libro de marca reutilizado desde caché" y continúa.
- Ejecuta el extractor de libro de marca:
node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand" - Lee
sites/<slug>/brand/type-styles.json,sites/<slug>/brand/css-variables.jsony visualizasites/<slug>/brand/reference.png. - Escribe
sites/<slug>/brand/typography.md,colors.md,tailwind.snippet.js,README.mdsiguiendo el formato de la skill de libro de marca: primero inconsistencias, tabla de escalas tipográficas, grupos de paleta, tokens de Tailwind con nombres semánticos. Aplica la regla de "racionalizar, no codificar". - Publica automáticamente en GitHub sin preguntar (esto crea un repositorio público en tu cuenta de GitHub — establece
<tu-usuario-github>abajo, o elimina este paso si no quieres publicar libros de marca):- Nombre del repositorio:
Brand-Book-<TitleCaseSlug>(ej.Brand-Book-Acme-Growth-Partners). Guiones entre palabras. - Usa
mcp__github__create_repository(propietario:<tu-usuario-github>, público, autoInit: true), luegomcp__github__push_filescon los 6 archivos (omitereference.png— demasiado grande para el límite de argumentos de la herramienta). - Si el repositorio ya existe (HTTP 422 de create), continúa — llama directamente a
mcp__github__push_filespara actualizar.
- Nombre del repositorio:
Captura: BRAND_REPO_URL, más los valores hexadecimales racionalizados de primario, acento, neutro, superficie-oscuro de colors.md (los releerás en el paso 3).
Paso 2 — Video Loop del Héroe (omitible)
Condición de omisión: $PWD/sites/<slug>/hero-loop-7s.mp4 existe. Registra "→ video del héroe reutilizado desde caché" y continúa.
- Deriva el concepto visual de los artefactos del libro de marca que acabas de escribir:
- Inspecciona la paleta racionalizada en
colors.md→ elige la emoción dominante de la marca (ej. trayectoria + desbloqueo para marcas orientadas al crecimiento; calidez + artesanía para paletas cálidas; moderación + precisión para monocromos minimalistas). - Observa
reference.pngen busca de motivos visuales (dirección del degradado, trabajo de líneas, tratamiento de partículas/grano, formas geométricas). - Sintetiza una metáfora de video de una oración que mapee el posicionamiento verbal de la marca al movimiento.
- Esto es trabajo creativo — tómalo en serio, no recurras a una plantilla genérica. Mira la captura de pantalla.
- Inspecciona la paleta racionalizada en
- Construye el prompt de imagen de Nano Banana 2 como una imagen fija 1:1 que capture el "antes" del ciclo. Referencia los códigos hexadecimales exactos de la marca. Termina con "sin texto, sin logotipos, cinematográfico, estética B2B premium".
- Envía a Nano Banana 2:
Capturasource "$PWD/.env" 2>/dev/null || source "$HOME/<tu-directorio-proyecto>/.env" curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- <<EOF { "model": "nano-banana-2", "input": { "prompt": "<IMAGE_PROMPT>", "output_format": "png", "image_size": "1:1" } } EOFtaskId. Consultahttps://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID>hasta questate == "success". Analizadata.resultJson(es una cadena JSON) para obtener la URL. No descargues — mantén la URL en la nube. - Construye el prompt de Seedance como tiempos codificados a lo largo de 7 segundos. Incluye siempre:
- 0-2s: establecer (deriva de cámara, atmósfera)
- 2-4s: construir (el movimiento se acelera / converge)
- 4-5s: liberar (el momento de "desbloqueo" de la marca — generalmente el color de acento florece)
- 5-7s: resolver (volver a un estado repetible)
- Final: "Cámara lenta controlada, sin sacudidas. Física de destello de luz realista. Sin texto, sin logotipos."
- Envía a Seedance 2 con la URL de la imagen en la nube como
image_url:Capturacat > /tmp/seedance-payload.json <<'EOF' { "model": "bytedance/seedance-2", "input": { "prompt": "<VIDEO_PROMPT>", "image_url": "<CLOUD_IMAGE_URL>", "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } } EOF curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @/tmp/seedance-payload.jsontaskId. Ejecuta un bucle de sondeo en segundo plano (run_in_background: true) — tiempo típico de generación 3-5 min. Cuando se notifique que ha terminado, golpea el endpointrecordInfodirectamente para leerstate(el analizador de sondeo en bash con python es frágil; prefiere una solicitud curl directa después de la notificación en segundo plano). - Descarga el video final a
$PWD/sites/<slug>/hero-loop-7s.mp4.
Captura: VIDEO_PATH.
Paso 3 — Construcción del Diseño Frontend (omitible)
Condición de omisión: $PWD/sites/<slug>/index.html existe. Registra "→ sitio reutilizado desde caché" y continúa. (Si el usuario quiere una reconstrucción, eliminará el archivo o pasará --force en su solicitud).
Este es el producto de trabajo que el usuario compara contra los Artifacts de claude.ai. La calidad importa.
- Carga el contexto para la subskill de diseño frontend:
- Lee
sites/<slug>/brand/tailwind.snippet.js(contenido completo) - Lee
sites/<slug>/brand/typography.mdycolors.md(solo los resúmenes de racionalización) - Nota la ruta local del video:
./hero-loop-7s.mp4(hermano de index.html — IMPORTANTE: no uses../references/...como la estructura antigua) - Nota la URL de origen (para referencia de contenido/copia — la página debe ser una revisión, no un clon)
- Lee
- Invoca la skill
frontend-design:frontend-designa través de la herramienta Skill. Pasa un único prompt autocontenido con todo lo siguiente:- Ruta de salida —
$PWD/sites/<slug>/index.html(archivo único, autocontenido). El video está en./hero-loop-7s.mp4al lado. - Tokens de marca — pega el bloque completo de theme.extend de Tailwind de
sites/<slug>/brand/tailwind.snippet.js - Video del héroe — referencia con src
./hero-loop-7s.mp4como fondo<video autoplay loop muted playsinline>en el héroe, con una cortina de degradado oscuro para legibilidad del texto. - URL de origen para el contenido — dile a la subskill de diseño que redacte una revisión de la página de aterrizaje de
<URL>: mantén la propuesta de valor y las secciones clave (héroe, prueba social, servicios/soluciones, CTA, pie de página) pero eleva la calidad del diseño, la jerarquía tipográfica y el refinamiento del movimiento. - Barra de calidad — "de nivel de producción, distintivo, evitar la estética genérica de IA. El usuario está comparando esto contra la salida de los Artifacts de claude.ai — apunta más alto."
- Stack tecnológico — HTML vanilla + Tailwind vía CDN (
https://cdn.tailwindcss.com) + iconos Lucide + Google Fonts. Integra la configuración de Tailwind para consumir los tokens de marca. - Autenticidad del contenido — si el sitio en vivo tiene productos/módulos/servicios con nombre, úsalos textualmente. Si no estás seguro, usa WebFetch en la URL para enumerar los módulos reales antes de escribir la copia. No inventes productos que no existan.
- Ruta de salida —
- Después de que la subskill termine, verifica que
$PWD/sites/<slug>/index.htmlexista y haga referencia a./hero-loop-7s.mp4.
Captura: SITE_PATH.
Paso 4 — Despliegue en Netlify
- Crea o reutiliza un sitio de Netlify para este slug. Usa un patrón de nombre de sitio claro y estable:
animated-<slug>(ej.animated-acme-growth). - Desde
$PWD/sites/<slug>/, despliega a producción:cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1- En la primera ejecución para un slug, Netlify dirá que el sitio no existe. En ese caso, créalo explícitamente:
netlify sites:create --name=animated-<slug>y luego vuelve a ejecutar el despliegue. - Captura la
Website URL:de la salida del despliegue (la URL*.netlify.appen vivo).
- En la primera ejecución para un slug, Netlify dirá que el sitio no existe. En ese caso, créalo explícitamente:
- Prueba rápida de humo:
curl -sI <LIVE_URL> | head -1debe devolverHTTP/2 200. Si no, muestra el fallo pero aún reporta la ruta local.
Captura: LIVE_URL.
Salida final
Una vez que los cuatro pasos tengan éxito, envía al usuario un mensaje corto — cuatro enlaces y nada más:
En vivo - <LIVE_URL>
Libro de marca - <BRAND_REPO_URL>
Video héroe - <VIDEO_PATH>
Sitio local - <SITE_PATH>
No resumas lo que se construyó. No recapitules. No abras automáticamente el archivo local — la URL en vivo es el entregable ahora.
Escollos
- No preguntes al usuario durante la ejecución. El objetivo es cero transferencias. Si algo falta genuinamente (sin URL, sin clave API, sin CLI de Netlify), muestra el bloqueador y detente — no pidas aportes creativos.
- Omite pasos que ya se ejecutaron. Los tres pasos de artefactos son idempotentes por existencia de archivo. Rehacerlos desperdicia créditos.
- La ruta del video debe ser relativa a su HTML hermano. Usa
./hero-loop-7s.mp4, no../references/.... Cada sitio es completamente autocontenido ensites/<slug>/. - Cada sitio es su propio sitio de Netlify, no una subruta. Despliega con
--site=animated-<slug>para que obtengas su propia URL*.netlify.app. No intentes montar cinco sitios en un proyecto de Netlify. - La URL de imagen alojada en KIE es temporal — envía la tarea de Seedance en la misma sesión.
data.resultJsones una cadena JSON, no un objeto. Analízala.- ¿El repositorio de GitHub ya existe? No falles — simplemente empuja los nuevos archivos para actualizar.
- No instales automáticamente netlify-cli. Si
command -v netlifyfalla, dile al usuario que ejecutenpm install -g netlify-cli && netlify loginy detente. - Fidelidad de marca > libertad creativa para nombres de productos. Usa siempre los nombres reales de productos/módulos del sitio en vivo. Ejecuta WebFetch para verificar antes de escribir la copia de la página.
- La calidad de la captura de pantalla del libro de marca importa para la derivación del concepto. Si la captura de pantalla está mayormente vacía (superposición de banner de cookies, secciones cargadas diferidamente no se pintaron), aún así procede — usa el JSON de estilos tipográficos + la paleta de colores + tu conocimiento del posicionamiento de la marca para derivar el concepto.