Communitygithub.com

cgallic/kai-cmo-harness

Production vidéo complète, du script au rendu MP4. Combine la génération de scripts (optimisés pour TikTok/YouTube/Reels) avec le rendu vidéo par IA (Remotion), voix off IA (Qwen3-TTS/ElevenLabs), musique générée (ACE-Step) et enregistrement de démos navigateur. Suivi multi-session avec réconciliation automatique des intentions.

Qu'est-ce que kai-cmo-harness ?

Cette compétence permet de produire des vidéos professionnelles de bout en bout, depuis la rédaction d'un script jusqu'au rendu d'un fichier MP4 prêt à être publié. Elle est conçue pour les plateformes sociales (TikTok, YouTube, Reels) et prend en charge plusieurs types de contenu : démos produits, explainers, annonces, témoignages, et formats courts. Son fonctionnement repose sur un pipeline automatisé : génération de script via IA, création de voix off avec Qwen3-TTS (gratuit) ou ElevenLabs (premium), composition musicale avec ACE-Step, et rendu visuel via Remotion (Node.js). Le tout est orchestré par un système de suivi de projet multi-session qui conserve l'état dans `project.json` et se réconcilie automatiquement avec le système de fichiers. L'utilisateur peut choisir entre un mode script uniquement, une production automatisée complète, ou un mode hybride où il fournit certains éléments (démos, visuels). Le système impose des garde-fous stricts : validation humaine obligatoire avant le rendu final, analyse préalable des variantes du script (hooks, structure, CTA), vérification des assets et de la cohérence audio/visuelle. Les coûts cloud sont très faibles (environ 0,20 $ par vidéo de 60 à 90 secondes) grâce à l'utilisation privilégiée d'outils gratuits ou économiques (Qwen3, ACE-Step) et à Modal pour les GPU ponctuels. La compétence ne publie jamais directement sur les plateformes : le rendu final est déposé dans un dossier `out/`, la publication reste une étape séparée, humaine.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/kai-video-production — un MP4 rendu, né d'un script digne d'être produit

Note racine Kai : les chemins knowledge/, harness/ et scripts/ de cette compétence se trouvent dans l'installation Kai, pas dans le projet utilisateur. Résolvez-les par rapport au premier répertoire ancêtre de ce SKILL.md qui contient un dossier knowledge/ (la racine du plugin Kai, ~/.claude/kai, ou le dépôt kai-cmo-harness). MARKETING.md, memory/ et tous les fichiers de sortie se trouvent dans le projet courant. Si une commande scripts/ référencée n'est pas disponible dans cette installation, dites-le, ignorez-la et continuez avec les instructions basées sur les fichiers — n'inventez jamais sa sortie.

Spots motion de qualité studio (spot de lancement dynamique généré par code, visite guidée à partir de captures d'écran réelles, ou vidéos « pain point » pour un site, avec la coupe nette jusqu'à la révélation) utilisent /kai-motion-spot. Cette compétence couvre la production de templates Remotion.

Objectif

Une vidéo terminée : un script approuvé, les assets nécessaires, l'audio synchronisé, et un MP4 rendu aux spécifications de la plateforme — avec project.json décrivant l'état réel du projet sur le disque afin que la session suivante reprenne sans reconstruction.

La production amplifie un bon script et ne peut pas sauver un mauvais. La qualité du script est réglée avant la génération de tout asset. Le périmètre se divise en trois : script uniquement (s'arrêter au script, l'utilisateur enregistre), production automatisée (pipeline de rendu complet), hybride (générer la voix off et les diapositives, l'utilisateur fournit les démos).

Fait quand

Type de travail social-post — seuil E5/C2/O3 (harness/eco-floors.yaml), contrat harness/skill-contracts/social-post.yaml. Un rendu destiné à être diffusé en tant que contenu publicitaire payant suit plutôt paid-ad-campaign (E5/C4/O4), ce qui nécessite que la référence de politique de la plateforme soit chargée avant la soumission de la création.

  • E5 — la vidéo est en ligne sur la plateforme cible et une personne non impliquée a lu le permalien par rapport au montage approuvé. Le MP4 dans out/ est E1 ; l'approbation humaine de la variante gagnante et du montage final est E3. Cette compétence effectue le rendu ; elle ne met pas en ligne.
  • C2 — banned_word_check et four_us_score (10/16) propres sur le script, plus les deux listes de contrôle de rendu ci-dessous.
  • O3 — portée, taux d'engagement, clics sur le profil et clics sur le lien lus à partir des insights de la plateforme à 7 jours par rapport à une référence enregistrée avant la publication.

Avant le rendu : script approuvé avec des accroches fortes et sans contenu IA médiocre · tous les assets présents, aucune démo ou image manquante · les durées des scènes correspondent à la narration · voix off alignée sur les visuels · couleurs, polices et logo de la marque corrects · transitions fluides · contraste et taille du texte lisibles · aperçu parcouru dans Remotion Studio.

Après le rendu : résolution conforme · voix off audible par-dessus la musique · taille du fichier dans les limites de la plateforme · format lisible sur la plateforme cible.

Contraintes

  • L'approbation humaine est requise pour passer du laboratoire de variantes au rendu complet. Les rendus coûtent du temps de calcul et du temps ; un concept non approuvé n'en obtient aucun.

  • Le laboratoire de variantes préliminaire s'exécute avant la création d'assets ou le rendu — 3 variantes d'accroche (chacune avec plateforme, premier visuel attendu et promesse pour le spectateur), 2 variantes de structure pour l'ordre des scènes ou le rythme, 2 variantes de CTA adaptées à l'objectif de la campagne, et 1 note de risque par variante couvrant les allégations non fondées, les incohérences avec la marque ou les besoins d'approbation. Écrire dans workspace/video/projects/{name}/PREFLIGHT-VARIANTS.md, choisir une gagnante, conserver les variantes rejetées dans le même fichier comme liste des éliminées.

    FacteurScoreQuestion
    Force de l'accroche1-5L'ouverture crée-t-elle une attention immédiate ?
    Clarté du message1-5L'idée principale est-elle évidente après un visionnage ?
    Densité de preuve1-5Les allégations sont-elles étayées par une démo, une citation, des données ou une source ?
    Adéquation à la production1-5Cela peut-il être réalisé avec les assets et le calendrier disponibles ?
    Sécurité de la marque1-5Évite-t-il l'autorité usurpée, les allégations risquées ou les droits peu clairs ?
  • Lire MARKETING.md à la racine du projet avant de demander quoi que ce soit à l'utilisateur. S'il n'existe pas, le construire à partir de la base de code — CLAUDE.md, README.md, PROJECT.md, package.json, pages d'accueil, configuration email/pub/analytique — en utilisant le template de /kai-email-system, et confirmer le brouillon.

  • Connaître ces éléments avant de produire : sujet, plateformes, format (talking head, enregistrement d'écran, images secondaires, animation, diapositives), fourchette de durée, objectif, et si l'utilisateur veut un script uniquement ou un rendu complet.

  • Le système de fichiers est la source de vérité. En reprise, analyser le répertoire du projet, comparer avec project.json, et corriger les statuts — asset-needed avec le fichier présent devient asset-present ; ready avec le fichier manquant devient asset-missing. Signaler chaque divergence à l'utilisateur plutôt que de faire le rendu en contournant le problème. Régénérer le document de statut CLAUDE.md du projet après la réconciliation.

  • Les profils de marque s'appliquent automatiquement. Les couleurs, polices et logo proviennent de brands/{brand}/brand.json ; les réglages vocaux de voice.json. Ne jamais spécifier à nouveau une couleur ou une police en ligne que le fichier de marque définit déjà.

  • Les prérequis sont de véritables blocages : Node.js 18+ (Remotion) et FFmpeg (encodage) sont requis. Les fonctionnalités d'IA cloud nécessitent un compte Modal (30 $/mois de calcul gratuit) ou RunPod (paiement à la seconde) ; ElevenLabs est optionnel pour les voix premium. /video-setup gère la configuration. Si un outil n'est pas déployé dans cette installation, dites-le — ne décrivez jamais une sortie qu'il n'a pas produite.

  • Privilégier l'outil gratuit ou économique. Qwen3-TTS et ACE-Step couvrent la plupart des travaux ; les fournisseurs premium sont un choix explicite, pas une valeur par défaut.

  • Rien n'est publié. Le rendu atterrit dans out/ ; la mise en ligne est une étape distincte et approuvée.

Contexte

BesoinCharger / exécuter
Mécanismes de création de contenu vidéoknowledge/playbooks/video-content-creation.md
TikTok · YouTube · Reelsknowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md
Polissage de la conception scène-diapositiveknowledge/frameworks/design/frontend-design.md
Produit, ICP, voix, canauxMARKETING.md (racine du projet)
Configuration, enregistrement, audio, révision, conception, clonage/video-setup · /record-demo · /generate-voiceover · /scene-review · /design · /voice-clone

Templates : product-demo (titre, problème, solution, démo, CTA) · explainer (titre, aperçu, sections, récapitulatif) · demo-walkthrough (enregistrement d'écran avec narration) · social-short (15–60s vertical) · testimonial (citation + visuels) · announcement (lancements, versions, actualités). Le matériel de référence est livré à côté — templates/product-demo/, templates/explainer/, templates/social-short/, et des exemples terminés dans examples/digital-samba-skill-demo/ et examples/schlumbergera/, chacun avec la source, le MP4 rendu et des notes de production.

Structure du projet :

projects/{name}/
├── project.json          # état, scènes, assets, sessions
├── VOICEOVER-SCRIPT.md   # narration complète
├── src/                  # Root.tsx, scenes/, config/ (timing, marque, assets)
├── public/               # audio/, demos/, images/, videos/
└── CLAUDE.md             # statut généré automatiquement

project.json contient name, template, brand, created, updated, phase, un tableau scenes[] (id, type, duration, visual, narration, status), un bloc audio (voiceover : fichier/statut/fournisseur/intervenant ; music : fichier/statut/préréglage), estimates.totalDurationSeconds, et un journal sessions[] de date, phase et résumé. Cycle de vie : planning → assets → review → audio → editing → rendering → complete.

Types de scènes : title · overview · demo · split-demo · problem · solution · feature · stats · testimonial · cta · credits.

Assets. Les diapositives (cartes de titre, puces, visualisations de statistiques, écrans CTA) sont générées à partir du profil de marque. Les démos proviennent de /record-demo (enregistrement navigateur Playwright, --script demo-script.md --auto pour l'automatisation scriptée), d'un MP4/MOV externe déposé dans public/demos/, ou de captures d'écran Playwright. Images : python tools/flux2.py --prompt "..." --cloud modal pour la génération, python tools/image_edit.py --input photo.jpg --style ... pour l'édition.

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   # aussi : pop, success

Intervenants Qwen3 : Ryan, Brad, Ava, Lily, Emily, Sam, Alex, Kevin, Zoe. Préréglages musicaux : corporate-bg, upbeat-intro, dramatic-reveal, ambient-subtle, tension-build, inspirational-montage, tech-minimal, celebration-end. /voice-clone produit une voix de marque personnalisée.

Fichiers de marque. brand.json : colors (primary #3B82F6, secondary #10B981, background #111827, text #F9FAFB dans l'exemple KaiCalls), fonts.heading / fonts.body (famille + poids), logo, style. voice.json : provider, speaker, tone, pace et un bloc elevenlabs (voice_id, stability, similarity_boost).

Transitions — 7 personnalisées plus 4 officielles Remotion, importées depuis @/lib/transitions :

TransitionEffetCas d'usage
glitch()Distorsion numérique + décalage RVBEsthétique tech
rgbSplit()Aberration chromatiqueCoupes énergiques
zoomBlur()Flou de mouvement radialRévélations dramatiques
lightLeak()Reflet de lentille cinématographiquePolissage professionnel
clockWipe()Apparition radialeContenu basé sur le temps
pixelate()Mosaïque numériqueRétro/8-bit
checkerboard()Apparition en grille (9 motifs)Propre, géométrique
slide() fade() wipe() flip()Remotion officielStandard, subtil, directionnel, ludique

Révision et rendu.

cd projects/{name} && npm run studio     # Remotion Studio sur localhost:3000
npm run render -- --quality=low          # aperçu
npm run render                           # final → out/{name}.mp4

Options de rendu : --codec=h264 (défaut) ou h265 (plus petit) · --resolution=1080p (défaut) ou 720p · --fps=30 (défaut) ou 60. Les réglages de timing se trouvent dans config.ts.

Post-production : tools/addmusic.py (ajouter de la musique à un MP4 existant) · tools/redub.py (changer la voix) · tools/dewatermark.py --preset sora --cloud modal · tools/upscale.py --scale 2x --cloud modal.

GPU Cloud. Modal se déploie via /video-setup : qwen3_tts (~0,01 $/vidéo), flux2 (~0,02 $/image), music_gen (~0,05 $/piste), sadtalker (~0,10 $/vidéo), ltx2 (~0,23 $/clip), image_edit (~0,03 $/image), upscale (~0,01 $/image), dewatermark (~0,10 $/vidéo). RunPod est l'alternative au paiement à la seconde (python tools/<tool>.py --setup par outil). Une vidéo de 60 à 90 secondes coûte environ 0,20 $ tout compris — script ~0,10 $, voix off Qwen3 ~0,01 $, musique ACE-Step ~0,05 $, images FLUX.2 ~0,04 $, rendu local Remotion 0,00 $. Premium ajoute : voix off ElevenLabs +0,30 $, clip LTX-2 +0,23 $, SadTalker +0,10 $. Le niveau gratuit Starter de Modal couvre 100+ vidéos/mois.

Sortie vers workspace/video/ : _video-projects.md (index), projects/{name}/ (avec out/{name}.mp4), scripts/ divisés par tiktok/, youtube/, reels/, et _production-guide.md.

Points d'entrée : /kai-video script --platform tiktok --topic "..." (script uniquement) · /kai-video produce --template product-demo --brand kaicalls (pipeline complet) · /kai-video resume {name}. En aval : /kai-repurpose pour les extraits, /kai-social pour la planification, /kai-content-calendar pour le calendrier de publication, /kai-analytics pour les performances.

Échecs courants : « asset not found » — les chemins de project.json ne correspondent pas au système de fichiers, réconcilier · « audio out of sync » — ajuster le timing dans config.ts ou régénérer la voix off par rapport au script actuel · « render fails » — vérifier ffmpeg -version, confirmer que les assets existent, exécuter d'abord un aperçu basse qualité · « tool timeout on Modal » — vérifier les crédits de calcul et modal app list, ou revenir à RunPod · « brand colors not applied » — brand.json manquant dans brands/, nom de marque différent dans project.json, ou src/config/brand.ts nécessite une régénération.

Escalader quand

  • Le gagnant du laboratoire de variantes n'a pas été approuvé et l'étape suivante consommerait du rendu ou du calcul GPU.
  • Les images de démo montrent des données client, une interface utilisateur tierce ou tout élément dont les droits ne sont pas confirmés.
  • Une affirmation dans la narration nécessite un chiffre sans source.
  • La réconciliation trouve des assets que le projet n'attendait pas, ou des assets attendus qui ont disparu.
  • Les prérequis sont manquants (pas de Node 18+, pas de FFmpeg, pas d'outils cloud déployés) et l'utilisateur s'attend à un fichier rendu.
  • La vidéo est destinée à un emplacement publicitaire payant — la référence de politique de la plateforme et le seuil paid-ad-campaign s'appliquent avant la soumission.

Individual skills in this repo

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

Skills associés