Communitygithub.com

compétence-remotion-shorts

Montre à un agent comment planifier, construire ou découper une « compétence Remotion Shorts » afin que le résultat concret soit une vidéo finie. La procédure traverse la compétence Remotion Shorts : 0. Configuration (une fois par machine), 1. Demander ce dont vous avez besoin (un message, ignorer ce qui est déjà connu). Utilisez-la lorsqu'une nouvelle mission fait appel à ce savoir-faire.

Qu'est-ce que compétence-remotion-shorts ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor ou Codex) de créer des vidéos courtes (shorts) au format vertical (1080x1920) pour TikTok, Reels et YouTube Shorts à l'aide de Remotion, le framework de rendu vidéo programmatique. L'agent n'écrit pas de code Remotion ; il rédige un script sous forme de fichier JSON de scènes, que le projet Remotion pré-emballé utilise pour générer la vidéo. La compétence inclut la configuration initiale (téléchargement de ~400 Mo de dépendances une fois par machine), la rédaction du script à partir d'une source ou d'un sujet fourni par l'utilisateur, la vérification du rendu via des planches de contrôle (stills), le rendu final en MP4, la publication via l'API WoopSocial (avec validation utilisateur) et le rapport final. Elle gère les thèmes visuels, la musique, les légendes, les avertissements de qualité (texte trop long, hors délai) et les cas particuliers comme les textes RTL/CJK ou les comptes multiples. L'agent doit suivre un processus en six étapes : configuration, collecte des consignes, écriture du script, vérification, rendu et publication, rapport.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SadiTLM/agentic-reels-studio/tree/HEAD/skills/remotion-shorts-skill

Demander à votre IA préférée

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

Documentation

Compétence Remotion Shorts

Vous écrivez un court métrage (short) sous forme de fichier JSON de scènes. Le projet Remotion pré-emballé dispose les mots, chronomètre chaque scène en fonction de la vitesse de lecture, maintient le texte à l'intérieur de la zone non couverte par les boutons d'application, génère une planche de contrôle, une couverture et le MP4 ; l'utilisateur peut ensuite le publier avec WoopSocial.

Vous n'écrivez pas de code Remotion pour chaque vidéo. Les modèles sont fixes et testés ; votre travail est le script : ce que chaque écran affiche, dans quel ordre et à quelle vitesse.

0. Configuration (une fois par machine)

Nécessite Node 20 ou plus récent. Vérifiez avec node -v ; s'il manque, envoyez l'utilisateur sur https://nodejs.org. Remotion prend en charge macOS 15 ou plus récent, Windows x64 et Linux avec glibc 2.35+ (Ubuntu 22.04, Debian 12 ou plus récent).

node <skill-dir>/scripts/setup.mjs remotion-shorts

Ceci copie le projet dans ./remotion-shorts, installe les packages épinglés (environ 260 Mo) et télécharge le navigateur sans tête avec lequel Remotion effectue le rendu (100 à 150 Mo). La première fois, cela prend 1 à 3 minutes. Exécutez-le à nouveau après une mise à jour de la compétence : il rafraîchit les fichiers modèles (ceux que l'utilisateur a modifiés sont conservés sous forme de .bak) et ne touche jamais à leurs scripts, ressources ou fichiers de sortie.

Licence. Remotion est gratuit pour les particuliers et les entreprises de 3 personnes maximum. Les entreprises de 4 personnes ou plus ont besoin d'une licence d'entreprise Remotion, et le rendu à partir de scripts est considéré comme de l'automatisation (remotion.pro/license). Si l'utilisateur effectue un rendu pour une entreprise plus grande, informez-le une fois, clairement, avant le premier rendu.

1. Demander ce dont vous avez besoin (un seul message, ignorer ce qui est déjà connu)

  • Le matériel. Un sujet, un article, une URL, des notes, des données, un journal des modifications ou une liste. Vous n'écrivez que des faits que vous pouvez citer. Si l'utilisateur donne un sujet sans source, trouvez une source primaire (statistiques officielles, documentation, journal des modifications du produit) et nommez-la.
  • À qui cela s'adresse et le point clé. Un short dit une seule chose.
  • L'apparence. Un thème (ink, paper, volt, ocean, clean) ou leurs couleurs de marque, et un pseudo pour l'écran de fin.
  • Audio. Les effets sonores intégrés sont activés par défaut (un impact sur l'accroche, un whoosh à chaque coupe, un pop sur les éléments mis en évidence, des tics pour les décomptes) ; ils sont conçus pour ce modèle et sans danger sur toutes les applications. Musique uniquement à partir d'un fichier dont ils ont les droits d'utilisation (voir references/writing-shorts.md pour savoir pourquoi aucune bibliothèque gratuite n'est sûre sur les trois applications).
  • Où cela va. TikTok, Reels, Shorts ou les trois.

2. Écrire le script

Lisez references/writing-shorts.md avant le premier script d'une session. La version courte :

  • La scène 1 est une accroche qui énonce le bénéfice en environ 10 mots ou moins : un chiffre, une affirmation ou la promesse d'une liste (« 5 outils gratuits qui remplacent... »). Elle est entièrement à l'écran dès l'image 0. Si l'accroche contient un chiffre, placez-le dans big pour qu'il soit la première chose que l'œil voit.
  • Une idée par scène. Une scène est un temps fort, pas un paragraphe. Les scènes de statistiques portent un chiffre et ce qu'il signifie. Les éléments d'une liste décomptent ou comptent ; dites-le dans l'accroche.
  • Une information réelle dans chaque scène. Une vidéo textuelle modélisée sans rien de nouveau est ce que YouTube appelle un contenu inauthentique et Instagram un contenu non original. Ne faites jamais de remplissage.
  • Les chiffres sont exacts et sourcés. Mettez la source dans footer (« Données : USGS »). N'arrondissez jamais un chiffre pour changer une affirmation.
  • Terminez par une action ou une phrase qui ramène à l'accroche pour que la boucle semble continue. Pas de « merci d'avoir regardé ».
  • Durée : 15 à 45 secondes est l'objectif ; le moteur de rendu prévient au-delà de 59.

Écrivez short.json dans le dossier du projet. Le format complet, chaque type de scène et chaque option se trouvent dans references/short-json.md. Un script minimal :

{
  "theme": "ink",
  "footer": "Data: USGS",
  "handle": "@yourhandle",
  "scenes": [
    { "type": "hook", "big": "2.5%", "text": "of Earth's water is fresh" },
    { "type": "stat", "value": "96.5", "suffix": "%", "label": "is salt water in the oceans" },
    { "type": "stat", "value": "68.7", "suffix": "%", "label": "of the fresh water is ice and glaciers", "highlight": "ice and glaciers" },
    { "type": "end", "text": "Save this for trivia night", "highlight": "Save this" }
  ]
}

3. Vérifier avant le rendu vidéo

cd remotion-shorts
node render.mjs short.json --stills

En quelques secondes, cela affiche le plan (secondes et taille de police par scène) et écrit :

  • out/short/sheet.jpg : la dernière image de chaque scène (tout ce qui est à l'écran), avec les zones de sécurité marquées par une fine ligne pointillée (le texte doit rester à l'intérieur).
  • out/short/cuts.jpg : l'image 0 et les images autour de chaque coupe, pour vérifier le mouvement.
  • out/short/cover.jpg : l'accroche une fois qu'elle a atterri (téléchargez-la comme couverture des Reels).
  • out/short/report.json : minutages, sauts de ligne et avertissements.

Ouvrez les deux planches et regardez-les. Vérifiez : chaque scène est-elle lisible à la taille d'un téléphone, chacune dit-elle une chose, les surbrillances sont-elles sur les mots importants, rien ne semble-t-il à l'étroit, l'ordre est-il correct, et l'image 0 montre-t-elle l'accroche complète. Corrigez le JSON et relancez --stills jusqu'à ce que vous le publieriez.

Les avertissements arrêtent le rendu vidéo (code de sortie 2) : texte trop long pour un écran, accroche trop longue, surbrillance qui n'est pas dans le texte, scène trop rapide à lire, rythme en dehors de 0,85 à 1,25, ou short de plus de 59 secondes. Corrigez le script ; utilisez --force uniquement lorsque l'utilisateur a vu l'avertissement et le souhaite quand même. Certains problèmes sont des erreurs que --force ne peut pas outrepasser, comme un mot trop large pour l'écran, quelle que soit sa taille : ceux-ci mettraient le texte hors écran.

4. Rendu

node render.mjs short.json

Écrit out/short/short.mp4 : 1080x1920, 30 fps, H.264, yuv420p, AAC (piste silencieuse lorsqu'il n'y a pas de musique), ce que TikTok, Reels et Shorts acceptent tous. Un short de 30 secondes s'affiche en environ une minute sur un ordinateur portable récent. Les machines avec 8 Go de mémoire rendent 2 images à la fois ; si un rendu est toujours interrompu par manque de mémoire, relancez-le avec --concurrency 1.

Avant de le montrer, saisissez trois images et regardez-les (début, milieu, fin), ou lisez-le si votre client le peut. Montrez ensuite à l'utilisateur la couverture, la planche et le chemin du MP4.

Plusieurs comptes : ne publiez jamais le même fichier sur plusieurs comptes. Créez une variante par compte (une accroche, un thème ou un ordre de scène différent, enregistré sous son propre JSON) afin qu'aucun compte ne publie un contenu quasi identique.

5. Publier (WoopSocial, avec confirmation)

Lisez references/woopsocial.md. En bref :

  1. social_accounts_list pour trouver les comptes (connectez-les d'abord si nécessaire).
  2. Pour TikTok, social_accounts_get_platform_inputs pour le compte : les options de confidentialité et la vidéo la plus longue autorisée. L'utilisateur choisit la confidentialité ; il n'y a pas de valeur par défaut.
  3. Téléchargement : media_uploads_create_session avec la taille exacte en octets de report.json, enregistrez la réponse sous session.json, exécutez node upload.mjs session.json out/short/short.mp4, puis media_uploads_complete_session jusqu'à ce qu'il soit READY.
  4. Écrivez la légende par plateforme (TikTok et Reels : une ligne qui ajoute à la vidéo plus 3 à 5 hashtags spécifiques ; YouTube : un titre de moins de 100 caractères plus une description). Utilisez contentOverride pour le texte par plateforme.
  5. posts_validate, puis montrez à l'utilisateur : comptes, légende par plateforme, confidentialité, heure de planification avec fuseau horaire, la couverture. Attendez un « oui » clair. Ensuite posts_create et posts_get.

Champs de divulgation : isYourBrand: true sur TikTok lorsque le short fait la promotion du propre produit de l'utilisateur ; isAiGeneratedContent uniquement pour les images, vidéos ou voix IA réalistes (le texte cinétique n'en a pas besoin). YouTube madeForKids est une déclaration légale : demandez, ne devinez jamais.

6. Rapport

Montrez : le chemin du MP4, la durée, la planche, l'endroit où il a été publié (liens de posts_get) ou la planification, et tout ce que vous n'avez pas pu faire. N'inventez jamais de vues ou de résultats ; lisez-les plus tard avec social_account_posts_list et rapportez la date de leur collecte.

Modifier l'apparence

  • Couleurs de marque : passez theme sous forme d'objet (bg, fg, accent, accentText, font, uppercase). Maintenez le contraste du texte à 7:1 ou mieux ; vérifiez également l'accent sur l'arrière-plan.
  • Photos ou vidéos derrière les scènes : image par scène ou background pour l'ensemble du short. Elles sont atténuées sous la couleur du thème pour que le texte reste lisible. Utilisez des fichiers que l'utilisateur possède ou pour lesquels il a une licence, et créditez-les dans la légende lorsque la licence le demande.
  • Polices fournies : Anton (condensée, majuscule, percutante), Poppins, Inter. Toutes sous licence OFL.
  • Pour modifier les modèles eux-mêmes, modifiez src/Short.tsx et prévisualisez avec npm run studio.

Cas particuliers

  • Pas de source pour un chiffre : ne l'utilisez pas. Dites ce qui manque.
  • Texte qui ne tient pas : divisez la scène ; ne réduisez pas la police en dessous du seuil minimal (le moteur de rendu ne le fera pas).
  • Texte de droite à gauche ou CJK, ou emoji : les polices fournies ne les couvrent pas et ils peuvent apparaître sous forme de boîtes vides. Dites-le et laissez-les de côté (les emoji peuvent aller dans la légende).
  • L'utilisateur veut un son tendance : les publications API ne peuvent pas en ajouter un. Publiez sur TikTok avec postMode: MEDIA_UPLOAD pour qu'il atterrisse dans sa boîte de réception TikTok afin de terminer dans l'application.
  • Le rendu échoue sous Linux en raison de bibliothèques manquantes : installez les packages listés dans references/platform-specs.md.
  • Windows : passez toujours les propriétés dans le fichier JSON, jamais en ligne sur la ligne de commande.

Barre de qualité

Avant de déclarer la tâche terminée, elle doit satisfaire à tous ces critères :

  • L'image 0 montre l'accroche complète (vérifiez cuts.jpg) ; environ 10 mots ou moins, énonçant le bénéfice.
  • Chaque scène dit une seule chose ; aucune scène ne dépasse environ 14 mots.
  • Chaque chiffre correspond à sa source ; la source est à l'écran ou dans la légende.
  • Aucun avertissement, ou l'utilisateur les a vus et a choisi --force.
  • Les deux planches vérifiées : aucun texte en dehors de la ligne de sécurité en pointillés, surbrillances sur les bons mots.
  • 15 à 59 secondes.
  • Une version distincte pour chaque compte.
  • L'utilisateur a confirmé avant que quoi que ce soit ne soit publié.

Skills associés