Communitygithub.com

cgallic/kai-cmo-harness

Producción de video full-stack, desde el guion hasta el video renderizado. Combina generación de guiones (optimizados para TikTok/YouTube/Reels) con renderizado impulsado por IA usando Remotion, voces en off por IA (Qwen3-TTS/ElevenLabs), generación de música (ACE-Step) y grabación de demos en el navegador. Seguimiento de proyectos multi-sesión con conciliación automática de intenciones. Úsalo cuando se solicite 'crear video', 'producir video', 'demo video', 'product video' o cualquier petición para generar Y renderizar contenido de video.

¿Qué es kai-cmo-harness?

Esta skill proporciona un pipeline completo de producción de video, desde la redacción del guion hasta la entrega de un archivo MP4 renderizado. Su objetivo es transformar un guion aprobado en un video final listo para plataformas como TikTok, YouTube y Reels, asegurando que todos los activos (voces en off, música, demos e imágenes) estén sincronizados y de acuerdo con las especificaciones de la plataforma. La skill está diseñada para ser utilizada con asistentes de IA como Claude Code o Cursor. Se integra con herramientas como Remotion para renderizado, Qwen3-TTS y ElevenLabs para voces en off, y ACE-Step para generación de música. También admite la grabación de demos de navegador mediante Playwright. El flujo de trabajo incluye un laboratorio de variantes para validar conceptos antes de la producción completa, conciliación automática del estado de los archivos entre sesiones y la aplicación de perfiles de marca predefinidos para colores, tipografías y logotipos. Los proyectos se organizan en el sistema de archivos con una estructura estándar (project.json, scripts, activos públicos) y la skill garantiza que el estado del proyecto en disco sea la fuente de verdad. También verifica los prerrequisitos técnicos (Node.js 18+, FFmpeg) y guía al usuario a través de la configuración de herramientas en la nube como Modal o RunPod. El resultado final es un video listo para publicar, pero la skill no realiza la subida; esa es una acción separada y aprobada. Es útil para desarrolladores y creadores que necesitan un flujo de trabajo de producción de video automatizado, repetible y de alta calidad, con control granular sobre cada paso y la capacidad de reanudar proyectos en múltiples sesiones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgallic/kai-cmo-harness/tree/HEAD/harness/skills-v2/kai-video-production

Preguntar en tu IA favorita

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

Documentación

/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/ y scripts/ 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 carpeta knowledge/ (la raíz del plugin Kai, ~/.claude/kai o el repositorio kai-cmo-harness). MARKETING.md, memory/ y cualquier archivo de salida viven en el proyecto actual. Si un comando de scripts/ 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_check y four_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.

    FactorPuntuaciónPregunta
    Fuerza del gancho1-5¿La apertura crea atención inmediata?
    Claridad del mensaje1-5¿La idea central es obvia después de una visualización?
    Densidad de prueba1-5¿Las afirmaciones están respaldadas por demo, cita, datos o fuente?
    Adecuación a la producción1-5¿Se puede hacer esto con los activos y el cronograma disponibles?
    Seguridad de la marca1-5¿Evita autoridad falsa, afirmaciones riesgosas o derechos no claros?
  • Lee MARKETING.md de 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.json y corrige estados — asset-needed con el archivo presente se convierte en asset-present; ready con el archivo faltante se convierte en asset-missing. Señala cada discrepancia al usuario en lugar de renderizar ignorándola. Regenera el documento de estado CLAUDE.md del 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 de voice.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-setup maneja 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

NecesidadCargar / ejecutar
Mecánica de creación de contenido de videoknowledge/playbooks/video-content-creation.md
TikTok · YouTube · Reelsknowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md
Pulido de diseño de escenas de diapositivasknowledge/frameworks/design/frontend-design.md
Producto, ICP, voz, canalesMARKETING.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ónEfectoCaso de uso
glitch()Distorsión digital + desplazamiento RGBEstética tecnológica
rgbSplit()Aberración cromáticaCortes enérgicos
zoomBlur()Desenfoque de movimiento radialRevelaciones dramáticas
lightLeak()Destello de lente cinematográficoPulido profesional
clockWipe()Revelación con barrido radialContenido basado en tiempo
pixelate()Mosaico digitalRetro/8-bit
checkerboard()Revelación en cuadrícula (9 patrones)Limpio, geométrico
slide() fade() wipe() flip()Remotion oficialEstá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-campaign se aplican antes del envío.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados