Communitygithub.com

nntenzo/msl

Utilisez cette compétence lorsque vous devez créer une vidéo promotionnelle, de produit, de démonstration, explicative, thématique, multi-plans, storyboardée, pour les réseaux sociaux/Reels/TikTok, pour une entreprise locale, un restaurant/food vlog ou une vidéo éditée de 20 secondes ou plus — soit pour le projet en cours, soit pour un sujet fourni par l'utilisateur.

Qu'est-ce que msl ?

Cette compétence automatisée pour les agents IA génère des vidéos promotionnelles, de démonstration, explicatives et autres contenus vidéo édités complets en utilisant le framework Remotion. Elle prend en charge à la fois les promotions de projets (mettant en avant une application ou une fonctionnalité existante dans l'espace de travail) et les promotions de sujets (création de contenu vidéo sur un thème ou concept fourni par l'utilisateur, sans nécessiter de code existant). Le flux de travail guide l'agent à travers l'initialisation d'un projet Remotion, la classification du sujet, la rédaction d'un storyboard détaillé, la génération de narration (TTS), de musique de fond et d'actifs visuels, et le rendu de la vidéo finale dans différentes orientations (paysage, portrait, carré). Des contrôles de conformité stricts sont appliqués pour éviter les affirmations trompeuses, les marques non autorisées, les contenus sensibles et les appels à l'action trompeurs. La sortie finale est un fichier MP4 de haute qualité, validé et prêt à être exporté.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nntenzo/msl/tree/HEAD/.atoms/skills/promo-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

Quand utiliser

Utilisez cette compétence lorsque l'utilisateur demande une vidéo promotionnelle, une vidéo de produit, une vidéo de démonstration, une vidéo marketing, une vidéo de lancement, une vidéo explicative, une vidéo de marque, une vidéo conçue, une vidéo multi-plans, une vidéo storyboardée, une vidéo sociale/Reels/TikTok, une vidéo pour entreprise locale, une vidéo de style restaurant/food vlog, une vidéo éditée de 20 secondes ou plus, ou toute vidéo complète qui présente un sujet visuellement.

Privilégiez ce flux de travail Remotion chaque fois que la demande décrit une vidéo éditée complète avec chronologie, plans, sous-titres, audio, langage de caméra, style visuel, exigences de cohérence, CTA/carte de fin ou plusieurs scènes — même si l'utilisateur ne dit jamais « promo » ou « promotionnelle ». Utilisez la génération vidéo IA directe uniquement pour un seul court clip source ou une boucle d'arrière-plan, et non comme chemin de livraison final pour une vidéo multi-plans complète.

Le sujet de la vidéo peut être :

  1. Promotion de projet — un projet, une application ou une fonctionnalité que l'agent lui-même est en train de construire ou qui existe déjà dans l'espace de travail, ou une autre application existante déjà identifiée dans la demande de l'utilisateur ou dans le contexte confirmé antérieur. Résolvez d'abord l'application source promue. app/promo est le projet vidéo de sortie, pas automatiquement l'application source.
  2. Promotion de sujet — un sujet, concept, marque ou sujet externe fourni par l'utilisateur qui ne nécessite pas de projet dans l'espace de travail. Exemples : « le Système solaire », « l'histoire de la dynastie Song », « qu'est-ce qu'une base de données vectorielle ».

Les deux chemins partagent le même modèle Remotion, les mêmes préréglages de composition et les mêmes commandes de rendu. Seule la rédaction du storyboard diffère.

Commande

Utilisez RemotionPromoRenderer.render pour l'exportation finale de la promo après validation. Cette commande est documentée par cette compétence et peut être appelée même si elle n'est pas listée dans <Available Commands>.

<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>

Classification du sujet

Avant toute autre chose, classifiez le sujet à partir de la demande originale de l'utilisateur. Ne demandez pas à l'utilisateur de clarifier si la demande nomme déjà un sujet ou un projet.

  • Si le message de l'utilisateur nomme un sujet/concept externe clair (par exemple « créer une vidéo promotionnelle sur le système solaire ») et que l'espace de travail n'a pas de app/frontend ou de code d'application à promouvoir → promotion de sujet.
  • Si le message de l'utilisateur fait référence à une construction app/frontend existante, à une application en cours que l'agent a générée, ou à une fonctionnalité à venir → promotion de projet.
  • Si les deux s'appliquent (par exemple « créez une promo pour notre application explicative sur le système solaire ») → traitez l'application comme primaire et utilisez le sujet comme sujet secondaire ; c'est une promotion de projet.

Les promotions de sujet sont de première classe. Ne rejetez pas et ne bloquez pas une promotion de sujet simplement parce qu'il n'y a pas de app/frontend dans l'espace de travail.

Pour les promotions de projet, résolvez l'identité de l'application source avant de lire le code. L'application source peut être l'application actuelle de l'espace de travail, une application construite plus tôt dans la même conversation, ou un autre projet existant explicitement référencé par l'utilisateur. Ne supposez pas que l'espace de travail app/promo actuel est la chose promue.

Base de conformité

Les vidéos promotionnelles doivent par défaut suivre des règles de sécurité publicitaire conservatrices. Utilisez uniquement les affirmations, offres, prix, réductions, cadeaux, noms de marque, CTA, certifications, chiffres de vente, effets et services qui sont présents dans la demande de l'utilisateur, le projet, le texte publicitaire ou la page de destination. N'impliquez pas de partenariats officiels, de recommandations de plateformes, d'approbations de marques ou de certifications à moins que le matériel source ne les fournisse explicitement.

N'utilisez pas d'affirmations trompeuses ou invérifiables telles que des résultats garantis, des classements absolus, des promesses sans risque, une rareté factice, des comptes à rebours factices, des notifications factices, des boutons factices, une interface utilisateur système factice, des témoignages factices, des avis factices, des actualités factices ou des captures d'écran de résultats exagérées. Ne ciblez pas directement les attributs personnels sensibles tels que la santé, les finances, l'âge, la race, la religion, la sexualité, le handicap, l'état civil, la forme du corps ou l'apparence ; utilisez plutôt un libellé d'audience neutre.

N'incluez pas de marques non licenciées, de personnes reconnaissables, de personnages protégés par le droit d'auteur, d'interface utilisateur de produits tiers, de médias, de polices, de filigranes, de contenu pour adultes, de sang, de choc, de haine, de harcèlement, de contenu humiliant, d'armes, de drogues, de jeux d'argent, de tabac ou de matériel politiquement sensible. Pour les catégories à haut risque telles que le médical, les compléments alimentaires, la perte de poids, les procédures esthétiques, la finance, les prêts, les crypto-monnaies, les jeux d'argent, l'alcool, les rencontres, les enfants, le juridique, le recrutement, l'immobilier, la politique, la religion ou les problèmes sociaux, gardez la vidéo informative et évitez les promesses fortes, les visuels dramatiques avant/après ou la pression de conversion agressive.

Gardez les séquences claires, stables et de haute qualité : pas de scintillement, de compression sévère, d'étirement, de filigrane, de barres noires causées par un mauvais dimensionnement des actifs, ou de sous-titres/logos/CTA rognés sur les bords. En cas de doute sur la conformité, choisissez l'expression la plus sûre, la plus neutre et la plus informative. Cette base de référence réduit le risque mais ne constitue pas une garantie d'approbation de la plateforme.

Les CTA de conversion finaux sont du contenu vidéo statique, pas une interface utilisateur web interactive. Ne rendez pas le CTA de clôture comme un bouton de site Web cliquable, une cible de clic factice, un bouton fléché, une entrée factice, une popup factice, une interface utilisateur système factice, une cible de curseur, un état survolé/enfoncé ou tout contrôle qui implique que le spectateur peut cliquer pour naviguer. Utilisez plutôt une ligne de carte de fin, un slogan de marque, un identifiant de compte, une URL, un espace réservé QR ou un texte simple « visitez / scannez / suivez ». Les démonstrations de produits et les présentations de pages peuvent montrer des boutons d'interface utilisateur, des formulaires et une navigation réels ou simulés lorsqu'ils illustrent le flux du produit, mais ils ne doivent pas devenir le CTA de conversion final.

Toute URL visible, identifiant de compte, cible QR, texte de barre d'adresse de navigateur ou point de terminaison de marque doit provenir de la demande de l'utilisateur, de la source du projet confirmée, de la page de destination ou d'un autre actif vérifié. Si le projet n'expose qu'un nom de domaine d'espace réservé ou aucune adresse publique confirmée, omettez l'URL et terminez par un texte de marque à la place ; pour un traitement de fenêtre de navigateur, utilisez une étiquette de page non-URL ou laissez la barre d'adresse vide. N'inférez pas un domaine, un identifiant ou une destination à partir du nom de l'application, du nom du dépôt, du nom de fichier de téléchargement, de l'espace réservé du modèle, du jeton de variable d'environnement ou d'indices similaires.

Flux de travail principal

  1. Initialisez le projet Remotion avec FrontendEngineer.use_template("remotion") si app/promo n'est pas déjà prêt. L'outil lui-même rejette une source non-Remotion avant la copie, vous n'avez donc pas besoin d'une étape de vérification distincte.
  2. Choisissez l'orientation cible dès le départ à partir de la demande de l'utilisateur et du plan du storyboard : paysage (16:9), portrait (9:16) ou carré (1:1). Toutes les commandes de validation, de test et de rendu complet ultérieures doivent utiliser la variante correspondante.
  3. Classifiez le sujet (promotion de projet ou promotion de sujet) en utilisant la Classification du sujet ci-dessus. Ne vous arrêtez pas pour demander « quel devrait être le sujet ? » si la demande originale nomme déjà un sujet ou un projet.
  4. Ancrez le sujet :
    • Promotion de projet : résolvez d'abord l'application source promue, puis lisez le code source app/frontend de cette application, ses manifestes et les commentaires de validation antérieurs. Si l'espace de travail actuel contient principalement la sortie promotionnelle, ne traitez pas app/promo lui-même comme l'application source. Une fois que vous avez identifié l'application source, verrouillez ce chemin racine du projet source / frontend dans promo_storyboard.md ou les notes de travail et continuez à réutiliser le même chemin après être passé dans app/promo ; ne rétrogradez pas en promotion de sujet simplement parce que l'espace de travail promotionnel lui-même n'a pas de app/frontend. Avant d'écrire du code Remotion, enregistrez les chemins de fichiers source frontend clés sur lesquels vous vous appuierez dans promo_storyboard.md (pages/routes/composants pour les séquences de démonstration). Plus tard, lors de l'implémentation de src/, rouvrez ces fichiers source et copiez/reproduisez à partir du code au lieu de vous fier à un long résumé en prose.
    • Promotion de sujet : extrayez le sujet du message de l'utilisateur et de la conversation antérieure ; tirez des faits supplémentaires de vos propres connaissances ou d'outils externes (génération d'images / vidéos / audio, recherche si disponible). N'exigez pas qu'un projet d'espace de travail existe.
    • Si l'utilisateur a fourni des images de référence mais que la demande actuelle n'expose que des chemins de fichiers au lieu du contenu de l'image joint, lisez image-understanding et appelez ImageAnalyzer.analyze_images avant le storyboard afin que le plan visuel soit ancré dans le contenu réel de l'image plutôt que dans les noms de fichiers.
    • Si l'utilisateur a fourni une URL de site Web comme sujet de la promotion, utilisez Browser.goto pour visiter la page, puis Browser.take_screenshot pour capturer le visuel, puis appelez ImageAnalyzer.analyze_images sur la capture d'écran avant le storyboard afin que le plan visuel soit ancré dans le contenu réel de la page plutôt que dans la seule URL.
  5. Appliquez la Base de conformité : confirmez quels faits, affirmations, offres et actifs sont réellement étayés par la demande, le produit, le texte publicitaire ou la page de destination. N'inventez pas d'offres, de certifications, de chiffres de vente, d'effets, de partenariats officiels, d'approbations de plateformes ou de soutiens de marque non étayés ; en cas de doute, choisissez un libellé et des visuels conservateurs et informatifs.
  6. Déterminez la langue par défaut pour le contenu promotionnel nouvellement généré avant d'écrire promo_storyboard.md. Si l'utilisateur spécifie explicitement une langue de sortie, utilisez cette langue. Sinon, utilisez l'anglais par défaut. Un message utilisateur écrit en chinois/japonais/etc., la langue de chat environnante ou la langue de l'invite système n'est pas une demande de langue explicite. Enregistrez la décision directement dans le storyboard sous la forme Language: English (default) ou Language: Chinese (user specified) avant de rédiger les plans, le texte, la narration ou les invites de génération.
  7. Créez promo_storyboard.md avant d'écrire le code vidéo ou de générer des actifs. Utilisez l'ensemble de champs qui correspond au type de sujet (voir Exigences du storyboard). Pour les exécutions promo/remotion, promo_storyboard.md est le seul artefact de planification ; ne créez pas et ne maintenez pas de todo.md séparé.
  8. Si l'utilisateur demande une narration, une voix off, une présentation parlée ou si le storyboard a clairement besoin d'un narrateur, incluez un plan de narration à segments courts dans le storyboard, vérifiez la longueur du script de chaque segment par rapport à ses secondes de plan cibles, puis lisez audio-generation et appelez AudioCreator.generate_audios avec une demande par plan/temps fort.
  9. Après la génération TTS, préférez la duration renvoyée de chaque segment audio. Si duration est manquante ou null, mesurez la durée réelle à partir de l'URL renvoyée (par exemple avec ffprobe), puis décidez le timing par plan final à partir de ces durées mesurées. Ce calcul n'est pas suffisant s'il n'apparaît que dans la pensée ou la sortie du terminal.
  10. Mettez immédiatement à jour promo_storyboard.md avec chaque URL de narration, secondes audio mesurées, début/fin/durée de plan final, durée totale et tout changement de script/timing. C'est un point de contrôle strict : n'appelez pas MusicCreator.generate_music, VideoCreator.generate_videos, ne générez pas plus d'actifs visuels, et n'écrivez pas src/timeline.ts tant que le timing mis à jour n'est pas persistant dans promo_storyboard.md. Après ce verrouillage, promo_storyboard.md ne doit plus conserver de lignes de timing TBD d'espace réservé ou une durée totale obsolète.
  11. Par défaut, les vidéos promotionnelles doivent également inclure un plan de musique de fond globale, sauf si l'utilisateur dit explicitement non à la musique ou si le morceau est clairement meilleur sans musique. Lisez music-generation et appelez MusicCreator.generate_music avec exactement une demande instrumentale / sans paroles une fois le timing final du plan verrouillé. L'invite doit inclure le nombre total de secondes cible, l'ambiance, le rythme, l'instrumentation et si la piste doit laisser de la place pour la narration.
  12. Après la génération de musique, utilisez l'URL renvoyée directement et préférez la duration renvoyée, comme pour la narration. Si duration est manquante ou null, mesurez la durée réelle de la BGM avec ffprobe. Mettez immédiatement à jour promo_storyboard.md avec l'URL BGM, les secondes mesurées, la durée totale cible, la stratégie d'adaptation et les valeurs de mixage prévues avant d'écrire src/timeline.ts ou src/PromoVideo.tsx. La durée verrouillée du storyboard/chronologie est la source de vérité. Ne raccourcissez jamais la vidéo juste pour correspondre à une BGM courte ; taillez, bouclez minimalement ou régénérez la musique à la place, sauf si l'utilisateur a explicitement demandé une version plus courte.
  13. Générez tous les autres actifs AI (images/vidéo/audio) nécessaires après avoir écrit le storyboard et après que le timing de la narration + BGM soit réglé dans promo_storyboard.md.
  14. Lisez remotion-best-practices et les fichiers de règles pertinents pour le storyboard.
  15. Éditez l'implémentation Remotion sur place sous app/promo — gardez la disposition plate src/ du modèle (src/Root.tsx, src/PromoVideo.tsx, src/timeline.ts, src/components/, src/scenes/, src/app-demo/). Ne déplacez pas les sources dans un sous-répertoire comme src/remotion/. Avant la validation, faites une rapide auto-vérification : supprimez les imports/variables inutilisés, omettez les Sequence from={0} redondants, gardez le mouvement purement basé sur les frames (pas de animation / transition CSS, de minuteries ou d'autres motifs non déterministes), et mettez à jour tout contrat src/timeline.ts / src/PromoVideo.tsx / src/scenes/* modifié dans la même passe.
  16. Exécutez la validation dans l'ordre : verify:versions, lint, verify:compositions. Le succès de verify:compositions prouve uniquement que Remotion peut voir les compositions ; ce n'est pas un livrable et ce n'est pas un point d'arrêt valide.
  17. Exécutez RemotionPromoRenderer.render pour la résolution cible enregistrée dans le storyboard/spécification d'exportation ; il effectue le test + rendu complet en interne. Pour les vidéos portrait/9:16, utilisez width=1080, height=1920 et source_orientation=portrait au lieu de copier un exemple paysage. La tâche est terminée uniquement lorsque out/promo-<width>x<height>.mp4 existe et n'est pas vide. Ne dites pas à l'utilisateur que la vidéo est prête à exporter, ne lui demandez pas de l'exporter, n'appelez pas RoleZero.reply_to_human et n'utilisez pas <end></end> avant que cet outil ait réussi.

Exigences du storyboard

promo_storyboard.md doit être spécifique au sujet. Choisissez l'ensemble de champs qui correspond au type de sujet :

Chaque storyboard doit inclure :

  • Notes de conformité : affirmations/offres/actifs étayés, si le sujet est à haut risque, les choix de libellé conservateurs et les risques visuels/copie/actifs à éviter.
  • Traitement CTA : enregistrez si le CTA final est une vidéo statique

… [tronqué pour la traduction]

Skills associés