Communitygithub.com

mfrancime/trident-archive

Genera videos de demostración de productos de 2 minutos para proyectos técnicos (repositorios de GitHub, APIs, productos técnicos). Ejecuta opciones de compilación en paralelo con revisión estructurada de críticos. Útil para demostrar código, explicar arquitectura o crear videos explicativos.

¿Qué es trident-archive?

Esta habilidad de agente de IA autogestiona todo el flujo de trabajo de producción de videos de demostración de productos de 2 minutos para proyectos técnicos como repositorios de GitHub, APIs o productos de software. Está diseñada para desarrolladores, ingenieros o equipos de producto que necesitan crear rápidamente videos explicativos profesionales sin edición manual. El flujo de trabajo se divide en siete fases (Descubrimiento → Guión → Compilación en Paralelo → Críticos en Paralelo → Iteración → Revisión Final → Entrega). Durante la Compilación en Paralelo, se generan simultáneamente dos opciones de video: una animada con Remotion y otra basada en diapositivas con Puppeteer y ffmpeg. Tras la compilación, dos personajes críticos (uno de negocios y otro técnico) evalúan cada opción y proporcionan puntuaciones y correcciones estructuradas. La habilidad itera automáticamente según los umbrales de calidad (puntuación ≥7.5 de 10 para ambos críticos) y puede escalar a un humano después de 3 iteraciones fallidas. Depende de herramientas externas como ElevenLabs para la generación de voces en off, Remotion o Puppeteer/ffmpeg para la representación de videos, y usa llamadas a la API de sesiones en paralelo (sessions_spawn) para la ejecución concurrente de los subagentes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mfrancime/trident-archive/tree/HEAD/repos/trident_cc-crossbeam_hackathon_project/.claude/skills/product-demo-video

Preguntar en tu IA favorita

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

Documentación

Video de Demostración del Producto

Genera videos de demostración de productos de 2 minutos para proyectos técnicos con opciones de compilación en paralelo y revisión estructurada de críticos.

Cuándo Usarlo

  • Para demostrar un repositorio de GitHub, una API o un producto técnico
  • Necesitas un video explicativo profesional rápidamente
  • Quieres múltiples enfoques (animado vs. simple)

Flujo de Trabajo (7 Fases)

DESCUBRIMIENTO → GUIÓN → COMPILACIÓN EN PARALELO → CRÍTICOS EN PARALELO → ITERACIÓN → FINAL → ENTREGA
       │            │              │                      │                 │           │         │
    5-10m       10-15m         30-60m                 10-15m            0-3 bucles   compuerta   enviar

Fase 1: Descubrimiento

Clonar y analizar el repositorio:

gh repo clone <owner/repo> /tmp/<repo>

Extraer:

  • Qué hace (1 oración)
  • Para quién es
  • 3-5 características clave
  • Arquitectura/flujo
  • Activos visuales (logotipos, diagramas)

Preguntar (o usar valores predeterminados):

PreguntaValor Predeterminado
Duración2 min
AudienciaMixta (técnica + negocios)
TonoProfesional y conversacional
FormatoExplicador animado

Fase 2: Guión

Usar la estructura de references/script-template.md:

Escena 1: Gancho (0:00-0:15) — Declaración del problema
Escena 2: Contexto (0:15-0:30) — Por qué esto importa
Escenas 3-5: Características (0:30-1:30) — 3 capacidades clave, 20s cada una
Escena 6: Técnica (1:30-1:50) — Arquitectura/credibilidad
Escena 7: CTA (1:50-2:00) — Qué hacer a continuación

Pautas:

  • 150 palabras/minuto
  • Máximo 20 palabras/oración
  • Voz activa
  • Concreto sobre vago

Fase 3: Compilación en Paralelo

Generar 2 subagentes para compilar opciones simultáneamente:

// Opción A: Remotion (animado)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Compilar video de demostración animado usando Remotion.

  Guión: [pegar guión]
  Voz: Usar ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Salida: /tmp/demo-video/option-a.mp4

  Enfoque:
  1. Generar voz en off por escena (API de ElevenLabs)
  2. Crear proyecto Remotion con componentes de escena
  3. Sincronizar animaciones con el tiempo del audio
  4. Renderizar a 1080p 30fps`
})

// Opción B: Diapositivas + ffmpeg (simple)
sessions_spawn({
  label: "demo-video-option-b",
  task: `Compilar video de demostración basado en diapositivas.

  Guión: [pegar guión]
  Voz: Usar ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Salida: /tmp/demo-video/option-b.mp4

  Enfoque:
  1. Generar voz en off (API de ElevenLabs)
  2. Crear diapositivas con Puppeteer (HTML → PNG)
  3. Combinar con ffmpeg, sincronizar con el audio
  4. Agregar transiciones simples`
})

Esperar ambas. Presentar opciones al usuario o seleccionar automáticamente según la calidad.


Fase 4: Críticos en Paralelo

Generar 2 personajes críticos (ver references/ para rúbricas completas):

// Crítico de Negocios
sessions_spawn({
  label: "critic-business",
  task: `Revisar video de demostración como Crítico de Negocios "Mike".

  Video: [ruta]
  Guión: [contenido]

  Ver references/critic-business.md para la persona y rúbrica completas.

  Puntuación: Claridad, Profesionalismo, Valor de Negocio (1-10 cada uno)
  Salida: Revisión estructurada con puntuación general y correcciones específicas.`
})

// Crítico Técnico
sessions_spawn({
  label: "critic-technical",
  task: `Revisar video de demostración como Crítico Técnico "Ingeniero Senior".

  Video: [ruta]
  Guión: [contenido]

  Ver references/critic-technical.md para la persona y rúbrica completas.

  Puntuación: Precisión Técnica, Credibilidad, Completitud (1-10 cada uno)
  Salida: Revisión estructurada con puntuación general y correcciones específicas.`
})

Fase 5: Iteración

Compuertas de calidad:

CompuertaAcción
Ambos críticos ≥7.5, sin problemas críticos→ Enviar
Cualquier crítico <7.0 O problema crítico→ Iterar
Después de 3 iteraciones, aún fallando→ Escalar a humano

Bucle de iteración:

  1. Recopilar todos los problemas Críticos/Importantes
  2. Corregir en orden de gravedad
  3. Volver a renderizar solo las escenas afectadas (si es posible)
  4. Volver a ejecutar críticos

Fase 6: Revisión Final

Antes de enviar, verificar:

  • Ambos críticos aprobaron (7.5+)
  • No quedan problemas críticos
  • Audio sincronizado correctamente
  • Todas las escenas se renderizan limpiamente
  • CTA es claro

Fase 7: Entrega

Salida:

✅ ¡Video de demostración completo!

📹 Video: demo-video-final.mp4 (2:03)
🎯 Audiencia: [objetivo]
📊 Puntuaciones: Negocios 8.2/10 | Técnico 7.8/10

Cubre:
1. [Punto clave 1]
2. [Punto clave 2]
3. [Punto clave 3]

Archivos guardados en: [ubicación]

Entregar a:

  • Canal de Slack (si se especifica)
  • Guardar en workspace/salidas/

Herramientas y Dependencias

HerramientaPropósitoRequerido
ElevenLabsGeneración de voz en offSí
RemotionMarco de trabajo de video React (Opción A)Una de A/B
ffmpegProcesamiento de video (Opción B)Una de A/B
PuppeteerCapturas de pantalla de diapositivas (Opción B)Una de A/B
sessions_spawnSubagentes en paraleloSí

Voz predeterminada: CcEB0ARKH8qIyzh2I1OR (Jeremy - Narrador de Tutoriales Técnicos)


Referencias de Archivos

  • references/critic-business.md — Persona y rúbrica del crítico de negocios
  • references/critic-technical.md — Persona y rúbrica del crítico técnico
  • references/script-template.md — Estructura de guión escena por escena
  • templates/remotion/ — Andamio del proyecto Remotion con componentes
  • scripts/generate-voiceover.py — Ayudante de TTS de ElevenLabs
  • scripts/render-slides.sh — Combinador de diapositivas a video con ffmpeg

Skills relacionados