/kai-video-production — un MP4 rendu, né d'un script digne d'être produit
Note racine Kai : les chemins
knowledge/,harness/etscripts/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 dossierknowledge/(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 commandescripts/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_checketfour_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.Facteur Score Question Force de l'accroche 1-5 L'ouverture crée-t-elle une attention immédiate ? Clarté du message 1-5 L'idée principale est-elle évidente après un visionnage ? Densité de preuve 1-5 Les allégations sont-elles étayées par une démo, une citation, des données ou une source ? Adéquation à la production 1-5 Cela peut-il être réalisé avec les assets et le calendrier disponibles ? Sécurité de la marque 1-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-neededavec le fichier présent devientasset-present;readyavec le fichier manquant devientasset-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 statutCLAUDE.mddu 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 devoice.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-setupgè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
| Besoin | Charger / exécuter |
|---|---|
| Mécanismes de création de contenu vidéo | knowledge/playbooks/video-content-creation.md |
| TikTok · YouTube · Reels | knowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md |
| Polissage de la conception scène-diapositive | knowledge/frameworks/design/frontend-design.md |
| Produit, ICP, voix, canaux | MARKETING.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 :
| Transition | Effet | Cas d'usage |
|---|---|---|
glitch() | Distorsion numérique + décalage RVB | Esthétique tech |
rgbSplit() | Aberration chromatique | Coupes énergiques |
zoomBlur() | Flou de mouvement radial | Révélations dramatiques |
lightLeak() | Reflet de lentille cinématographique | Polissage professionnel |
clockWipe() | Apparition radiale | Contenu basé sur le temps |
pixelate() | Mosaïque numérique | Rétro/8-bit |
checkerboard() | Apparition en grille (9 motifs) | Propre, géométrique |
slide() fade() wipe() flip() | Remotion officiel | Standard, 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-campaigns'appliquent avant la soumission.