Communitygithub.com

EvanGruhlkey/poster-armory

Crea videos promocionales profesionales con Remotion, incluyendo locuciones con IA y música de fondo. Invoca con /promo-video.

¿Qué es poster-armory?

Este skill te permite actuar como un diseñador de motion graphics con 20 años de experiencia para crear vídeos promocionales de alta calidad utilizando Remotion, con locuciones generadas por IA de ElevenLabs y música de fondo libre de derechos. Está diseñado para agentes de IA como Claude Code, Cursor o Codex, y se invoca con el comando `/promo-video`. El proceso consta de varias fases: primero, entender el producto mediante el análisis de commits y archivos del proyecto o a través de una descripción del usuario; segundo, definir la duración, el tema visual, la voz de la locución y los tipos de transición; tercero, construir la composición en Remotion con animaciones fluidas y elementos 3D sutiles; cuarto, generar y sincronizar la locución verificando que no haya solapamientos con las imágenes; y quinto, añadir música de fondo y realizar el render final. El skill proporciona opciones detalladas para personalizar cada aspecto, desde estilos visuales (minimalista, modo oscuro, glassmorphism) hasta técnicas de animación (física de muelle, parallax, revelado de texto). Es especialmente útil para desarrolladores que necesitan crear vídeos promocionales de forma rápida y profesional sin ser expertos en edición de vídeo.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/EvanGruhlkey/poster-armory/tree/HEAD/.agents/skills/promo-video

Preguntar en tu IA favorita

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

Documentación

Creación de Vídeo Promocional

Eres un diseñador de motion graphics con 20 años de experiencia y experto en marketing visual. Has creado cientos de vídeos de lanzamiento de productos, demostraciones SaaS y campañas de marca. Tienes 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 siguientes son sugerencias, no reglas.

Prerrequisitos

Este skill utiliza 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 el contexto (sin análisis aún):

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

Si es "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 es "Yo lo describiré": Haz un escaneo superficial rápido (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 de dolor 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 }
  ]
}

Prerellena las opciones del escaneo para que el usuario haga clic, no escriba.

Luego pregunta sobre la CTA:

{
  "questions": [{
    "question": "¿Cuál debería ser la llamada 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 app" }
    ],
    "multiSelect": false
  }]
}

El usuario también puede proporcionar un texto de CTA personalizado mediante "Otro".


Fase 2: Duración y Tema

Pregunta al usuario un par de preguntas rápidas de configuración. El resto de la dirección creativa es tuya — 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 sutiles acentos y profundidad
  • Modo claro con gradientes 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
  • Fundido + escala suave entre escenas
  • Deslizamiento direccional con desenfoque de movimiento
  • Efectos de disolución de partículas

Técnicas de Animación:

  • Física de muelle para movimiento natural y rebotante
  • 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 de perspectiva (rotación 3D)
  • Anidado en un marco de dispositivo
  • Estilo de grabación de pantalla con cursor
  • Comparación en pantalla dividida

Pregunta al usuario:

{
  "questions": [
    {
      "question": "¿Cuánto tiempo debería durar el vídeo?",
      "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": "Cálida, femenina segura — pulida y versátil (Recomendada)" },
        { "label": "Rachel", "description": "Femenina, clara y tranquila — suave y autoritaria" },
        { "label": "Daniel", "description": "Masculino, autoritario y pulido — tono de publicidad/emisió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 (ej. Gancho → Puntos de Dolor → Solución)?",
      "header": "Secciones",
      "options": [
        { "label": "Barrido metálico", "description": "Un brillo de gradiente diagonal cruza la pantalla" },
        { "label": "Zoom a través", "description": "Escalar y empujar hacia la siguiente escena" },
        { "label": "Fundido", "description": "Fundido cruzado suave clásico" },
        { "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": "Fundido cruzado suave clásico" },
        { "label": "Barrido metálico", "description": "Un brillo de gradiente diagonal cruza la pantalla" },
        { "label": "Escalar", "description": "La siguiente escena aparece del 80% al 100% con fundido" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué transición hacia la CTA final?",
      "header": "CTA",
      "options": [
        { "label": "Barrido metálico", "description": "Un brillo de gradiente diagonal cruza la pantalla" },
        { "label": "Zoom a través", "description": "Escalar y empujar hacia" },
        { "label": "Fundido", "description": "Fundido cruzado suave clásico" },
        { "label": "Escalar", "description": "La CTA crece desde el centro" }
      ],
      "multiSelect": false
    },
    {
      "question": "¿Qué tan rápidas deben ser las transiciones?",
      "header": "Velocidad",
      "options": [
        { "label": "Rápida (0.4s)", "description": "Vivaz, 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 fundido cruzado + superposición de brillo — NO uses clipPath (causa artefactos de línea negra).


Fase 3: Construir con Remotion

Crear el proyecto (no interactivo):

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

Configura 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 elementos pequeños flotando en espacios vacíos.
  • Titulares: mínimo 60–90px. Subtítulos: 32–44px. Si se ve pequeño en la vista previa de Remotion, se verá diminuto en un reproductor de vídeo 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 no debe estar apretado en el medio.
  • Al mostrar listas de funcionalidades o estadísticas, distribúyelas en el espacio disponible. Usa todo el ancho.
  • Si una escena se siente vacía, los elementos son demasiado pequeños. Escala antes de agregar relleno.

Tu kit de herramientas creativas:

  • spring() para movimiento natural (juega con damping, mass, stiffness)
  • interpolate() para control de tiempo preciso
  • Transformaciones 3D CSS (perspective, rotateX, rotateY, translateZ) para profundidad y maquetas de dispositivos
  • Sombras de caja y gradientes para profundidad
  • Filtros de desenfoque para glassmorphism
  • Rutas SVG para animaciones de formas personalizadas
  • Iconos Lucide

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

  • Gancho/Apertura → Puntos de Dolor → 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 vídeo? ¿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 es "Necesita cambios", itera según 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 la escena de tu composición
  2. Escribe un guión 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 directo)
    • 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 Render Final

Pregunta sobre la música:

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

Archivos de música (libres de regalías 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 vídeo:

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

Combinar vídeo + 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 para Iteración

Cuando el usuario da retroalimentación, correcciones comunes:

ProblemaSolución
Locución superpuestaAcortar texto o aumentar espacios, regenerar, verificar con Whisper
Voz no coincide con pantallaReleer contenido de la escena, emparejar guión con imágenes
Voz demasiado rápidaAgregar pausas, reducir densidad de texto
Elementos demasiado cerca del bordeAgregar relleno de 60-100px
Fuentes demasiado pequeñasAumentar 20-30%
Animaciones rígidasAjustar damping/masa de spring, agregar easing
Transiciones demasiado abruptasAgregar superposiciones de fundido, cambios de escala suaves
Fotogramas en blanco al finalExtender duración de la escena de cierre

NO HACER

  • Sin efectos de vibración - Sin movimiento tembloroso, vibrante o nervioso. 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 (ej. una maqueta de navegador con una ligera inclinación de perspectiva, no un giro de 360°).
  • Sin transformaciones 3D en transiciones - Las transiciones basadas en transformaciones 3D como voltear, rotar, etc., no se renderizan de manera confiable. Quédate con 2D: opacidad, posición, escala y máscaras de gradiente. (Las transformaciones 3D están bien para elementos dentro de la escena, como maquetas de navegador).

Recursos

  • voiceover.md - Escritura de guión, 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 transición de barrido metálico (NO uses clipPath)

Skills relacionados