Modèles de Reels
Quinze modèles Remotion pilotés par les données (1080x1920, 60 ips) sont fournis avec cette compétence dans assets/reels-kit/. Une vidéo est un fichier JSON de tâche : choisissez un modèle, remplissez ses propriétés, lancez le rendu. Vous n'écrivez pas de code React pour une tâche normale.
Les chemins ci-dessous qui commencent par reels/ se trouvent dans le dossier de travail, pas dans cette compétence. Ne modifiez jamais les fichiers dans le dossier de la compétence pour une tâche.
S'exécute sans surveillance. Cette compétence est conçue pour les agents autonomes. Le demandeur est celui qui a lancé la tâche : un agent coordinateur, un pipeline ou une personne. Prenez chaque décision avec les règles de ce fichier et ne vous arrêtez jamais pour demander une approbation. Arrêtez-vous seulement en cas de blocage que vous ne pouvez pas résoudre (outil manquant, média manquant ou illisible, rendu qui continue d'échouer) et signalez-le. Chaque tâche se termine par un rapport (section 4).
0. Configurer l'espace de travail
À faire une fois par projet, avant la première tâche.
- Vérifiez les outils : Node.js 18 ou plus récent (
node -v), etffmpegetffprobedans le PATH. Si l'un manque, arrêtez-vous et signalez-le comme un blocage. N'installez pas de logiciel système vous-même. - Si le dossier de travail contient déjà
reels/render.mjs, utilisez cet espace de travail et passez à la section 1. - Sinon, copiez le dossier
assets/reels-kit/de cette compétence versreels/dans le dossier de travail (par exemplecp -R <skill-dir>/assets/reels-kit reels), puis exécuteznpm installdansreels/. - Créez les dossiers
reels/public/(médias) etreels/jobs/_local/(tâches temporaires). Si le dossier de travail est un dépôt git, ajoutezreels/node_modules/,reels/public/,reels/out/,reels/exports/etreels/jobs/_local/à son.gitignore.
L'espace de travail contient render.mjs (effectue le rendu d'une tâche), clean.mjs (libère de l'espace disque, voir section 6), src/ (modèles et kit partagé), jobs/examples/ (un exemple de tâche par modèle), public/<name>/ (médias d'entrée de chaque tâche), out/stills/ (images de contrôle) et exports/<name>/ (vidéos terminées de chaque tâche).
Préférences
Ce dépôt ne contient le goût de personne. Le style de texte, la police, la couleur d'accentuation, le ton du texte, les langues, la musique et le format à utiliser en priorité proviennent du brief du demandeur et de ce que vous savez déjà de la marque, jamais d'une valeur écrite dans les modèles ou ce fichier. Lorsque le brief énonce une préférence, appliquez-la dans le fichier de tâche. Lorsqu'il ne le fait pas, utilisez les valeurs par défaut du modèle et listez-les dans le rapport. N'écrivez pas la préférence d'une personne ou d'une marque dans les modèles, les exemples de tâches ou cette compétence.
1. Choisir le modèle
Commencez par l'ensemble natif social lorsque la vidéo doit donner l'impression d'avoir été postée par une personne. Utilisez l'ensemble publicitaire lorsque la séquence elle-même porte la vidéo.
Natif social (une interface que le spectateur connaît déjà est l'accroche)
| Modèle | Utilisez-le quand | A besoin de |
|---|---|---|
ChatStory | Une histoire racontée comme une conversation par messages textes, puis la révélation du produit | Messages (+ une photo du produit à envoyer), séquences de révélation |
NotesList | Une liste de notes qui s'écrit elle-même : « les cadeaux qui ont raté vs celui qu'elle a gardé » | Titre + 1 à 7 lignes, séquences de révélation |
SearchHook | La question du client tapée dans une barre de recherche, répondue par la séquence | Une requête (+ suggestions), 1+ séquences |
NotificationStack | Écran verrouillé se remplissant de commandes, messages, avis : preuve sociale et FOMO | 1 à 6 notifications, arrière-plan, séquences de révélation |
PolaroidDump | Album photo de type scrapbook avec légendes manuscrites | 2 à 8 photos |
Ranking | Classement à l'aveugle : les éléments tombent dans une liste numérotée, #1 en dernier | 2 à 6 séquences, une étiquette et un rang pour chacune |
PollSticker | Un sondage dans une story superposé à une séquence : deux options, un appui, le résultat | Une question, 2 options avec pourcentages, séquences |
Formats publicitaires (séquence d'abord, texte par-dessus)
| Modèle | Utilisez-le quand | A besoin de |
|---|---|---|
BeatCutAd | Par défaut pour une annonce produit coupée à partir d'une séquence : plusieurs plans, accroche, CTA | 1+ séquences vidéo |
UgcCaptions | Une personne parle à la caméra ; légendes mot par mot | 1 séquence avec parole + timings des mots |
Listicle | « 3 raisons pour lesquelles », conseils, fonctionnalités, étapes | 2 à 7 séquences, une par point |
BeforeAfter | Une transformation ou comparaison (mode : wipe ou split) | 2 séquences ou photos |
ProductSlideshow | Seules des photos produit existent, ou un catalogue rapide ; autocollant de prix optionnel | 2+ photos ou séquences |
Testimonial | Preuve sociale : cartes d'avis avec étoiles | 1 séquence d'arrière-plan + textes d'avis |
CommentReply | Répondre à une objection ou FAQ ; la bulle de commentaire est l'accroche | 1+ séquences + le commentaire |
OfferPromo | Vente, code de réduction, date limite | 1+ séquences + l'offre |
Si le brief ne correspond à aucun d'entre eux, voir la section 7. Ne déformez pas un modèle pour qu'il soit ce qu'il n'est pas.
La compétence officielle Remotion (remotion-best-practices, installée séparément avec npx skills add remotion-dev/skills --skill remotion-best-practices) est la référence pour écrire du code Remotion. Si elle n'est pas installée, utilisez la documentation Remotion sur https://www.remotion.dev/docs. Pour réaliser une vidéo dans ce dépôt, cette compétence l'emporte là où elles diffèrent : créez un fichier de tâche au lieu d'un nouveau projet ou d'une composition, vérifiez les images fixes au lieu d'ouvrir Studio, et effectuez le rendu avec render.mjs une fois que les images fixes sont validées, sans attendre d'y être invité.
2. Construire la tâche
- Choisissez le nom de la tâche (minuscules, chiffres et
-, par exemplexmas-ornament). C'est lenamedu fichier de tâche, le dossier d'entréereels/public/<name>/et le dossier de sortiereels/exports/<name>/. Copiez uniquement les fichiers utilisés par cette tâche dansreels/public/<name>/et laissez les originaux là où ils sont. Notez dans le rapport d'où vient chaque entrée et si la copie danspublic/est la seule (fichiers téléchargés ou générés). Écrivez chaquesrccomme<name>/<file>. Exécutezffprobesur chaque fichier pour sa durée. Les médias ne sont jamais commités :public/est ignoré par git, donc les chemins dans les exemples de tâches (footage.mp4,music.m4a,demo/…) sont des espaces réservés jusqu'à ce que vous mettiez vos propres fichiers. - Examinez les séquences avant de placer le texte : extrayez une image par plan (
ffmpeg -ss <t> -i <file> -frames:v 1) et notez où se trouve le produit. - Lisez
reels/jobs/examples/<Template>.json. Il liste chaque propriété que ce modèle prend. Copiez-le versreels/jobs/<job>.jsonet modifiez-le. Utilisezreels/jobs/_local/pour une tâche qui doit rester hors de git.
Fichier de tâche :
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<lang> est fusionné avec props, il ne contient donc que les chaînes traduites. Les tableaux d'objets fusionnent élément par élément (null conserve l'élément de base) ; les tableaux de chaînes remplacent.
Propriétés partagées par tous les modèles :
hook:{ lines (1-3), band, size, duration }. Affiché à partir de 0 s, durée par défaut 2,2 s.cta:{ lines, button, band, size, duration }. Affiché pendant les dernièresdurationsecondes, par défaut 2,5. Les autres légendes se terminent quand il commence.music:{ src, volume }. S'éteint à la fin. Utilisez environ 0,15 sous la parole.brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }.outline(par défaut) etboxsont des styles publicitaires forts.captionest le style de légende native dans l'application : texte blanc en casse classique dans une seule boîte arrondie sombre, en haut de sa bande, apparaissant progressivement ; écrivez-le comme une ligne d'histoire à la première personne, 2 lignes de 30 caractères maximum.- Un clip :
{ src, start (s dans la source), duration (s à l'écran), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }.transitionest la façon dont ce clip arrive.
Un clip prend également une caméra simulée : zoom (1-2,5, zoom avant qui maintient le point focus en place), tilt (degrés, -15 à 15, un angle hollandais) et push (0-0,6, la caméra avance avec un court flou lorsque le clip arrive, puis se stabilise).
Une propriété que la tâche omet est désactivée : une tâche sans hook n'a pas d'accroche, quoi que montre l'exemple.
src est un chemin dans public/ ou une URL https. Un .jpg/.png/.webp obtient un zoom avant lent au lieu d'être joué.
3. Règles
- Zone sécurisée. Tout le texte reste dans x 140-940, y 288-1248. Les modèles appliquent cela via trois bandes :
top(y 288-600),middle(600-930),lower(930-1248). Vous choisissez uniquement la bande. - Gardez le texte hors du produit à moins que le brief ne le souhaite dessus. Choisissez chaque bande à partir des images que vous avez extraites. Si chaque bande couvre le produit dans un plan, raccourcissez la
durationdu texte ou changez le plan. - Lignes courtes. Le texte se réduit pour tenir dans 800 px, donc une longue ligne devient petite. Visez 22 caractères latins ou 12 caractères japonais par ligne. Encadrez un mot avec
*astérisques*pour le colorer avec la couleur d'accentuation. - Durées des clips.
start + duration * speedne doit pas dépasser la fin de la source. La durée de la vidéo est la somme des durées des clips (BeforeAfterutiliseduration;Testimonialcorrespond aux avis plus le CTA). - Coupez sur le rythme lorsqu'il y a de la musique : faites en sorte que les durées des clips s'additionnent pour correspondre aux positions des temps.
- Polices. Le latin, le vietnamien (montserrat ou anton, et toutes les cartes d'interface) et le japonais fonctionnent. Le coréen, le thaï, l'arabe et d'autres nécessitent d'ajouter une police dans
reels/src/lib/kit.tsxd'abord.
Peu de clips statiques, plusieurs angles. Lorsque la séquence est composée d'un ou deux plans fixes et que le brief demande un montage rapide multi-angles (une visite de showroom ou un montage sur une tendance de danse), utilisez BeatCutAd et réutilisez chaque source plusieurs fois avec un focus, zoom, tilt et push différents : commencez par un plan large (zoom environ 1,02), puis un détail par temps (texte, personnage, nom, mains, ourlet), alternez le signe de tilt, conservez zoom à 1,7 ou moins sur les sources 768 px, et terminez par un plan large. Utilisez des transitions cut ; le push est la transition. Cela recadre la séquence ; cela ne peut pas créer un véritable nouvel angle de caméra.
Notes sur les modèles :
ChatStory,NotesList,NotificationStack: l'interface se joue d'abord, puisclips(la révélation) apparaissent et le CTA s'affiche par-dessus. Leur durée est la partie interface plus les clips. Laissezhookde côté : la carte remplit la zone sécurisée.backgroundest le média atténué derrière la carte.ChatStory: les messages s'auto-rythment en fonction du temps de lecture ; définissezat(secondes) uniquement pour forcer un temps. Un message peut comporterimage(une photo du produit) au lieu detext, ou avectext.NotesList:check: truecoche une ligne après qu'elle est tapée,highlight: truela marque. Mettez la ligne du produit en dernier.SearchHook:pickest la suggestion qui est sélectionnée. Gardez la requête sous 34 caractères.NotificationStack:iconest un emoji,colorsa couleur de tuile. Traduiseznowetdatepar langue.PolaroidDump: les photos de forme carrée fonctionnent le mieux.titleest manuscrit ; les légendes restent sous 20 caractères. Il n'y a pas de clips : les photos sont la vidéo.Ranking:itemsse jouent dans l'ordre écrit, donc écrivez le rang le plus bas en premier et le rang 1 en dernier. Les étiquettes restent sous 20 caractères.PollSticker: les valeurspercentsont à définir par vous ; utilisez des nombres réels lorsque le brief en contient et ne présentez jamais de valeurs inventées comme des données d'enquête.- Rédigez le texte dans ces interfaces comme les gens textent et postent : les minuscules conviennent, les lignes courtes, un emoji là où une personne en utiliserait un. Les noms, messages et avis qu'elles contiennent sont illustratifs sauf si le brief en fournit de réels, ne les attribuez donc pas à des personnes réelles.
UgcCaptions:wordssont{ text, start, end }en secondes sur la timeline de sortie. Obtenez-les à partir d'une transcription avec des timestamps de mots ; ne devinez pas les timings.keepAudioest par défaut à true. Un « mot » peut être une courte phrase avecwordsPerPage: 1.CommentReplyetOfferPromo: laissezhookde côté. La bulle ou le titre utilise déjà la bande supérieure.OfferPromo: le CTA par défaut se trouve dans la bande inférieure.Testimonial: définissez la bande du CTA surmiddle.ProductSlideshow:badgeprend\npour deux lignes ; placez-le avecbadgeBand.
4. Vérifier, puis effectuer le rendu
Exécutez ces commandes depuis reels/.
node render.mjs jobs/<job>.json --still=1,6,12 --guides # bandes de zone sécurisée dessinées par-dessus
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json # chaque langue -> exports/<name>/
Les images fixes vont dans out/stills/ à la moitié de la taille. Ouvrez-les et vérifiez : le texte est hors du produit, rien n'est coupé, chaque langue tient. Choisissez des temps d'image fixe à l'intérieur de l'accroche, d'une légende intermédiaire et du CTA. Les fichiers nommés _GUIDES servent uniquement à la vérification ; ne les remettez jamais comme résultat.
Effectuez le rendu des vidéos uniquement après que les images fixes sont validées. Si une image fixe échoue, corrigez la tâche et vérifiez à nouveau ; après trois cycles échoués, signalez-le comme un blocage. Un rendu imprime une ligne par fichier avec son chemin et sa durée. Ne publiez ni ne téléchargez les vidéos sauf si le brief le demande.
Terminez chaque tâche par un rapport au demandeur. Il couvre :
- les chemins et durées de sortie ;
- le modèle et les valeurs par défaut utilisées là où le brief était silencieux ;
- la source de chaque entrée et si
public/contient la seule copie ; - ce que le nettoyage de la section 6 a supprimé, et l'espace libéré.
5. Taille Instagram
Les rendus sont d'environ 16 Mbps. Pour en compresser un en vue du téléchargement :
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. Médias et espace disque
Les médias sont ce qui remplit le disque. Les entrées (séquences, photos, musique copiées dans public/<name>/) et les sorties (vidéos dans exports/<name>/, environ 30 Mo par langue pour 15 s) appartiennent toutes à une tâche, sous le même nom. Gardez-les ainsi, car le nettoyage fonctionne par tâche. Tout le reste est temporaire : les images de contrôle QA dans out/, et les bundles temporaires que Remotion écrit dans le dossier temporaire du système (chacun contient une copie complète de public/ ; render.mjs supprime les siens, mais les exécutions plantées et Studio en laissent certains). Le cache webpack dans node_modules/.cache atteint plusieurs centaines de Mo. node_modules/ (environ 1,3 Go, y compris le navigateur sans tête) est un coût unique. Rerendre une tâche écrase ses fichiers sous les mêmes noms, donc les rendus répétés d'une même tâche ne s'accumulent pas.
Si reels/clean.mjs est manquant (l'espace de travail a été créé à partir d'un kit plus ancien), copiez d'abord clean.mjs et render.mjs depuis assets/reels-kit/ de cette compétence vers reels/.
Exécutez ces commandes depuis reels/, jamais pendant qu'un rendu est en cours :
node clean.mjs --auto --keep=<nombre de tâches récentes>
clean.mjs supprime les images de contrôle, les bundles temporaires et le cache, puis libère de l'espace en supprimant les dossiers de tâches les plus anciens (entrées et sorties) jusqu'à ce qu'il ne reste que les <nombre> tâches les plus récentes. Si une tâche n'a pas de sortie, elle est supprimée en premier. Le script imprime ce qu'il a supprimé et l'espace libéré.
7. Ajouter un modèle
Si le brief exige un nouveau modèle (aucun modèle existant ne correspond au brief), créez-le dans reels/src/templates/ en suivant les règles de la compétence Remotion officielle (remotion-best-practices ou la documentation). Ajoutez un exemple de fichier de tâche dans reels/jobs/examples/. Ajoutez une ligne dans le tableau de la section 1. Effectuez le rendu de l'exemple au moins dans une langue et vérifiez les images fixes avant de l'utiliser pour un travail. Signalez le nouveau modèle dans le rapport.
N'ajoutez jamais de modèle basé sur un format qui existe déjà. Si le brief peut être réalisé avec un modèle existant, utilisez celui-ci.
8. Jobstudio et guidance IA
Cette compétence fonctionne avec le planificateur de la commande Claude Skill (Jobstudio) : exécutez npx skills jobstudio start et donnez un brief en langage naturel. Le planificateur crée le fichier de tâche, extrait les images, vérifie les images fixes et lance le rendu. Toutes les règles ci-dessus s'appliquent.
Lorsque vous créez manuellement une tâche, mettez-la dans reels/jobs/<job>.json. Pour les tâches Jobstudio, mettez le fichier dans reels/jobs/_local/ afin qu'il reste hors de git.