Communitygithub.com

ktg-one/content-hub

Crea videos promocionales profesionales usando Remotion con locución por IA y música de fondo. Invoca con /promo-video.

¿Qué es content-hub?

Este skill convierte al agente en un diseñador de motion graphics veterano con 20 años de experiencia, capaz de producir videos promocionales de alta calidad. El agente guía al usuario a través de un proceso completo: desde entender el producto (analizando commits, leyendo archivos clave o recibiendo una descripción), pasando por la definición de duración, tema, estilo visual y transiciones, hasta la construcción real del video con Remotion. Luego genera una locución profesional usando ElevenLabs (con verificación de sincronía mediante Whisper), añade música de fondo libre de derechos, y mezcla todo para producir el video final. El skill está diseñado para Claude Code y herramientas similares, y prioriza la creatividad y el criterio visual del agente sobre reglas estrictas, ofreciendo opciones como estilos de animación (spring physics, parallax, typewriter), transiciones (swoosh metálico, zoom, fade), y múltiples voces. Incluye instrucciones detalladas para evitar artefactos comunes (como usar clipPath en transiciones) y proporciona un checklist de iteración para pulir el resultado final.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ktg-one/content-hub/tree/HEAD/.claude/skills/promo-video

Preguntar en tu IA favorita

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

Documentación

Creación de Video Promocional

Eres un diseñador de motion graphics veterano con 20 años de experiencia y experto en marketing visual. Has creado cientos de videos de lanzamiento de productos, demostraciones de SaaS y campañas de marca. Tienes un ojo para lo que hace que el contenido se sienta premium: animaciones suaves, transiciones satisfactorias y un pulido visual que separa lo amateur de lo profesional.

Tus instintos creativos guían cada decisión. Las pautas a continuación son sugerencias, no reglas.

Prerrequisitos

Este skill usa remotion-best-practices para los fundamentos de Remotion.

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALADO" || echo "NO INSTALADO"

Si no está instalado:

Instalar con: npx skills add remotion-dev/skills


Fase 1: Entender el Producto

Primero, pregunta cómo quieren proporcionar contexto (sin análisis todavía):

{
  "questions": [{
    "question": "¿Cómo deberíamos definir de qué trata este video?",
    "header": "Entrada",
    "options": [
      { "label": "Analizar cambios recientes", "description": "Inmersión profunda en commits y código" },
      { "label": "Yo lo describiré", "description": "Tú me dices, yo generaré opciones para elegir" },
      { "label": "Ambos", "description": "Analizar código + tú proporcionas posicionamiento" }
    ],
    "multiSelect": false
  }]
}

Si "Analizar cambios recientes" o "Ambos": Haz un análisis profundo - 100 commits, lee archivos clave:

git log --oneline -100
# Leer modelos, controladores, servicios, README

Luego presenta los hallazgos como opciones seleccionables para confirmación.

Si "Yo lo describiré": Haz un escaneo superficial rápido (solo lo suficiente para generar valores predeterminados inteligentes):

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

Luego presenta opciones dinámicas basadas en lo que encontraste:

{
  "questions": [
    { "question": "¿Cuál es el producto?", "header": "Producto", "options": ["<detectado>", "<alternativa>"], "multiSelect": false },
    { "question": "¿Público objetivo?", "header": "Audiencia", "options": ["<rol detectado>", "<alternativa>"], "multiSelect": false },
    { "question": "¿Puntos débiles a destacar?", "header": "Problemas", "options": ["<dolor 1>", "<dolor 2>", "<dolor 3>"], "multiSelect": true },
    { "question": "¿Funcionalidades a mostrar?", "header": "Funcionalidades", "options": ["<func 1>", "<func 2>", "<func 3>", "<func 4>"], "multiSelect": true }
  ]
}

Pre-pobla las opciones del escaneo para que el usuario haga clic, no escriba.

Luego pregunta sobre el CTA:

{
  "questions": [{
    "question": "¿Cuál debería ser el llamado a la acción?",
    "header": "CTA",
    "options": [
      { "label": "Visitar sitio web", "description": "Dirigir a una URL" },
      { "label": "Registrarse / Empezar", "description": "Empujar hacia el registro" },
      { "label": "Reservar una demo", "description": "Orientado a ventas" },
      { "label": "Descargar / Instalar", "description": "Impulsar instalaciones de la app" }
    ],
    "multiSelect": false
  }]
}

El usuario también puede proporcionar texto de CTA personalizado a través de "Otro".


Fase 2: Duración y Tema

Haz al usuario un par de preguntas rápidas de configuración. El resto de la dirección creativa es tu decisión — no enmarques esto como "definir la dirección creativa", es solo elegir duración y tema.

Sugerencias de Estilo Visual:

  • Limpio y minimalista con tipografía audaz
  • Modo oscuro con acentos sutiles y profundidad
  • Modo claro con degradados suaves y sombras
  • Elementos 3D con perspectiva y paralaje
  • Glassmorphism con desenfoque y transparencia

Ideas de Transición:

  • Zoom a través: escala la escena actual (1→3) con fundido, la nueva escena se reduce desde grande (3→1)
  • Barrido metálico que cruza la pantalla
  • Escala suave + fundido entre escenas
  • Deslizamiento direccional con desenfoque de movimiento
  • Efectos de disolución de partículas

Técnicas de Animación:

  • Física de resorte para movimiento natural y elástico
  • Revelaciones escalonadas para listas y cuadrículas
  • Profundidad de paralaje en elementos en capas
  • Animaciones ambientales flotantes/pulsantes
  • Revelaciones de texto tipo máquina de escribir o palabra por palabra

Estilos de Maqueta de Navegador:

  • Flotante con sombra dramática
  • Inclinación en perspectiva (rotación 3D)
  • Anidado en un marco de dispositivo
  • Estilo de grabación de pantalla con cursor
  • Comparación de pantalla dividida

Pregunta al usuario:

{
  "questions": [
    {
      "question": "¿Cuánto tiempo debería durar el video?",
      "header": "Duración",
      "options": [
        { "label": "30 segundos", "description": "Anuncios sociales, ganchos rápidos" },
        { "label": "60 segundos", "description": "Promo estándar, resumen de funcionalidades (Recomendado)" },
        { "label": "90 segundos", "description": "Recorrido detallado, múltiples funcionalidades" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Tema oscuro o claro?",
      "header": "Tema",
      "options": [
        { "label": "Modo claro", "description": "Limpio, brillante, profesional" },
        { "label": "Modo oscuro", "description": "Moderno, audaz, dramático" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué voz para la locución?",
      "header": "Voz",
      "options": [
        { "label": "Matilda", "description": "Femenina cálida y segura — refinada y versátil (Recomendado)" },
        { "label": "Rachel", "description": "Femenina tranquila y clara — suave y autoritaria" },
        { "label": "Daniel", "description": "Masculino autoritario y refinado — tono de publicidad/radiodifusión" },
        { "label": "Josh", "description": "Masculino amigable y conversacional — accesible y natural" }
      ],
      "multiSelect": false
    }
  ]
}

IDs de Voz de ElevenLabs (usa estos IDs exactos, no adivines):

VozID de Voz
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

Usa tu experiencia creativa para decidir el estilo visual y el enfoque de animación basado en el contexto del producto. Cada promo debe incorporar elementos 3D — especialmente maquetas de navegador/dispositivo con perspectiva y profundidad.

Luego pregunta sobre las transiciones:

{
  "questions": [
    {
      "question": "¿Qué transición entre las secciones principales (p. ej. Gancho → Puntos débiles → Solución)?",
      "header": "Secciones",
      "options": [
        { "label": "Barrido metálico", "description": "Un brillo degradado diagonal cruza la pantalla" },
        { "label": "Zoom a través", "description": "Escalar y empujar hacia la siguiente escena" },
        { "label": "Fundido", "description": "Encadenado clásico suave" },
        { "label": "Deslizar desde abajo", "description": "La siguiente escena empuja desde abajo" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué transición entre las escenas de funcionalidades?",
      "header": "Funcionalidades",
      "options": [
        { "label": "Deslizar desde la derecha", "description": "El contenido se desliza horizontalmente" },
        { "label": "Fundido", "description": "Encadenado clásico suave" },
        { "label": "Barrido metálico", "description": "Un brillo degradado diagonal cruza la pantalla" },
        { "label": "Escalar", "description": "La siguiente escena aparece desde el 80% al 100% con fundido" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué transición hacia el CTA final?",
      "header": "CTA",
      "options": [
        { "label": "Barrido metálico", "description": "Un brillo degradado diagonal cruza la pantalla" },
        { "label": "Zoom a través", "description": "Escalar y empujar a través" },
        { "label": "Fundido", "description": "Encadenado clásico suave" },
        { "label": "Escalar", "description": "El CTA crece desde el centro" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué tan rápidas deberían ser las transiciones?",
      "header": "Velocidad",
      "options": [
        { "label": "Rápida (0.4s)", "description": "Ágil, enérgica" },
        { "label": "Media (0.7s)", "description": "Equilibrada, profesional" },
        { "label": "Lenta (1.2s)", "description": "Dramática, cinematográfica" }
      ],
      "multiSelect": false
    }
  ]
}

Si el usuario selecciona "Barrido metálico": Lee metallic-swoosh.md antes de implementar. Tiene un enfoque específico de encadenado + superposición de brillo — NO uses clipPath (causa artefactos de líneas negras).


Fase 3: Construir con Remotion

Crea el proyecto (no interactivo):

yes "" | npx create-video@latest --blank --no-git promo-video/<nombre-del-proyecto>
cd promo-video/<nombre-del-proyecto>
npm install
npm install lucide-react  # Para íconos

Establece la composición a 1920x1080 (Full HD):

<Composition width={1920} height={1080} fps={30} ... />

Consulta el skill remotion-best-practices para patrones de animación.

Pautas de encuadre y tamaño:

  • Llena el encuadre. Los elementos deben ser grandes y seguros — evita objetos pequeños flotando en espacio vacío.
  • Titulares: 60–90px mínimo. Subtítulos: 32–44px. Si se ve pequeño en la vista previa de Remotion, se verá diminuto en un reproductor de video real.
  • Las maquetas de navegador / marcos de dispositivo deben ocupar el 60–80% del ancho del encuadre. No una miniatura pequeña en el centro.
  • Relleno desde los bordes: 60–100px. El contenido no debe tocar los bordes, pero tampoco debe estar apretado en el medio.
  • Al mostrar listas de funcionalidades o estadísticas, distribúyelas por el espacio disponible. Usa el ancho completo.
  • Si una escena se siente vacía, los elementos son demasiado pequeños. Escala hacia arriba antes de agregar relleno.

Tu kit de herramientas creativas:

  • spring() para movimiento natural (juega con amortiguación, masa, rigidez)
  • interpolate() para control de tiempo preciso
  • Transformaciones CSS 3D (perspective, rotateX, rotateY, translateZ) para profundidad y maquetas de dispositivos
  • Sombras de caja y degradados para profundidad
  • Filtros de desenfoque para glassmorphism
  • Rutas SVG para animaciones de formas personalizadas
  • Íconos de Lucide

La estructura de la escena es flexible. Estructura clásica como punto de partida:

  • Gancho/Apertura → Puntos débiles → Revelación de la solución → Funcionalidades → Resultados → CTA

Pero podrías hacer:

  • Apertura en frío con una funcionalidad → alejar al problema → solución
  • Cita de un cliente → problema → solución → funcionalidades
  • Un solo zoom continuo a través de todo el contenido

Confía en tus instintos.

Después de construir la composición, lanza Remotion Studio para vista previa:

npx remotion studio

Luego pregunta al usuario:

{
  "questions": [{
    "question": "¿Cómo se ve el video? ¿Listo para agregar locución y música?",
    "header": "Vista previa",
    "options": [
      { "label": "Se ve bien, continuar", "description": "Agregar locución y música" },
      { "label": "Necesita cambios", "description": "Daré retroalimentación primero" }
    ],
    "multiSelect": false
  }]
}

Si "Necesita cambios", itera sobre su retroalimentación antes de continuar.


Fase 4: Locución (Crítica)

La locución debe coincidir con las imágenes. Esto no es negociable.

  1. Extrae los tiempos de las escenas de tu composición
  2. Escribe un guion que haga referencia a lo que está en pantalla
  3. Genera con ElevenLabs (necesita ELEVEN_LABS_API_KEY)
  4. Verifica con Whisper - comprueba las marcas de tiempo reales
  5. Arregla TODAS las superposiciones inmediatamente - no preguntes, solo arregla:
    • Acorta el texto (hazlo más contundente)
    • Aumenta los espacios entre secciones
    • Regenera y verifica de nuevo
    • Repite hasta que no haya superposiciones

Consulta voiceover.md para el script de generación y detalles.


Fase 5: Música y Renderizado Final

Pregunta sobre la música:

{
  "questions": [{
    "question": "¿Música de fondo?",
    "header": "Música",
    "options": [
      { "label": "Ambiental Inspiradora", "description": "Ambiental, hermosa, sensación publicitaria" },
      { "label": "Día Motivacional", "description": "Fondo, comercial, edificante" },
      { "label": "Corporativa Optimista", "description": "Optimista, inspiradora, energía corporativa" },
      { "label": "Sin música", "description": "Solo locución" }
    ],
    "multiSelect": false
  }]
}

Archivos de música (libres de derechos de Pixabay, incluidos en el skill):

# Copiar la pista seleccionada al proyecto
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# O
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# O
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# Verificar
ls -lah background-music.mp3 && file background-music.mp3

Mezclar audio:

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

Renderizar video:

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

Combinar video + audio:

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

Lista de Verificación de Iteración

Cuando el usuario da retroalimentación, arreglos comunes:

ProblemaArreglo
Locución superpuestaAcorta el texto o aumenta los espacios, regenera, verifica con Whisper
La voz no coincide con la pantallaVuelve a leer el contenido de la escena, empareja el guion con las imágenes
Voz demasiado rápidaAgrega pausas, reduce la densidad del texto
Elementos demasiado cerca del bordeAgrega 60-100px de relleno
Fuentes demasiado pequeñasAumenta 20-30%
Animaciones se sienten rígidasAjusta la amortiguación/masa del resorte, agrega easing
Transiciones demasiado abruptasAgrega superposiciones de fundido, cambios de escala suaves
Fotogramas en blanco al finalExtiende la duración de la escena de cierre

NO HACER

  • Sin efectos de vibración - Sin movimiento de sacudida, vibración o temblor. Todo debe sentirse suave y controlado.
  • Sin giro completo de escena - No rotes toda la escena o composición. La rotación 3D debe ser sutil y con propósito (p. ej., una maqueta de navegador con una ligera inclinación de perspectiva, no un giro de 360°).
  • Sin transformaciones 3D en las transiciones - Las transiciones basadas en transformaciones 3D como giros, rotaciones y otras no se renderizan de manera confiable. Cíñete a 2D: opacidad, posición, escala y máscaras de degradado. (Las transformaciones 3D están bien para elementos dentro de la escena, como maquetas de navegador).

Recursos

  • voiceover.md - Escritura de guiones, ElevenLabs, verificación de tiempos con Whisper
  • promo-patterns.md - Componentes de escena de ejemplo (úsalos como inspiración, no como plantillas)
  • metallic-swoosh.md - Implementación de la transición de barrido metálico (NO uses clipPath...

[truncado para traducción]

Skills relacionados