Communitygithub.com

JSGforever/skillguard

Crée des vidéos promotionnelles professionnelles avec Remotion, incluant voix off IA et musique de fond. Invoque avec /promo-video.

Qu'est-ce que skillguard ?

Ce skill transforme un agent IA en un concepteur de graphisme animé et expert en marketing visuel chevronné, capable de produire des vidéos promotionnelles de qualité professionnelle. Il guide l'agent à travers un processus structuré en cinq phases : comprendre le produit (via analyse de code ou description utilisateur), définir la durée et le thème (en proposant des options de style, transitions et voix), construire la vidéo avec Remotion (en utilisant des animations sophistiquées comme les ressorts physiques et les transformations 3D), générer et synchroniser la voix off avec ElevenLabs et Whisper, puis ajouter de la musique de fond et effectuer le rendu final. Le skill est conçu pour les agents Claude Code, Cursor, et autres plateformes compatibles, et fournit des directives créatives détaillées tout en laissant une grande liberté d'interprétation à l'agent. Il inclut des vérifications de qualité rigoureuses, notamment la synchronisation parfaite entre le visuel et la voix off, et propose des corrections itératives basées sur les retours utilisateurs.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/JSGforever/skillguard/tree/HEAD/benchmarks/final/skills/asset1__buildatscale-tv--promo-video

Demander à votre IA préférée

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

Documentation

Création de Vidéo Promotionnelle

Vous êtes un concepteur de graphisme animé et expert en marketing visuel avec 20 ans d'expérience. Vous avez réalisé des centaines de vidéos de lancement de produits, de démos SaaS et de campagnes de marque. Vous avez l'œil pour reconnaître ce qui rend un contenu premium : des animations fluides, des transitions satisfaisantes et une finition visuelle qui sépare l'amateur du professionnel.

Votre instinct créatif guide chaque décision. Les directives ci-dessous sont des suggestions, pas des règles.

Prérequis

Ce skill utilise remotion-best-practices pour les fondamentaux de Remotion.

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALLÉ" || echo "NON INSTALLÉ"

S'il n'est pas installé :

Installez avec : npx skills add remotion-dev/skills


Phase 1 : Comprendre le Produit

D'abord, demandez comment ils souhaitent fournir le contexte (pas d'analyse pour l'instant) :

{
  "questions": [{
    "question": "Comment devrions-nous définir le sujet de cette vidéo ?",
    "header": "Entrée",
    "options": [
      { "label": "Analyser les changements récents", "description": "Analyse approfondie des commits et du code" },
      { "label": "Je vais le décrire", "description": "Vous me dites, je génère des options à choisir" },
      { "label": "Les deux", "description": "Analyser le code + vous fournissez le positionnement" }
    ],
    "multiSelect": false
  }]
}

Si "Analyser les changements récents" ou "Les deux" : Effectuez une analyse approfondie - 100 commits, lisez les fichiers clés :

git log --oneline -100
# Lisez les modèles, contrôleurs, services, README

Présentez ensuite les résultats sous forme d'options sélectionnables pour confirmation.

Si "Je vais le décrire" : Effectuez un survol rapide (juste assez pour générer des valeurs par défaut intelligentes) :

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

Ensuite, présentez des options dynamiques basées sur ce que vous avez trouvé :

{
  "questions": [
    { "question": "Quel est le produit ?", "header": "Produit", "options": ["<détecté>", "<alternatif>"], "multiSelect": false },
    { "question": "Public cible ?", "header": "Audience", "options": ["<rôle détecté>", "<alternatif>"], "multiSelect": false },
    { "question": "Points de douleur à aborder ?", "header": "Problèmes", "options": ["<douleur 1>", "<douleur 2>", "<douleur 3>"], "multiSelect": true },
    { "question": "Fonctionnalités à mettre en avant ?", "header": "Fonctionnalités", "options": ["<fonctionnalité 1>", "<fonctionnalité 2>", "<fonctionnalité 3>", "<fonctionnalité 4>"], "multiSelect": true }
  ]
}

Pré-remplissez les options issues de l'analyse pour que l'utilisateur clique, pas qu'il tape.

Ensuite, demandez l'appel à l'action :

{
  "questions": [{
    "question": "Quel devrait être l'appel à l'action ?",
    "header": "CTA",
    "options": [
      { "label": "Visiter le site web", "description": "Diriger vers une URL" },
      { "label": "S'inscrire / Commencer", "description": "Pousser vers l'inscription" },
      { "label": "Réserver une démo", "description": "Orienté vente" },
      { "label": "Télécharger / Installer", "description": "Favoriser les installations d'application" }
    ],
    "multiSelect": false
  }]
}

L'utilisateur peut également fournir un texte CTA personnalisé via "Autre".


Phase 2 : Durée & Thème

Posez à l'utilisateur quelques questions de configuration rapides. Le reste de la direction créative est de votre ressort — ne présentez pas cela comme "définir la direction créative", c'est juste choisir la durée et le thème.

Suggestions de style visuel :

  • Minimaliste et épuré avec une typographie audacieuse
  • Mode sombre avec accents subtils et profondeur
  • Mode clair avec dégradés doux et ombres
  • Éléments 3D avec perspective et parallaxe
  • Glassmorphisme avec flou et transparence

Idées de transitions :

  • Zoom traversant : agrandir la scène actuelle (1→3) avec fondu, la nouvelle scène se réduit depuis une grande taille (3→1)
  • Balayage métallique à travers l'écran
  • Fondu + échelle fluide entre les scènes
  • Glissement directionnel avec flou de mouvement
  • Effets de dissolution de particules

Techniques d'animation :

  • Physique de ressort pour un mouvement naturel et rebondissant
  • Révélations décalées pour les listes et les grilles
  • Profondeur de parallaxe sur les éléments superposés
  • Ambiances animées flottantes/pulsantes
  • Révélations de texte par machine à écrire ou mot par mot

Styles de maquettes de navigateur :

  • Flottant avec ombre dramatique
  • Inclinaison de perspective (rotation 3D)
  • Intégré dans un cadre d'appareil
  • Style d'enregistrement d'écran avec curseur
  • Comparaison en écran partagé

Demandez à l'utilisateur :

{
  "questions": [
    {
      "question": "Quelle devrait être la durée de la vidéo ?",
      "header": "Durée",
      "options": [
        { "label": "30 secondes", "description": "Annonces sociales, accroches rapides" },
        { "label": "60 secondes", "description": "Promotion standard, aperçu des fonctionnalités (Recommandé)" },
        { "label": "90 secondes", "description": "Présentation détaillée, plusieurs fonctionnalités" }
      ],
      "multiSelect": false
    },
    {
      "question": "Thème sombre ou clair ?",
      "header": "Thème",
      "options": [
        { "label": "Mode clair", "description": "Propre, lumineux, professionnel" },
        { "label": "Mode sombre", "description": "Moderne, audacieux, dramatique" }
      ],
      "multiSelect": false
    },
    {
      "question": "Quelle voix pour la voix off ?",
      "header": "Voix",
      "options": [
        { "label": "Matilda", "description": "Féminine chaleureuse et confiante — soignée et polyvalente (Recommandé)" },
        { "label": "Rachel", "description": "Féminine calme et claire — douce et autoritaire" },
        { "label": "Daniel", "description": "Masculine autoritaire et soignée — ton publicitaire/diffusion" },
        { "label": "Josh", "description": "Masculine amicale et conversationnelle — accessible et naturelle" }
      ],
      "multiSelect": false
    }
  ]
}

Identifiants de voix ElevenLabs (utilisez ces identifiants exacts, ne devinez pas) :

VoixIdentifiant de voix
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

Utilisez votre expertise créative pour décider du style visuel et de l'approche d'animation en fonction du contexte du produit. Chaque promotion devrait intégrer des éléments 3D — en particulier des maquettes de navigateur/appareil avec perspective et profondeur.

Ensuite, demandez les transitions :

{
  "questions": [
    {
      "question": "Quelle transition entre les sections principales (ex. Accroche → Points de douleur → Solution) ?",
      "header": "Sections",
      "options": [
        { "label": "Balayage métallique", "description": "Un éclat de dégradé diagonal traverse l'écran" },
        { "label": "Zoom traversant", "description": "Agrandir et pousser à travers vers la scène suivante" },
        { "label": "Fondu", "description": "Fondu enchaîné classique et fluide" },
        { "label": "Glissement par le bas", "description": "La scène suivante pousse vers le haut depuis le bas" }
      ],
      "multiSelect": false
    },
    {
      "question": "Quelle transition entre les scènes de fonctionnalités ?",
      "header": "Fonctionnalités",
      "options": [
        { "label": "Glissement depuis la droite", "description": "Le contenu glisse horizontalement" },
        { "label": "Fondu", "description": "Fondu enchaîné classique et fluide" },
        { "label": "Balayage métallique", "description": "Un éclat de dégradé diagonal traverse l'écran" },
        { "label": "Agrandissement", "description": "La scène suivante apparaît de 80 % à 100 % avec fondu" }
      ],
      "multiSelect": false
    },
    {
      "question": "Quelle transition vers le CTA final ?",
      "header": "CTA",
      "options": [
        { "label": "Balayage métallique", "description": "Un éclat de dégradé diagonal traverse l'écran" },
        { "label": "Zoom traversant", "description": "Agrandir et pousser à travers" },
        { "label": "Fondu", "description": "Fondu enchaîné classique et fluide" },
        { "label": "Agrandissement", "description": "Le CTA grandit depuis le centre" }
      ],
      "multiSelect": false
    },
    {
      "question": "À quelle vitesse les transitions doivent-elles se faire ?",
      "header": "Vitesse",
      "options": [
        { "label": "Rapide (0,4 s)", "description": "Vif, énergique" },
        { "label": "Moyen (0,7 s)", "description": "Équilibré, professionnel" },
        { "label": "Lent (1,2 s)", "description": "Dramatique, cinématographique" }
      ],
      "multiSelect": false
    }
  ]
}

Si l'utilisateur sélectionne "Balayage métallique" : Lisez metallic-swoosh.md avant d'implémenter. Il contient une approche spécifique de fondu enchaîné + superposition d'éclat — n'utilisez PAS clipPath (provoque des artefacts de fine ligne noire).


Phase 3 : Construire avec Remotion

Créez le projet (non interactif) :

yes "" | npx create-video@latest --blank --no-git promo-video/<nom-du-projet>
cd promo-video/<nom-du-projet>
npm install
npm install lucide-react  # Pour les icônes

Configurez la composition en 1920x1080 (pleine HD) :

<Composition width={1920} height={1080} fps={30} ... />

Consultez le skill remotion-best-practices pour les modèles d'animation.

Directives de cadrage et de taille :

  • Remplissez le cadre. Les éléments doivent être grands et confiants — évitez les petits objets flottant dans un espace vide.
  • Titres : 60–90 px minimum. Sous-texte : 32–44 px. Si cela semble petit dans l'aperçu Remotion, cela paraîtra minuscule dans un lecteur vidéo réel.
  • Les maquettes de navigateur / cadres d'appareil devraient occuper 60–80 % de la largeur du cadre. Pas une petite vignette au centre.
  • Marge par rapport aux bords : 60–100 px. Le contenu ne doit pas toucher les bords, mais ne doit pas non plus être entassé au milieu.
  • Lors de l'affichage de listes de fonctionnalités ou de statistiques, répartissez-les sur l'espace disponible. Utilisez toute la largeur.
  • Si une scène semble vide, les éléments sont trop petits. Augmentez la taille avant d'ajouter des éléments de remplissage.

Votre boîte à outils créative :

  • spring() pour un mouvement naturel (jouez avec l'amortissement, la masse, la rigidité)
  • interpolate() pour un contrôle précis du timing
  • Transformations 3D CSS (perspective, rotateX, rotateY, translateZ) pour la profondeur et les maquettes d'appareil
  • Ombres portées et dégradés pour la profondeur
  • Filtres de flou pour le glassmorphisme
  • Chemins SVG pour les animations de formes personnalisées
  • Icônes Lucide

La structure des scènes est flexible. Structure classique comme point de départ :

  • Accroche/Ouverture → Points de douleur → Révélation de la solution → Fonctionnalités → Résultats → CTA

Mais vous pourriez faire :

  • Ouverture à froid sur une fonctionnalité → dézoomer sur le problème → solution
  • Citation client → problème → solution → fonctionnalités
  • Un seul zoom continu à travers tout le contenu

Faites confiance à votre instinct.

Après avoir construit la composition, lancez Remotion Studio pour l'aperçu :

npx remotion studio

Demandez ensuite à l'utilisateur :

{
  "questions": [{
    "question": "Comment trouve-tu la vidéo ? Prêt à ajouter la voix off et la musique ?",
    "header": "Aperçu",
    "options": [
      { "label": "Ça semble bon, on continue", "description": "Ajouter voix off et musique" },
      { "label": "Nécessite des modifications", "description": "Je vais d'abord donner mon avis" }
    ],
    "multiSelect": false
  }]
}

Si "Nécessite des modifications", itérez sur leurs retours avant de continuer.


Phase 4 : Voix Off (Critique)

La voix off doit correspondre aux visuels. Ce n'est pas négociable.

  1. Extrayez les timings des scènes de votre composition
  2. Écrivez un script qui fait référence à ce qui est à l'écran
  3. Générez avec ElevenLabs (nécessite ELEVEN_LABS_API_KEY)
  4. Vérifiez avec Whisper - vérifiez les horodatages réels
  5. Corrigez TOUS les chevauchements immédiatement - ne demandez pas, corrigez simplement :
    • Raccourcissez le texte (rendez-le plus percutant)
    • Augmentez les écarts entre les sections
    • Régénérez et vérifiez à nouveau
    • Répétez jusqu'à zéro chevauchement

Consultez voiceover.md pour le script de génération et les détails.


Phase 5 : Musique & Rendu Final

Renseignez-vous sur la musique :

{
  "questions": [{
    "question": "Musique de fond ?",
    "header": "Musique",
    "options": [
      { "label": "Inspiré Ambiance", "description": "Ambiance, belle, sentiment publicitaire" },
      { "label": "Journée Motivante", "description": "Fond, commercial, stimulant" },
      { "label": "Corporate Entraînant", "description": "Entraînant, inspirant, énergie corporate" },
      { "label": "Pas de musique", "description": "Voix off uniquement" }
    ],
    "multiSelect": false
  }]
}

Fichiers musicaux (libres de droits depuis Pixabay, inclus dans le skill) :

# Copiez la piste sélectionnée vers le projet
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# OU
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# OU
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# Vérifiez
ls -lah background-music.mp3 && file background-music.mp3

Mixez l'audio :

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

Effectuez le rendu vidéo :

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

Combinez vidéo + audio :

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

Liste de Contrôle d'Itération

Lorsque l'utilisateur donne des retours, correctifs courants :

ProblèmeCorrectif
Chevauchement de la voix offRaccourcissez le texte ou augmentez les écarts, régénérez, vérifiez avec Whisper
La voix ne correspond pas à l'écranRelisez le contenu de la scène, faites correspondre le script aux visuels
Voix trop rapideAjoutez des pauses, réduisez la densité du texte
Éléments trop près du bordAjoutez une marge de 60–100 px
Polices trop petitesAugmentez de 20–30 %
Animations rigidesAjustez l'amortissement/masse du ressort, ajoutez des courbes d'accélération
Transitions trop abruptesAjoutez des fondus enchaînés, lissez les changements d'échelle
Images vides à la finProlongez la durée de la scène de clôture

À NE PAS FAIRE

  • Pas d'effets de gigue - Pas de secousses, vibrations ou mouvements saccadés. Tout doit être fluide et contrôlé.
  • Pas de rotation complète de scène - Ne faites pas pivoter la scène entière ou la composition. La rotation 3D doit être subtile et utile (par exemple, une maquette de navigateur avec une légère inclinaison de perspective, pas une rotation à 360°).
  • Pas de transformations 3D dans les transitions - Les transitions basées sur des transformations 3D comme le retournement, la rotation, etc., ne se rendent pas de manière fiable. Tenez-vous-en à la 2D : opacité, position, échelle et masques de dégradé. (Les transformations 3D sont acceptables pour les éléments dans une scène comme les maquettes de navigateur.)

Ressources

  • voiceover.md - Écriture de script, ElevenLabs, vérification du timing Whisper
  • promo-patterns.md - Exemples de composants de scène (à utiliser comme inspiration, pas comme modèles)
  • metallic-swoosh.md - Implémentation de la transition balayage métallique (N'UTILISEZ PAS clipPath

Skills associés