Communitygithub.com

CrissAlvarezH/video-script

Rédigez des scripts vidéo courts qui captivent les spectateurs, en utilisant les propres analyses vidéo du créateur. À utiliser pour choisir l'accroche d'une idée, écrire ou resserrer un script avant le tournage (talking-head ou explicateur narré), ou transformer les insights d'une vidéo publiée en leçons.

Qu'est-ce que video-script ?

Cette compétence permet de rédiger des scripts pour vidéos courtes (type TikTok, Reels, YouTube Shorts) en s'appuyant sur les données analytiques du créateur plutôt que sur l'intuition. Structure le travail autour de trois choix clés : l'enjeu (qui, au-delà des initiés, a une raison de s'intéresser), les deux premières phrases (pourquoi continuer à regarder), et la preuve (ce que le spectateur voit qui rend l'affirmation réelle). Le processus inclut la rédaction pas à pas (accroche, deuxième phrase, développement, fin), la vérification des faits (une IA fraîche contrôle chaque affirmation), et le révision des vidéos publiées (analyse de la courbe de rétention, comparaison avec la bibliothèque du créateur, mise à jour des fichiers de constats). Fonctionne avec tout agent capable d'exécuter des scripts Python et de lire des fichiers Markdown.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

Demander à votre IA préférée

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

Documentation

Script vidéo

Une vidéo courte se décide largement avant le tournage, par trois choix : l'enjeu (qui, au-delà des initiés, a une raison de s'intéresser), les deux premières phrases (pourquoi continuer à regarder), et la preuve (ce que le spectateur voit qui rend l'affirmation réelle). Faites chaque choix à partir de preuves : d'abord les vidéos passées du créateur, ensuite les déclarations de la plateforme, enfin l'intuition.

Ce que le spectateur regarde, c'est la réponse à une question. La curiosité le retient et chaque réponse lui donne une raison de partir, donc un script est un équilibre entre les deux : ouvrez une question tôt, et ne la refermez pas avant d'en avoir ouvert une autre.

Configuration

SKILL_DIR désigne le dossier de cette compétence. Lisez ~/.video-script/profile.md s'il existe : il nomme la bibliothèque vidéo du créateur, le fichier de constats, les notes de plateforme, la voix et le rythme. Avant de proposer quoi que ce soit, lisez le fichier de constats (y compris les tests en cours) et l'index de la bibliothèque, et citez les vidéos passées auxquelles une idée ressemble. Lorsque les constats contredisent une valeur par défaut ci-dessous, ce sont les constats qui priment : ils ont été mesurés sur ce public.

Sans profil, demandez une fois la plateforme, le public, une vidéo passée qui a bien marché et une qui a moins bien marché, avec leurs chiffres. Proposez ensuite de créer le profil et une bibliothèque au format de bibliothèque.

Objectif signifie ce pour quoi une vidéo est construite : portée (vues de non-abonnés), abonnements, sauvegardes ou partages. Quand la demande n'en nomme aucun, supposez la portée et dites-le.

Les tâches ici sont Script et Révision d'une vidéo publiée ; les idées vont vers content-ideas. Cette compétence s'arrête à un script ou une leçon : le tournage est au créateur, le montage à video-edit, l'animation à animated-video.

Idées

Trouver des idées et les sauvegarder est le rôle de content-ideas. Quand un script part d'une idée, ses notes disent déjà l'accroche, la question qu'elle ouvre, ce qui est retenu et la preuve : partez d'elles et vérifiez-les par rapport à la source avant de vous y fier.

Script

Énoncez l'idée en une phrase, avec son objectif. Une idée qui nécessite deux phrases correspond à deux vidéos ; demandez laquelle faire en premier.

Trouvez le gain et la preuve la plus forte avant l'accroche, puis écrivez l'accroche en deux parties : le sujet présenté comme le résultat que ce public veut, dans ses mots à propos de son problème, puis l'affirmation ou la preuve vraie la plus surprenante que vous ayez, qui ouvre une question que le spectateur pourrait formuler. Ne nommez pas le sujet quand le nommer répondrait à cette question. Rédigez au rythme du créateur (du profil ; par défaut 3 mots parlés par seconde). Trois moments sont liés à l'horloge, et l'intervalle entre eux suit une règle ; le reste prend la forme naturelle de l'histoire :

  • 0–3 s, l'accroche : à propos de l'enjeu du spectateur ou de ce qui est à l'écran. Les références viennent plus tard, comme raison de croire ; un résultat que le spectateur veut compte comme un enjeu quand il ouvre la question.
  • 3–10 s, la deuxième phrase : augmente les enjeux de l'accroche ou précise sa question, sans y répondre. La plupart des pertes évitables se produisent ici, donc le contexte attend. Le contexte est tout ce dont le spectateur a besoin seulement pour suivre un détail ultérieur (histoire, qui est quelqu'un, comment quelque chose fonctionne) ; le test : si déplacer une ligne après 15 s ne perd rien dans les 15 premières, c'est du contexte.
  • Entre les deux, la réponse est retenue : le gain n'est pas un moment unique. Nommez la ligne qui ferme la question de l'accroche, souvent un terme que le spectateur reconnaît : une fois qu'il l'entend, il pense connaître le reste. Avant, allez vers ce qui y mène et vaut la peine d'être entendu en soi : ce que la plupart des gens comprennent mal, ce que cela leur coûte, pourquoi les alternatives évidentes échouent. Quand elle est enfin dite, le même souffle ouvre une nouvelle question, quelque chose à son sujet qu'ils n'ont pas entendu. Retenir signifie leur donner autre chose entre-temps ; une ligne qui ne fait que taquiner ou dire « reste jusqu'à la fin » n'est pas retenir, c'est du remplissage.
  • La fin : le gain final, la promesse de l'accroche montrée à l'écran, puis au plus un court appel à l'action. Tout ce qui vient après le gain joue pour un public qui part.

Pour un explicateur (comment quelque chose fonctionne), lisez expliqueurs avant de rédiger.

À côté de chaque ligne, écrivez ce que le spectateur voit et la capture nécessaire (enregistrement d'écran, document, la personne ou le produit réel). Une ligne que personne ne pourrait dessiner est une ligne que le spectateur doit garder en tête. Pour un film animé, cette colonne est une note pour animated-video, qui conçoit l'univers.

Livrez et sauvegardez là où le profil le dit : le script en temps, ligne parlée et image à l'écran ; la liste des captures ; un projet de légende portant les avertissements et liens que le script parlé ne peut pas porter, dont l'ouverture soulève la question de l'accroche plutôt que d'y répondre ; la durée estimée ; les accroches alternatives, chacune avec sa propre deuxième phrase, quand l'ouverture est encore ouverte ; et les affirmations à vérifier, avec les sources (signalez toute source que vous n'avez pas pu ouvrir). Faites vérifier chaque affirmation telle que formulée dans le script par rapport à sa source par un agent frais : une recherche correcte peut encore être exagérée dans le script.

Quand le créateur réécrit certaines lignes, reportez les différences stylistiques sur les lignes que vous possédez encore. Gardez leur formulation sauf demande de modification, et signalez séparément les problèmes factuels.

Liste de vérification

Confrontez le script à ceci, au fichier de constats et aux notes de plateforme avant de le livrer :

  • Une seule idée. Une liste ne mérite sa place que lorsque chaque élément prouve cette idée.
  • L'enjeu est formulé en fonction de qui il affecte et de ce qu'ils veulent, dans des mots qu'un non-expert connaît. Les noms d'outils et le jargon viennent une fois que le spectateur a une raison de s'intéresser.
  • Lisez comme le spectateur : à chaque ligne, demandez-vous si vous auriez maintenant l'impression de connaître la réponse et de partir. Si oui avant le point prévu, déplacez la ligne ou ouvrez la question suivante à cet endroit. Dites ce qui ferme la question de l'accroche et quand.
  • Chaque affirmation est montrée. La voix, la légende et l'écran donnent le même chiffre.
  • Chaque promesse dans l'accroche est honorée à l'écran.
  • Chaque phrase, lue seule, dit qui fait quoi à quoi, et où va tout résultat. Remplacez les objets omis et les références ambiguës par le nom ; gardez les pronoms dont le référent est clair. Les révisions brisent cela, donc vérifiez à nouveau après chacune.
  • Les lignes sont des phrases complètes et connectées dans la voix du créateur (le guide vocal que le profil nomme), faciles à dire à voix haute. Une ligne coupée si courte qu'elle soulève une question (« l'itinéraire complet » de quoi ?) coûte plus que les secondes qu'elle économise.
  • Chaque ligne fait avancer l'histoire (une ligne qui répète la précédente ou annonce ce qui vient ne le fait pas), et la durée est aussi courte que l'histoire le permet.

Réviser une vidéo publiée

  • Enregistrez chaque chiffre : vues, spectateurs, durée de visionnage moyenne, abonnements, nombres d'interactions, chaque taux avec son étiquette, vues par source, et la courbe de rétention avec sa durée (lecture des insights). À partir d'une capture d'écran, lisez la courbe avec python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SECONDS et vérifiez sa moyenne basée sur la zone par rapport au chiffre de l'application. Identifiez la vidéo de chaque capture d'écran par sa vignette, les dates du graphique et le nombre de vues ; demandez quand ces preuves ne peuvent pas trancher.
  • Alignez la courbe avec les sous-titres du montage final : pour chaque chute et plateau, enregistrez ce qui a été dit et montré dans les secondes précédentes. Comparez avec la bibliothèque : les vidéos dans le même format, et la chute entre 3 et 10 s de chaque vidéo.
  • Nommez la version suivante quand il y en a une qui vaut la peine d'être faite : le plus petit changement qui répond à ce que vous avez trouvé, comme une nouvelle accroche ou une coupe là où les gens sont partis, ou ce qu'une vidéo qui a surpassé les autres a fait différemment et comment le répéter.
  • Écrivez l'entrée de la bibliothèque et la ligne d'index de la vidéo, puis mettez à jour le fichier de constats : ajoutez la preuve à chaque hypothèse qu'elle touche, et ne changez un statut que lorsque deux vidéos ou plus sont d'accord. Avant de sauvegarder, prenez chaque ligne citée et l'heure à partir du fichier de sous-titres, pas d'un résumé ; donnez une date de publication uniquement avec sa source ; vérifiez chaque mot de classement (le plus élevé, le plus bas, le seul, le meilleur) par rapport à l'index, limité aux vidéos qu'il couvre.

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

Skills associés