/kai-video-production — un MP4 renderizado que empezó como un guion que merecía ser renderizado
Nota raíz de Kai: las rutas
knowledge/,harness/yscripts/de esta skill viven en la instalación de Kai, no en el proyecto del usuario. Resuélvelas contra el primer directorio ancestro de este SKILL.md que contenga una carpetaknowledge/(la raíz del plugin Kai,~/.claude/kaio el repositorio kai-cmo-harness).MARKETING.md,memory/y cualquier archivo de salida viven en el proyecto actual. Si un comando descripts/referenciado no está disponible en esta instalación, dilo, omítelo y continúa con la guía basada en archivos. Nunca inventes su salida.
Spots de movimiento de estudio (un spot de lanzamiento hype renderizado con código, un recorrido a partir de capturas de pantalla reales o videos de puntos débiles para un sitio, con el corte de caída a la revelación) usan
/kai-motion-spot. Esta skill cubre la producción de plantillas Remotion.
Objetivo
Un video terminado: un guion aprobado, los activos que necesita, audio sincronizado y un MP4 renderizado según las especificaciones de la plataforma, con project.json describiendo el estado real del proyecto en disco para que la siguiente sesión se reanude sin reconstrucción.
La producción amplifica un buen guion y no puede rescatar uno malo. La calidad del guion se decide antes de generar cualquier activo. El alcance se divide en tres: solo guion (se detiene en el guion, el usuario graba), producción automatizada (pipeline de renderizado completo) e híbrido (generar voz en off y diapositivas, el usuario proporciona las demos).
Listo cuando
Tipo de trabajo social-post — mínimo E5/C2/O3 (harness/eco-floors.yaml), contrato harness/skill-contracts/social-post.yaml. Un render que se ejecutará como creativo publicitario sigue paid-ad-campaign (E5/C4/O4), que requiere cargar la referencia de la política de la plataforma antes de enviar el creativo.
- E5 — el video está en vivo en la plataforma de destino y un no actor leyó el enlace permanente contra el corte aprobado. El MP4 en
out/es E1; la aprobación humana de la variante ganadora y el corte final es E3. Esta skill renderiza; no sube. - C2 —
banned_word_checkyfour_us_score(10/16) limpios en el guion, más ambas listas de verificación de renderizado a continuación. - O3 — alcance, tasa de interacción, clics en el perfil y clics en enlaces leídos desde los insights de la plataforma a los 7 días contra una línea base registrada antes de publicar.
Antes de renderizar: guion aprobado con ganchos fuertes y sin contenido AI slop · todos los activos presentes, sin demos o imágenes faltantes · las duraciones de las escenas coinciden con la narración · voz en off alineada con los elementos visuales · colores, fuentes y logotipo de la marca correctos · transiciones suaves · contraste y tamaño del texto legibles · vista previa recorrida en Remotion Studio.
Después de renderizar: resolución según lo especificado · voz en off audible sobre la música · tamaño del archivo dentro de los límites de la plataforma · formato reproducible en la plataforma de destino.
Restricciones
-
Se requiere aprobación humana para pasar del laboratorio de variantes al renderizado completo. Los renderizados cuestan tiempo y cómputo; un concepto no aprobado no obtiene ninguno.
-
El laboratorio de variantes de verificación previa se ejecuta antes de la creación de activos o el renderizado — 3 variantes de gancho (cada una con plataforma, primer fotograma visual esperado y promesa al espectador), 2 variantes de estructura para el orden de las escenas o el ritmo, 2 variantes de CTA alineadas con el objetivo de la campaña y 1 nota de riesgo por variante que cubra afirmaciones no respaldadas, desajuste de marca o necesidades de aprobación. Escribir en
workspace/video/projects/{name}/PREFLIGHT-VARIANTS.md, elegir un ganador, mantener las variantes rechazadas en el mismo archivo como lista de descartes.Factor Puntuación Pregunta Fuerza del gancho 1-5 ¿La apertura crea atención inmediata? Claridad del mensaje 1-5 ¿La idea central es obvia después de una visualización? Densidad de prueba 1-5 ¿Las afirmaciones están respaldadas por demo, cita, datos o fuente? Adecuación a la producción 1-5 ¿Se puede hacer esto con los activos y el cronograma disponibles? Seguridad de la marca 1-5 ¿Evita autoridad falsa, afirmaciones riesgosas o derechos no claros? -
Lee
MARKETING.mdde la raíz del proyecto antes de preguntar algo al usuario. Si no existe, constrúyelo a partir del código base — CLAUDE.md, README.md, PROJECT.md, package.json, páginas de destino, configuración de correo/anuncios/analítica — usando la plantilla de/kai-email-system, y confirma el borrador. -
Conoce estos datos antes de producir: tema, plataformas, formato (talking head, grabación de pantalla, b-roll, animación, diapositivas), rango de duración, objetivo y si el usuario quiere solo guion o un render completo.
-
El sistema de archivos es la fuente de verdad. Al reanudar, escanea el directorio del proyecto, compara con
project.jsony corrige estados —asset-neededcon el archivo presente se convierte enasset-present;readycon el archivo faltante se convierte enasset-missing. Señala cada discrepancia al usuario en lugar de renderizar ignorándola. Regenera el documento de estadoCLAUDE.mddel proyecto después de la conciliación. -
Los perfiles de marca se aplican automáticamente. Los colores, fuentes y logotipo provienen de
brands/{brand}/brand.json; la configuración de voz devoice.json. Nunca vuelvas a especificar un color o fuente en línea que el archivo de marca ya defina. -
Los prerrequisitos son bloqueadores reales: se requieren Node.js 18+ (Remotion) y FFmpeg (codificación). Las funciones de IA en la nube necesitan una cuenta de Modal ($30/mes de cómputo gratuito) o RunPod (pago por segundo); ElevenLabs es opcional para voces premium.
/video-setupmaneja la configuración. Si una herramienta no está implementada en esta instalación, dilo — nunca describas una salida que no produjo. -
Preferir la herramienta gratuita o económica. Qwen3-TTS y ACE-Step cubren la mayoría del trabajo; los proveedores premium son una elección explícita, no un valor predeterminado.
-
Nada se publica. El renderizado termina en
out/; la subida es un paso separado y aprobado.
Contexto
| Necesidad | Cargar / ejecutar |
|---|---|
| Mecánica de creación de contenido de video | knowledge/playbooks/video-content-creation.md |
| TikTok · YouTube · Reels | knowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md |
| Pulido de diseño de escenas de diapositivas | knowledge/frameworks/design/frontend-design.md |
| Producto, ICP, voz, canales | MARKETING.md (raíz del proyecto) |
| Configuración, grabación, audio, revisión, diseño, clonación | /video-setup · /record-demo · /generate-voiceover · /scene-review · /design · /voice-clone |
Plantillas: product-demo (título, problema, solución, demo, CTA) · explainer (título, descripción general, secciones, resumen) · demo-walkthrough (grabación de pantalla con narración) · social-short (15–60s vertical) · testimonial (cita + imágenes) · announcement (lanzamientos, versiones, noticias). El material de referencia se envía junto a ellas — templates/product-demo/, templates/explainer/, templates/social-short/ y ejemplos terminados en examples/digital-samba-skill-demo/ y examples/schlumbergera/, cada uno con fuente, MP4 renderizado y notas de producción.
Estructura del proyecto:
projects/{name}/
├── project.json # estado, escenas, activos, sesiones
├── VOICEOVER-SCRIPT.md # narración completa
├── src/ # Root.tsx, scenes/, config/ (tiempo, marca, activos)
├── public/ # audio/, demos/, images/, videos/
└── CLAUDE.md # estado generado automáticamente
project.json contiene name, template, brand, created, updated, phase, un array scenes[] (id, type, duration, visual, narration, status), un bloque audio (voz en off: archivo/estado/proveedor/locutor; música: archivo/estado/preajuste), estimates.totalDurationSeconds y un registro sessions[] de fecha, fase y resumen. Ciclo de vida: planning → assets → review → audio → editing → rendering → complete.
Tipos de escena: title · overview · demo · split-demo · problem · solution · feature · stats · testimonial · cta · credits.
Activos. Las diapositivas (tarjetas de título, viñetas, visualizaciones de estadísticas, pantallas de CTA) se generan a partir del perfil de marca. Las demos provienen de /record-demo (grabación de navegador con Playwright, --script demo-script.md --auto para automatización con script), un MP4/MOV externo colocado en public/demos/ o capturas de pantalla de Playwright. Imágenes: python tools/flux2.py --prompt "..." --cloud modal para generación, python tools/image_edit.py --input photo.jpg --style ... para edición.
Audio.
python tools/voiceover.py --provider qwen3 --speaker Ryan --script VOICEOVER-SCRIPT.md --scene-dir public/audio/scenes --json
python tools/voiceover.py --provider elevenlabs --voice-id {ID} --script VOICEOVER-SCRIPT.md
python tools/music_gen.py --preset corporate-bg --duration 120 --bpm 90 --key "D Minor"
python tools/music.py --prompt "Upbeat corporate" --duration 120
python tools/sfx.py --preset whoosh # también: pop, success
Locutores Qwen3: Ryan, Brad, Ava, Lily, Emily, Sam, Alex, Kevin, Zoe. Preajustes de música: corporate-bg, upbeat-intro, dramatic-reveal, ambient-subtle, tension-build, inspirational-montage, tech-minimal, celebration-end. /voice-clone produce una voz de marca personalizada.
Archivos de marca. brand.json: colors (primary #3B82F6, secondary #10B981, background #111827, text #F9FAFB en el ejemplo KaiCalls), fonts.heading / fonts.body (family + weight), logo, style. voice.json: provider, speaker, tone, pace y un bloque elevenlabs (voice_id, stability, similarity_boost).
Transiciones — 7 personalizadas más 4 oficiales de Remotion, importadas desde @/lib/transitions:
| Transición | Efecto | Caso de uso |
|---|---|---|
glitch() | Distorsión digital + desplazamiento RGB | Estética tecnológica |
rgbSplit() | Aberración cromática | Cortes enérgicos |
zoomBlur() | Desenfoque de movimiento radial | Revelaciones dramáticas |
lightLeak() | Destello de lente cinematográfico | Pulido profesional |
clockWipe() | Revelación con barrido radial | Contenido basado en tiempo |
pixelate() | Mosaico digital | Retro/8-bit |
checkerboard() | Revelación en cuadrícula (9 patrones) | Limpio, geométrico |
slide() fade() wipe() flip() | Remotion oficial | Estándar, sutil, direccional, divertido |
Revisión y renderizado.
cd projects/{name} && npm run studio # Remotion Studio en localhost:3000
npm run render -- --quality=low # vista previa
npm run render # final → out/{name}.mp4
Opciones de renderizado: --codec=h264 (predeterminado) o h265 (más pequeño) · --resolution=1080p (predeterminado) o 720p · --fps=30 (predeterminado) o 60. Los ajustes de tiempo están en config.ts.
Postproducción: tools/addmusic.py (añadir música a un MP4 existente) · tools/redub.py (cambiar voz) · tools/dewatermark.py --preset sora --cloud modal · tools/upscale.py --scale 2x --cloud modal.
GPU en la nube. Modal se despliega mediante /video-setup: qwen3_tts ($0.01/video), flux2 ($0.02/imagen), music_gen ($0.05/pista), sadtalker ($0.10/video), ltx2 ($0.23/clip), image_edit ($0.03/imagen), upscale ($0.01/imagen), dewatermark ($0.10/video). RunPod es la alternativa de pago por segundo (python tools/<tool>.py --setup por herramienta). Un video de 60–90s cuesta aproximadamente $0.20 en total — guion ~$0.10, voz en off Qwen3 ~$0.01, música ACE-Step ~$0.05, imágenes FLUX.2 ~$0.04, renderizado local de Remotion $0.00. Premium añade: voz en off ElevenLabs +$0.30, clip LTX-2 +$0.23, SadTalker +$0.10. El nivel gratuito Starter de Modal cubre más de 100 videos/mes.
Salida va a workspace/video/: _video-projects.md (índice), projects/{name}/ (con out/{name}.mp4), scripts/ dividido en tiktok/, youtube/, reels/ y _production-guide.md.
Puntos de entrada: /kai-video script --platform tiktok --topic "..." (solo guion) · /kai-video produce --template product-demo --brand kaicalls (pipeline completo) · /kai-video resume {name}. Aguas abajo: /kai-repurpose para clips, /kai-social para programación, /kai-content-calendar para tiempos de lanzamiento, /kai-analytics para rendimiento.
Fallos comunes: "asset not found" — las rutas de project.json no coinciden con el sistema de archivos, conciliar · "audio out of sync" — ajustar el tiempo en config.ts o regenerar la voz en off contra el guion actual · "render fails" — comprobar ffmpeg -version, confirmar que los activos existen, ejecutar una vista previa de baja calidad primero · "tool timeout on Modal" — comprobar créditos de cómputo y modal app list, o recurrir a RunPod · "brand colors not applied" — brand.json falta en brands/, el nombre de la marca no coincide en project.json, o src/config/brand.ts necesita regenerarse.
Escalar cuando
- El ganador del laboratorio de variantes no ha sido aprobado y el siguiente paso consumiría cómputo de renderizado o GPU.
- El metraje de la demo muestra datos del cliente, interfaz de terceros o cualquier cosa cuyos derechos no estén confirmados.
- Una afirmación en la narración necesita un número sin fuente.
- La conciliación encuentra activos que el proyecto no esperaba, o activos esperados que desaparecieron.
- Los prerrequisitos faltan (no hay Node 18+, no hay FFmpeg, no hay herramientas en la nube desplegadas) y el usuario espera un archivo renderizado.
- El video está destinado a una colocación pagada — la referencia de la política de la plataforma y el mínimo
paid-ad-campaignse aplican antes del envío.