Communitygithub.com

Reels Scripting

Transforme un Instagram Reel de référence en un script pour votre propre Reel, adapté à votre voix et repurposé à partir de votre contenu de newsletter.

Qu'est-ce que Reels Scripting ?

Cette compétence permet de transformer un Instagram Reel de référence (via une URL ou un lien Notion) en un script optimisé pour votre propre contenu, en utilisant l'analyse vidéo de Gemini 2.5 Flash et le scraping d'Apify. Elle est utile pour les créateurs de contenu qui souhaitent reproduire des formats performants tout en restant fidèles à leur voix et à leur newsletter. La compétence supporte les plateformes Codex et Claude, et nécessite les clés API `APIFY_API_TOKEN` et `GOOGLE_AI_API_KEY`. Le flux de travail comprend sept étapes : récupération de la référence, extraction du sujet de newsletter, scraping et téléchargement de la Reel, analyse avec Gemini 2.5 Flash, rédaction du nouveau script, boucle de contrôle qualité (seuil 95/100), et remise finale du script. Les règles de style incluent l'anglais britannique, l'absence de points-virgules et de tirets cadratins, et l'interdiction de phrases d'accroche commençant par 'I'.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PetarKukric/CLAUDE_SKILLS/tree/HEAD/cache/social-media-skills/social-media-skills/1.1.0/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 Reels Scripting ?

Codex et Claude runtime

  • Utilisez cette compétence 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 obligatoire : utilisez un outil de question disponible dans ses limites, ou demandez 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 toute personnalisation. Confirmez l'auteur prévu si les fichiers sont en conflit ou contiennent des valeurs par défaut. 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/ groupés par rapport à ce dossier de compétence. Pour une mise à jour explicite du profil, lisez et mettez à jour les fichiers canoniques about-me.md, voice.md ou newsletter-voice.md en 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 ou n'écrit pas de fichiers. N'écrivez pas d'apprentissages persistants sauf demande explicite.
  • 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 est indisponible, nommez la capacité manquante et proposez une entrée de texte/export fournie. N'inventez jamais de faits, d'expérience à la première personne, de métriques ou de résultats d'un 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 n'écrasez pas les connexions. La rédaction, la sauvegarde et la relecture n'autorisent pas la publication, l'envoi de messages ou la modification de comptes.

CRITIQUE : Démarrage automatique au chargement

Lorsque cette compétence se déclenche, allez directement à l'Étape 1. Ne résumez pas.

Prérequis

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

  • La variable d'environnement APIFY_API_TOKEN (scraping Instagram)
  • La variable d'environnement GOOGLE_AI_API_KEY (analyse vidéo Gemini 2.5 Flash)
  • Node.js 18+ et les paquets 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 paquets manquants, 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 prendre en charge 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 paquets installés ; vérifiez la documentation officielle actuelle du SDK et de l'acteur avant de générer un script d'assistance, 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 de la Reel de référence ou le lien Notion. Il s'agit de la Reel exceptionnelle 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 Instagram Reel 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 de la Reel.

Étape 2. Obtenir le sujet de la newsletter

Demandez :

Quel est le sujet de votre newsletter que vous voulez repurposer dans cette 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 la Reel

Utilisez un nouveau dossier outputs/reels/<slug>/ dans le projet sélectionné. Réutilisez une aide existante appropriée si elle est présente, 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é son schéma documenté actuel, pour la seule Reel demandée. 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 de publications/vidéos uniquement avant de l'appeler ; sinon, demandez un téléchargement vidéo. Ne devinez pas les entrées d'acteur alternatives.
  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 de scraping 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.

Une seule Reel est une référence, pas une exception vérifiée. Appelez-la exception uniquement lorsque des données de comparaison fournies ou explicitement demandées établissent ses performances 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 deuxième 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 cette Reel pour écrire mon propre script dans un style similaire pour mon public de [PUBLIC CIBLE DE about-me.md].

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

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

## Modèles de langage
- Longueur moyenne des phrases
- Ratio vous/votre vs je/me
- Transitions entre les points
- Où sont les minimisateurs 'just' ?

## Structure
- Durée totale
- Répartition des sections avec horodatages
- Quel est le moment avant/après ?
- Quel est le CTA ?

## Un aperçu clé
- La technique la plus importante à apprendre de cette 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 dans outputs/reels/<slug>/reel-[slug].md.

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

Accroche

  • Ne commencez jamais par "Je". Utilisez "ceci", "vous", un fait ou une mention de nom.
  • Formats éprouvés : "Ceci a changé... pour toujours" / retournement négatif ("X est inutile sauf si...") / déclaration de capacité.
  • L'accroche crée la curiosité ou une rupture de motif 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 "vous" et "just" de manière conversationnelle ("vous venez juste de déposer...").
  • Ne fusionnez jamais trois fragments saccadés ou plus. Combinez en une seule phrase fluide.
  • Ne formulez jamais la conclusion. Laissez les faits faire le travail.
  • Utilisez un CTA de commentaire uniquement si l'utilisateur a un livrable réel et une automatisation fonctionnelle confirmée. Sinon, utilisez une action pertinente suivante 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 de fin.

CTA

  • "Commentez [MOT] et je vous enverrai [chose spécifique]"
  • Court. Pas de remplissage "le lien vers mon complet".

Durée et structure

  • Ciblez 30 à 45 secondes au total.
  • 2 points clés maximum, 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 de la reel]
- Vues : [nombre]
- Technique clé : [de 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)
[Action suivante exacte, avec une promesse de commentaire uniquement si la livraison est confirmée]

---

## Légende
[Reflete 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 plans secondaires, superpositions de texte]

Étape 6. Boucle de contrôle qualité

Examinez 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 réévaluez, jusqu'à trois passages. Le seuil est de 95/100 ; si non résolu, signalez un brouillon avec les blocages spécifiques plutôt que d'augmenter le score ou de prétendre qu'il est prêt. Chronométrez une lecture à voix haute si disponible ; sinon, étiquetez la durée comme estimée. Claude n'est pas requis pour cet examen dans Codex.

Violations courantes à vérifier :

  • Commence par "Je"
  • Fragments saccadés de trois ou plus
  • Formule la conclusion
  • Déclencheur de commentaire multi-mots ou stylisé
  • Durée de plus de 45 secondes à la lecture
  • 3 points au lieu de 2
  • La légende ne reflète pas le script

Étape 7. Remettre le script

Livrez le script examiné et la légende correspondante dans le projet, avec la source de référence, la méthode d'analyse et toutes les vérifications non résolues. L'utilisateur peut l'enregistrer ou demander explicitement son propre flux de production disponible. Cette compétence publique n'intègre pas d'avatar, de pipeline de montage ou de publication.

Règles

  • Ne sautez jamais la porte de contrôle qualité 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 de la 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 entrée 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 2 individual skills — each has its own dedicated page.

Skills associés