Communitygithub.com

Scripting de Reels

Crée des scripts de Reels Instagram viraux à partir d'un Reel de référence et d'un sujet de newsletter, avec analyse vidéo par IA et validation de qualité.

Qu'est-ce que Scripting de Reels ?

Ce skill guide un agent IA (comme Claude ou Codex) dans la production de scripts de Reels Instagram optimisés pour la performance. Il débute par la récupération d'un Reel de référence (via URL ou Notion) et d'un sujet de newsletter. Ensuite, l'agent utilise l'API Apify pour télécharger la vidéo du Reel, puis l'envoie à Gemini 2.5 Flash pour une analyse détaillée (structure, hook, motifs linguistiques). Sur cette base, il rédige un nouveau script respectant des règles strictes : pas d'ouverture par « Je », maximum 2 points clés, 30-45 secondes, CTA clair, voix de l'utilisateur (via `voice.md` et `about-me.md`). Un cycle de relecture QA impose un score minimal de 95/100 avant de livrer le script final. Le skill vérifie les credentials, ne publie rien sans autorisation, et s'arrête en cas de dépendance manquante.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/reels-scripting

Demander à votre IA préférée

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

Documentation

Que fait Scripting de Reels ?

Runtime Codex et Claude

  • Utilisez ce skill dans Codex ou Claude avec les outils réellement disponibles dans la tâche en cours. Les exemples AskUserQuestion décrivent les questions, pas une API imposée : utilisez un outil de question disponible dans ses limites, ou demandez directement dans le chat. Réutilisez les réponses et le matériel source déjà fournis.
  • Travaillez dans le projet sélectionné par l'utilisateur. Lisez ses fichiers about-me.md, voice.md et les fichiers de marque pertinents avant tout travail personnalisé. Confirmez l'auteur visé si les fichiers sont en conflit ou contiennent des valeurs par défaut de démarrage. Demandez les informations manquantes ou exécutez voice-builder ; n'héritez jamais de l'identité, des comptes ou des fichiers privés du mainteneur.
  • Résolvez les references/ fournies par rapport à ce dossier de skill. Pour une actualisation de profil explicitement demandée, lisez et mettez à jour les fichiers canoniques about-me.md, voice.md ou newsletter-voice.md sur place, en préservant les faits et règles utilisateur non liés. Les consommateurs doivent relire ces fichiers canoniques. Utilisez un nouveau nom de fichier uniquement pour les nouveaux livrables qui entreraient en conflit avec des fichiers existants non liés. L'installation seule ne lance jamais un entretien et n'écrit pas de fichiers. N'écrivez pas d'apprentissages persistants sauf si demandé.
  • Utilisez d'abord les preuves fournies. Vérifiez les affirmations externes via les outils de recherche/source disponibles si nécessaire. Si une source ou une intégration n'est pas disponible, nommez la capacité manquante et proposez la saisie de texte/export fournie. N'inventez jamais de faits, d'expérience à la première personne, de métriques ou de résultat d'outil réussi.
  • Connectez uniquement les services nécessaires à la route choisie via le compte existant de l'utilisateur. N'imprimez jamais d'identifiants et ne remplacez pas les connexions. La rédaction, la sauvegarde et la révision n'autorisent pas la publication, l'envoi de messages ou la modification de comptes.

CRITIQUE : Démarrage automatique au chargement

Lorsque ce skill se déclenche, passez directement à l'Étape 1. Ne résumez pas.

Prérequis

La route complète d'analyse vidéo Apify + Gemini nécessite :

  • Variable d'environnement APIFY_API_TOKEN (scraping Instagram)
  • Variable d'environnement GOOGLE_AI_API_KEY (analyse vidéo Gemini 2.5 Flash)
  • Node.js 18+ et les packages apify-client et @google/generative-ai

Vérifiez uniquement les capacités nécessaires pour la route choisie. Pour l'extraction d'URL et l'analyse vidéo Gemini, vérifiez que les identifiants existants de l'utilisateur sont présents sans les imprimer, puis vérifiez que le fournisseur et le modèle sont disponibles. Des identifiants manquants, des packages, une vidéo privée ou un modèle indisponible laissent cette étape en attente. Expliquez ce qui manque ; ne modifiez pas la configuration du compte et ne remplacez pas silencieusement un fournisseur.

Une vidéo fournie peut sauter Apify. Une transcription/analyse fournie peut sauter les étapes 3 et 4 et supporter un script basé sur une transcription étiquetée à l'étape 5, mais ne constitue pas un résultat d'analyse vidéo Gemini. Réutilisez les packages installés ; vérifiez la documentation officielle actuelle du SDK et de l'acteur avant de générer un script d'aide, et obtenez l'approbation de l'utilisateur avant d'engager des coûts de fournisseur.

Étape 1. Obtenir la référence

Demandez :

Collez l'URL du Reel de référence ou le lien Notion. Il s'agit du Reel hors norme dont vous voulez reproduire le format.

Attendez l'URL.

Si l'utilisateur colle un lien Notion, lisez-le via un connecteur Notion autorisé disponible, localisez l'URL du Reel Instagram sur la page et extrayez-la. Si aucune URL de Reel n'est trouvée sur la page Notion, demandez à l'utilisateur de coller directement l'URL du Reel.

Étape 2. Obtenir le sujet de la newsletter

Demandez :

Quel est le sujet de votre newsletter que vous souhaitez réutiliser pour ce Reel ? Collez la section pertinente de la newsletter, ou tapez l'idée principale en une phrase.

Attendez le sujet. Lisez newsletter-voice.md, voice.md et about-me.md du projet s'ils existent, afin que le script corresponde à la voix de l'utilisateur.

Étape 3. Scraper et télécharger le Reel

Utilisez un nouveau dossier outputs/reels/<slug>/ dans le projet sélectionné. Réutilisez un script d'aide existant approprié s'il est présent, sinon écrivez un petit script Node.js spécifique à la tâche qui :

  1. Utilise apify-client et la route existante apify/instagram-reel-scraper, après avoir vérifié sa documentation de schéma actuelle, pour le seul Reel demandé. Ne scrapez jamais les commentaires, réponses ou fils de commentaires, y compris via deepScrape ou numComments. Vérifiez que le fournisseur prend en charge la collecte uniquement des publications/vidéos avant de l'appeler ; sinon, demandez un téléchargement de vidéo. Ne devinez pas les entrées alternatives de l'acteur.
  2. Extrait videoUrl de l'élément retourné.
  3. Télécharge la vidéo vers outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4.
  4. Sauvegarde les données brutes du scrape dans outputs/reels/<slug>/reel_data_{shortCode}.json.

Exécutez le script. Confirmez la taille du fichier et les métadonnées (vues, likes, nombre de commentaires agrégé si disponible, premiers 200 caractères de la légende) avant de continuer.

Un seul Reel est une référence, pas un hors norme vérifié. Appelez-le un hors norme uniquement lorsque des données de comparaison fournies ou explicitement demandées établissent sa performance par rapport aux publications récentes du même créateur ; citez l'échantillon, la fenêtre et la multiplicité. N'inventez pas cette base de référence.

Étape 4. Analyser avec Gemini 2.5 Flash

Étendez le script Node (ou exécutez un second passage) qui :

  1. Lit le fichier .mp4 téléchargé en base64.
  2. Appelle genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }).
  3. Envoie la vidéo avec cette invite exacte :
J'étudie ce Reel pour écrire mon propre script dans un style similaire pour mon audience de [AUDIENCE DE about-me.md].

## Transcription complète
- Transcrire CHAQUE mot avec des horodatages

## Accroche
- Mots exacts prononcés en premier
- Nombre de mots de l'accroche
- Qu'est-ce qui arrête le défilement ?

## Schémas linguistiques
- Longueur moyenne des phrases
- Ratio tu/votre vs je/me
- Transitions entre les points
- Où sont les minimisateurs « juste » ?

## Structure
- Durée totale
- Décomposition des sections avec horaires
- Quel est le moment avant/après ?
- Quel est le CTA ?

## Un aperçu clé
- La technique la plus importante à apprendre de ce Reel

Sauvegardez l'analyse dans outputs/reels/<slug>/analysis_reference_{shortCode}.md.

Étape 5. Écrire le nouveau script de Reel

En utilisant l'analyse de l'étape 4, le sujet de newsletter de l'étape 2 et les fichiers de voix de l'utilisateur, écrivez un nouveau script de Reel vers outputs/reels/<slug>/reel-[slug].md.

Appliquez ces règles (non négociables) :

Accroche

  • Ne commencez jamais par « Je ». Utilisez « ce », « tu », un fait ou un nom connu.
  • Formats éprouvés : « Ceci a changé... pour toujours » / inversion négative (« X est inutile sauf si... ») / déclaration de capacité.
  • L'accroche crée de la curiosité ou une interruption de schéma en 3 secondes.
  • Refletez le nombre de mots et la structure de l'accroche de l'analyse de référence.

Corps

  • Anglais britannique. Phrases courtes. Pas de tirets cadratins, pas de points-virgules.
  • Utilisez « you » et « just » de manière conversationnelle (« you just drop in... »).
  • Ne fusionnez jamais trois fragments staccato ou plus. Combinez-les en une seule phrase fluide.
  • Ne formulez jamais la conclusion. Laissez les faits parler d'eux-mêmes.
  • Utilisez un CTA par commentaire uniquement si l'utilisateur a un livrable réel et une automatisation confirmée et fonctionnelle. Sinon, utilisez une prochaine action pertinente qui ne promet pas de livraison.

Déclencheur de commentaire (uniquement si pris en charge)

  • Un seul mot en majuscules (SCRIPT, WIKI, PROMPTS, VIDEO).
  • Doit être directement lié à ce qui est promis.
  • Pas de guillemets, pas de « ci-dessous », pas de ponctuation finale.

CTA

  • « Comment [MOT] and I'll send you [chose spécifique] »
  • Court. Pas de remplissage « the link to my full ».

Durée et structure

  • Visez 30 à 45 secondes au total.
  • Maximum 2 points clés, pas 3.
  • La légende reflète le script. Mettez à jour les deux ensemble.

Structure du fichier de script

# Reel : [titre]

## Analyse de référence
- URL : [url du reel]
- Vues : [nombre]
- Technique clé : [d'après l'analyse Gemini]

## Durée cible
30-45 secondes

## Accroche (0-3s)
[Mots exacts]

## Point 1 ([début]-[fin]s)
[Mots exacts]

## Point 2 ([début]-[fin]s)
[Mots exacts]

## CTA ([début]-[fin]s)
[Prochaine action, avec une promesse de commentaire uniquement si la livraison est confirmée]

---

## Légende
[Reflète le script, formaté pour Instagram]

## Déclencheur de commentaire (uniquement si configuré)
[MOT ou non applicable]

## Livrable (uniquement si promis)
[La ressource réellement disponible ou non applicable]

---

## Notes visuelles
[Coupures, idées de B-roll, incrustations de texte]

Étape 6. Boucle d'assurance qualité

Révisez dans l'assistant en cours : précision de la source (30), voix de l'utilisateur (25), accroche et structure (20), durée parlée et clarté (15), cohérence légende/CTA (10). Citez les preuves pour chaque score. Corrigez les violations réelles et re-notez, jusqu'à trois passages. La porte est à 95/100 ; si non résolu, signalez un brouillon avec les bloqueurs spécifiques plutôt que de gonfler le score ou de prétendre qu'il est prêt. Chronométrez une lecture à voix haute lorsque c'est possible ; sinon, étiquetez la durée comme estimée. Claude n'est pas requis pour cette révision dans Codex.

Violations courantes à vérifier :

  • Commence par « Je »
  • Fragments staccato de trois ou plus
  • Formule la conclusion
  • Déclencheur de commentaire multi-mots ou stylisé
  • Durée supérieure à 45 secondes à voix haute
  • 3 points au lieu de 2
  • La légende ne reflète pas le script

Étape 7. Remettre le script

Livrez le script révisé et la légende correspondante dans le projet, avec la source de référence, la méthode d'analyse et les vérifications non résolues. L'utilisateur peut l'enregistrer ou demander explicitement son propre workflow de production disponible. Ce skill public ne livre pas d'avatar, de montage ou de pipeline de publication.

Règles

  • Ne sautez jamais la porte QA de 95/100.
  • Lisez toujours voice.md et about-me.md avant d'écrire. La correspondance vocale est non négociable.
  • N'inventez jamais de métriques à partir du Reel de référence. Utilisez uniquement des métadonnées vérifiées fournies ou récupérées, et marquez les métriques absentes comme indisponibles.
  • Anglais britannique. Pas de tirets cadratins. Pas de points-virgules.
  • Chaque script inclut la légende correspondante ; incluez un déclencheur de commentaire uniquement lorsque la livraison promise fonctionne.
  • Si l'accès à la référence échoue, signalez l'étape échouée et proposez une saisie vidéo/transcription fournie. Ne fabriquez pas d'analyse vidéo.
  • Gemini 2.5 Flash est le modèle. Ne le remplacez pas sans l'approbation de l'utilisateur.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

Skills associés