Communitygithub.com

ChuchoMonster/claude-code-skills

Pipeline integral que toma una URL y produce una revisión completa de una página de aterrizaje con marca, genera un video de fondo animado para el héroe y lo despliega en vivo en Netlify. Encadena cuatro pasos sin preguntas intermedias: extracción del libro de marca (con publicación en GitHub), generación de video con Nano Banana 2 + Seedance 2, construcción de la página front-end y despliegue en Netlify.

¿Qué es claude-code-skills?

Esta skill automatiza el proceso completo de transformar la página de aterrizaje de un sitio web en una versión moderna y animada, con un video de fondo generado por IA, todo desplegado en Netlify sin intervención del usuario. Es especialmente útil para diseñadores, desarrolladores y equipos de producto que desean prototipar rápidamente una revisión visual de una página existente, manteniendo la fidelidad a la marca original y produciendo un resultado desplegable en minutos. La skill es compatible con Claude Code (o cualquier plataforma que soporte el formato SKILL.md) y utiliza APIs externas como KIE.ai para la generación de imágenes y videos, Netlify CLI para el despliegue, y GitHub MCP para publicar el libro de marca automáticamente. El flujo consta de cuatro etapas: primero extrae los activos de marca del sitio original (tipografía, colores, logotipo) y los publica en un repositorio público de GitHub; segundo, genera un video loop de 7 segundos para el héroe usando Nano Banana 2 para la imagen y Seedance 2 para la animación; tercero, construye la página HTML autónoma con Tailwind CSS, incorporando el video y los tokens de marca; y cuarto, despliega la página en Netlify bajo un subdominio único. Cada paso es idempotente y se omite si ya se ejecutó, ahorrando créditos y tiempo. La skill evita preguntas al usuario durante la ejecución, reportando solo los enlaces finales al terminar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChuchoMonster/claude-code-skills/tree/HEAD/skills/animated-website

Preguntar en tu IA favorita

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

Documentación

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

  1. 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.
  2. Deriva el slug y el nombre del sitio a partir del host de la URL:
    • host acmegrowthpartners.com → slug acme-growth, nombre del sitio Acme 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, no Acmegrowthpartners). Usa el slug solo para nombres de archivo y URLs.
  3. 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.

  1. Ejecuta el extractor de libro de marca:
    node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand"
    
  2. Lee sites/<slug>/brand/type-styles.json, sites/<slug>/brand/css-variables.json y visualiza sites/<slug>/brand/reference.png.
  3. Escribe sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, README.md siguiendo 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".
  4. 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), luego mcp__github__push_files con los 6 archivos (omite reference.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_files para actualizar.

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.

  1. 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.png en 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.
  2. 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".
  3. Envía a Nano Banana 2:
    source "$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" } }
    EOF
    
    Captura taskId. Consulta https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID> hasta que state == "success". Analiza data.resultJson (es una cadena JSON) para obtener la URL. No descargues — mantén la URL en la nube.
  4. 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."
  5. Envía a Seedance 2 con la URL de la imagen en la nube como image_url:
    cat > /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.json
    
    Captura taskId. 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 endpoint recordInfo directamente para leer state (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).
  6. 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.

  1. Carga el contexto para la subskill de diseño frontend:
    • Lee sites/<slug>/brand/tailwind.snippet.js (contenido completo)
    • Lee sites/<slug>/brand/typography.md y colors.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)
  2. Invoca la skill frontend-design:frontend-design a 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.mp4 al 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.mp4 como 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.
  3. Después de que la subskill termine, verifica que $PWD/sites/<slug>/index.html exista y haga referencia a ./hero-loop-7s.mp4.

Captura: SITE_PATH.

Paso 4 — Despliegue en Netlify

  1. 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).
  2. 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.app en vivo).
  3. Prueba rápida de humo: curl -sI <LIVE_URL> | head -1 debe devolver HTTP/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 en sites/<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.resultJson es 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 netlify falla, dile al usuario que ejecute npm install -g netlify-cli && netlify login y 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados