Communitygithub.com

reels-templates

Créez en un seul passage une Reel 9:16 ou une annonce TikTok à partir de séquences, de photos ou d'un brief, en utilisant quinze modèles Remotion prêts à l'emploi inclus dans cette compétence.

Qu'est-ce que reels-templates ?

Cette compétence permet aux agents autonomes de générer des vidéos verticales courtes (Reels Instagram, annonces TikTok) au format 9:16, 60 images par seconde, à l'aide de quinze modèles Remotion prêts à l'emploi. Elle est conçue pour fonctionner sans surveillance : l'agent choisit un modèle, remplit ses propriétés dans un fichier JSON, puis lance le rendu. La compétence prend en charge deux catégories de modèles : les formats natifs sociaux (ChatStory, NotesList, SearchHook, NotificationStack, PolaroidDump, Ranking, PollSticker) qui imitent une interface utilisateur familière, et les formats publicitaires (BeatCutAd, UgcCaptions, Listicle, BeforeAfter, ProductSlideshow, Testimonial, CommentReply, OfferPromo) qui mettent la séquence en avant. Elle inclut l'internationalisation (i18n) et des règles strictes pour la zone sécurisée, le placement du texte, et la vérification par images clés avant rendu final. L'agent est invité à prendre toutes les décisions de manière autonome, en se basant sur les instructions du brief, et à signaler uniquement les blocages techniques.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

Demander à votre IA préférée

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

Documentation

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.

  1. Vérifiez les outils : Node.js 18 ou plus récent (node -v), et ffmpeg et ffprobe dans 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.
  2. Si le dossier de travail contient déjà reels/render.mjs, utilisez cet espace de travail et passez à la section 1.
  3. Sinon, copiez le dossier assets/reels-kit/ de cette compétence vers reels/ dans le dossier de travail (par exemple cp -R <skill-dir>/assets/reels-kit reels), puis exécutez npm install dans reels/.
  4. Créez les dossiers reels/public/ (médias) et reels/jobs/_local/ (tâches temporaires). Si le dossier de travail est un dépôt git, ajoutez reels/node_modules/, reels/public/, reels/out/, reels/exports/ et reels/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èleUtilisez-le quandA besoin de
ChatStoryUne histoire racontée comme une conversation par messages textes, puis la révélation du produitMessages (+ une photo du produit à envoyer), séquences de révélation
NotesListUne 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
SearchHookLa question du client tapée dans une barre de recherche, répondue par la séquenceUne requête (+ suggestions), 1+ séquences
NotificationStackÉcran verrouillé se remplissant de commandes, messages, avis : preuve sociale et FOMO1 à 6 notifications, arrière-plan, séquences de révélation
PolaroidDumpAlbum photo de type scrapbook avec légendes manuscrites2 à 8 photos
RankingClassement à l'aveugle : les éléments tombent dans une liste numérotée, #1 en dernier2 à 6 séquences, une étiquette et un rang pour chacune
PollStickerUn sondage dans une story superposé à une séquence : deux options, un appui, le résultatUne question, 2 options avec pourcentages, séquences

Formats publicitaires (séquence d'abord, texte par-dessus)

ModèleUtilisez-le quandA besoin de
BeatCutAdPar défaut pour une annonce produit coupée à partir d'une séquence : plusieurs plans, accroche, CTA1+ séquences vidéo
UgcCaptionsUne personne parle à la caméra ; légendes mot par mot1 séquence avec parole + timings des mots
Listicle« 3 raisons pour lesquelles », conseils, fonctionnalités, étapes2 à 7 séquences, une par point
BeforeAfterUne transformation ou comparaison (mode : wipe ou split)2 séquences ou photos
ProductSlideshowSeules des photos produit existent, ou un catalogue rapide ; autocollant de prix optionnel2+ photos ou séquences
TestimonialPreuve sociale : cartes d'avis avec étoiles1 séquence d'arrière-plan + textes d'avis
CommentReplyRépondre à une objection ou FAQ ; la bulle de commentaire est l'accroche1+ séquences + le commentaire
OfferPromoVente, code de réduction, date limite1+ 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

  1. Choisissez le nom de la tâche (minuscules, chiffres et -, par exemple xmas-ornament). C'est le name du fichier de tâche, le dossier d'entrée reels/public/<name>/ et le dossier de sortie reels/exports/<name>/. Copiez uniquement les fichiers utilisés par cette tâche dans reels/public/<name>/ et laissez les originaux là où ils sont. Notez dans le rapport d'où vient chaque entrée et si la copie dans public/ est la seule (fichiers téléchargés ou générés). Écrivez chaque src comme <name>/<file>. Exécutez ffprobe sur 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.
  2. 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.
  3. Lisez reels/jobs/examples/<Template>.json. Il liste chaque propriété que ce modèle prend. Copiez-le vers reels/jobs/<job>.json et modifiez-le. Utilisez reels/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ères duration secondes, 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) et box sont des styles publicitaires forts. caption est 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) }. transition est 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 duration du 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 * speed ne doit pas dépasser la fin de la source. La durée de la vidéo est la somme des durées des clips (BeforeAfter utilise duration ; Testimonial correspond 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.tsx d'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, puis clips (la révélation) apparaissent et le CTA s'affiche par-dessus. Leur durée est la partie interface plus les clips. Laissez hook de côté : la carte remplit la zone sécurisée. background est le média atténué derrière la carte.
  • ChatStory : les messages s'auto-rythment en fonction du temps de lecture ; définissez at (secondes) uniquement pour forcer un temps. Un message peut comporter image (une photo du produit) au lieu de text, ou avec text.
  • NotesList : check: true coche une ligne après qu'elle est tapée, highlight: true la marque. Mettez la ligne du produit en dernier.
  • SearchHook : pick est la suggestion qui est sélectionnée. Gardez la requête sous 34 caractères.
  • NotificationStack : icon est un emoji, color sa couleur de tuile. Traduisez now et date par langue.
  • PolaroidDump : les photos de forme carrée fonctionnent le mieux. title est manuscrit ; les légendes restent sous 20 caractères. Il n'y a pas de clips : les photos sont la vidéo.
  • Ranking : items se 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 valeurs percent sont à 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 : words sont { 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. keepAudio est par défaut à true. Un « mot » peut être une courte phrase avec wordsPerPage: 1.
  • CommentReply et OfferPromo : laissez hook de 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 sur middle.
  • ProductSlideshow : badge prend \n pour deux lignes ; placez-le avec badgeBand.

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.

Skills associés