Communitygithub.com

Rédacteur de Script Vidéo

Utilisez cette compétence lorsque l'utilisateur souhaite rédiger un script vidéo pour une démo produit, une présentation de fonctionnalité, une vidéo de lancement ou une vidéo pour les réseaux sociaux à propos d'une fonctionnalité ou d'un changement produit.

Qu'est-ce que Rédacteur de Script Vidéo ?

Cette compétence est conçue pour les agents IA spécialisés dans la création de contenu vidéo technique. Elle guide l'utilisateur à travers un processus structuré en six phases pour produire des scripts vidéo professionnels : découverte, configuration, plan, rédaction, révision et sortie finale. Elle prend en charge plusieurs types d'entrée (brief marketing, article de blog, changelog, newsletter, PR GitHub, plage de références git, fichier/dossier, ou texte libre) et les résout automatiquement pour extraire le contexte nécessaire. La compétence propose des configurations personnalisables comme la durée de la vidéo (court ou moyen format), le type de script (voix off, deux colonnes, ou face caméra) et le ton, avec des templates prédéfinis. Elle est compatible avec tous les systèmes d'agents IA capables d'exécuter des commandes shell et de lire des fichiers (par exemple, Claude Code, Cursor, Codex). Grâce à ses vérifications de contenu sensible et ses boucles de rétroaction, elle garantit des scripts de qualité, bien rythmés et conformes aux meilleures pratiques de narration vidéo.

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

Que fait Rédacteur de Script Vidéo ?

Rédigez des scripts vidéo pour des démos produit, des présentations de fonctionnalités et des vidéos de lancement. Gère le rythme, les indications visuelles, le minutage et les longueurs adaptées à la plateforme.

Résolution de l'entrée

Résolvez l'argument (s'il est fourni) dans cet ordre :

  1. Chemin vers un brief marketing existant (.md contenant "Résumé Exécutif" ou "Messages Clés") -> brief marketing
  2. Chemin vers un article de blog existant (.md avec structure d'article de blog) -> article de blog
  3. Chemin vers un changelog existant -> changelog
  4. Chemin vers une newsletter existante -> newsletter
  5. Correspond à une URL GitHub ou à un motif #\d+ -> PR
  6. Contient ... ou .. -> plage de références git
  7. Résout vers un fichier/répertoire existant -> fonctionnalité du codebase
  8. Sinon -> texte libre

Si aucun argument n'est fourni, demandez : "De quoi doit parler la vidéo ? Vous pouvez fournir un brief marketing, un article de blog, un changelog, une URL/numéro de PR, une plage de références git, un chemin de fichier/répertoire, ou simplement décrire la fonctionnalité."

Si plusieurs interprétations correspondent, confirmez avec l'utilisateur.

Flux du processus

digraph video_script {
    rankdir=TB;
    "Resolve input" [shape=box];
    "Phase 1: Discovery" [shape=box];
    "Phase 2: Configure" [shape=box];
    "Phase 3: Outline" [shape=box];
    "Outline approved?" [shape=diamond];
    "Phase 4: Write" [shape=box];
    "Phase 5: Review" [shape=box];
    "Approved?" [shape=diamond];
    "Phase 6: Output" [shape=box];

    "Resolve input" -> "Phase 1: Discovery";
    "Phase 1: Discovery" -> "Phase 2: Configure";
    "Phase 2: Configure" -> "Phase 3: Outline";
    "Phase 3: Outline" -> "Outline approved?";
    "Outline approved?" -> "Phase 3: Outline" [label="non, réviser"];
    "Outline approved?" -> "Phase 4: Write" [label="oui"];
    "Phase 4: Write" -> "Phase 5: Review";
    "Phase 5: Review" -> "Approved?";
    "Approved?" -> "Phase 4: Write" [label="révisions"];
    "Approved?" -> "Phase 6: Output" [label="oui"];
}

Ne SAUTEZ PAS les phases. Posez les questions à un rythme naturel. Si l'utilisateur répond à plusieurs à la fois, acceptez les réponses groupées et passez à la suite.

Si l'utilisateur dit "choisis les valeurs par défaut" ou quelque chose de similaire, choisissez des valeurs par défaut raisonnables, indiquez ce que vous avez choisi et demandez une seule confirmation.

Phase 1 : Découverte

Étape 1 - Analyser l'entrée

Type d'entréeCe qu'il faut lire
Brief marketingExtraire l'énoncé du problème, la proposition de valeur, l'audience, les messages clés. Passer à l'étape 3. Faire quand même l'étape 2 si le brief manque de contexte produit.
Article de blogExtraire le titre, les points clés, l'audience, l'Appel à l'Action. Passer à l'étape 3.
ChangelogExtraire les entrées clés, se concentrer sur les changements les plus importants. Passer à l'étape 3.
NewsletterExtraire le sujet, les mises à jour clés, l'Appel à l'Action. Passer à l'étape 3.
PRDiff, description de la PR, commentaires de révision, messages de commit. Pour les grandes PR (20+ fichiers), se concentrer sur les changements visibles par l'utilisateur.
Références gitgit diff et git log entre les références. Prioriser les changements visibles par l'utilisateur.
Fonctionnalité du codebaseLire les fichiers/répertoires spécifiés.
Texte libreAnalyser la description de l'utilisateur. Si elle manque de détails, demander à l'utilisateur de fournir plus de détails ou de pointer vers un fichier/PR spécifique.

Les changements visibles par l'utilisateur incluent : nouvelles fonctionnalités, modifications de l'interface utilisateur, modifications de l'API, améliorations des performances, corrections de bugs et mises à jour de la documentation. Les changements internes incluent : refontes, ajouts de tests, modifications CI et mises à jour de dépendances.

Gestion des erreurs :

  • gh non disponible -> informer l'utilisateur, proposer une autre entrée
  • PR/référence invalide -> demander à l'utilisateur de vérifier
  • Fichier introuvable -> demander le chemin correct

Étape 2 - Lire le contexte produit plus large

Lire s'ils existent : README, docs/, package.json (ou équivalent).

Si rien n'est trouvé, demander : "Pouvez-vous décrire brièvement le produit et à qui il s'adresse ?"

Étape 3 - Présenter la compréhension

"Voici ce sur quoi je vais baser le script vidéo :"

  • Fonctionnalité A - description courte
  • Fonctionnalité B - description courte

"Quelque chose à ajouter, supprimer ou corriger ?"

Ne PAS continuer tant que l'utilisateur n'a pas confirmé le périmètre.

Étape 4 - Vérification du contenu sensible

Avant de continuer, rechercher le contenu potentiellement sensible : correctifs de sécurité, tarifs internes, identifiants, éléments de feuille de route non publiés ou contenu marqué comme confidentiel. Signaler tout élément douteux à l'utilisateur.

Phase 2 : Configuration

Poser ces questions :

Q1 - Durée de la vidéo :

  • Court format (30-90 secondes) - réseaux sociaux (Reels, Shorts, TikTok)
  • Moyen format (3-5 minutes) - YouTube, démos produit, présentations

Q2 - Type de script :

  • Voix off - texte de narration lu sur des enregistrements d'écran/séquences
  • Deux colonnes - colonne de gauche : directions visuelles/actions à l'écran, colonne de droite : narration
  • Face caméra - orateur à l'écran, présentation conversationnelle

Q3 - Ton : Lire le contenu existant du dépôt pour détecter la voix. Confirmer :

"D'après votre contenu existant, le ton semble [par exemple, conversationnel et orienté développeur]. Dois-je m'aligner là-dessus ou adopter une direction différente ?"

S'il n'y a pas de contenu à analyser, demander directement.

Q4 - Appel à l'Action (CTA) : Déduire du contexte :

  • Open source -> "Stargazer le dépôt", "Essayer"
  • SaaS -> "S'inscrire gratuitement", "Commencer votre essai"
  • Mise à jour de fonctionnalité -> "Essayer maintenant", "Consulter la documentation"

"Je suggère que le CTA soit : [CTA déduit]. Vous voulez continuer avec celui-ci ou un autre ?"

Phase 3 : Plan

Générer un plan structuré avec minutage. Utiliser le modèle approprié en fonction de la durée de la vidéo :

Court format (30-90 secondes) - 3 à 4 sections :

## [Titre de travail] - [durée totale]

1. **Accroche** (0:00-0:05) - [approche]
   - Point clé
   - Visuel : [quoi montrer]

2. **Problème** (0:05-0:15) - [point de douleur à établir]
   - Visuel : [quoi montrer]

3. **Solution** (0:15-0:45) - [présentation de la fonctionnalité]
   - Point clé A
   - Visuel : [quoi montrer]
   - Point clé B
   - Visuel : [quoi montrer]

4. **CTA** (0:45-0:60) - [action à entreprendre]
   - Visuel : [écran de fin]

Estimation totale : ~X mots (~Y secondes à 135 MPM)

Moyen format (3-5 minutes) - 5 à 8 sections :

## [Titre de travail] - [durée totale]

1. **Accroche** (0:00-0:10) - [approche]
   - Visuel : [quoi montrer]

2. **Problème** (0:10-0:30) - [point de douleur, contexte, pourquoi c'est important]
   - Visuel : [quoi montrer]

3. **Présentation de la solution** (0:30-1:00) - [aperçu général de ce qui a été construit]
   - Visuel : [quoi montrer]

4. **Plongée en profondeur : [Fonctionnalité A]** (1:00-2:00) - [présentation]
   - Points clés
   - Visuel : [étapes d'enregistrement d'écran]

5. **Plongée en profondeur : [Fonctionnalité B]** (2:00-3:00) - [présentation]
   - Points clés
   - Visuel : [étapes d'enregistrement d'écran]

6. **Plongée en profondeur : [Fonctionnalité C]** (3:00-3:45) - [présentation]
   - Points clés
   - Visuel : [étapes d'enregistrement d'écran]

7. **Récapitulatif** (3:45-4:30) - [résumer les principaux avantages]
   - Visuel : [diapositive récapitulative ou côte à côte]

8. **CTA** (4:30-5:00) - [action à entreprendre]
   - Visuel : [écran de fin]

Estimation totale : ~X mots (~Y secondes à 135 MPM)

Ajuster le nombre de segments de plongée en profondeur en fonction des fonctionnalités à couvrir.

Présenter le plan et attendre l'approbation avant d'écrire.

Phase 4 : Rédaction

Référence de rythme

Durée de la vidéoMots ciblesMPM
30 secondes~65 mots130
60 secondes~135 mots135
90 secondes~200 mots135
3 minutes~400 mots135
5 minutes~675 mots135

Viser 130-145 MPM pour une présentation conversationnelle. Signaler toute section qui dépasse son temps alloué.

Format du script par type

Script voix off :

## [Titre]

### Accroche (0:00-0:05) - ~15 mots
VISUEL : [Description de ce qui est à l'écran]

[Texte de narration ici.]

### Nom de la section (0:05-0:20) - ~30 mots
VISUEL : [Description de ce qui est à l'écran]

[Texte de narration ici.]

Script deux colonnes :

| Temps | Visuel | Narration |
|---|---|---|
| 0:00-0:05 | [Écran : la page d'accueil se charge] | [Texte de narration] |
| 0:05-0:15 | [Écran : cliquer sur le menu paramètres] | [Texte de narration] |
| 0:15-0:30 | [Écran : activer le mode sombre] | [Texte de narration] |

Script face caméra :

## [Titre]

### Accroche (0:00-0:05) - ~15 mots
CAMÉRA : [Orateur à l'écran, plan moyen]

[Texte de l'orateur ici. Conversationnel, directement à la caméra.]

### Nom de la section (0:05-0:20) - ~30 mots
CAMÉRA : [Couper à l'enregistrement d'écran]
VOIX OFF : [Narration sur l'enregistrement d'écran]

CAMÉRA : [Retour à l'orateur]
[Texte de l'orateur ici.]

Accroche

Les 3 à 5 premières secondes déterminent si les spectateurs continuent à regarder. L'accroche doit :

  • Aborder un point de douleur ou poser une question provocante
  • NE PAS commencer par le nom de votre entreprise/produit
  • NE PAS commencer par "Dans cette vidéo, je vais vous montrer..."
  • Créer une curiosité immédiate ou une résonance émotionnelle

Directions visuelles

Toujours inclure les directions visuelles en ligne, quel que soit le type de script :

  • VISUEL : / ÉCRAN : pour les enregistrements d'écran et séquences
  • CAMÉRA : pour les directions de caméra face caméra
  • Être précis : "ÉCRAN : Cliquer sur le bouton d'exportation, montrer le téléchargement du PDF" pas "ÉCRAN : Montrer la fonctionnalité"
  • Inclure des notes de transition entre les scènes

Minutage par section

Inclure la durée estimée et le nombre de mots pour chaque section :

  • ### Nom de la section (0:15-0:30) - ~30 mots
  • Signaler si une section dépasse son budget de temps
  • Le nombre total de mots du script doit correspondre à la durée cible à 135 MPM

Règles de rédaction

  • Conversationnel, pas d'effet scripté. Écrire comme les gens parlent réellement.
  • Phrases courtes. Maximum 10-15 mots par phrase.
  • Une idée par phrase.
  • Toujours à la voix active.
  • Ne jamais utiliser de tirets cadratins dans le contenu généré. Pas de caractères "---". Utiliser des virgules, des deux-points, des points ou des parenthèses à la place.
  • Montrer, ne pas dire. "Regardez à quelle vitesse ça charge" > "Ça charge très vite"
  • Pour les vidéos de moyen format, utiliser la règle de trois : trois avantages, trois fonctionnalités, trois exemples. Pour le court format, se concentrer sur un seul avantage clé.

Appel à l'Action (CTA)

  • Dernières 5 à 10 secondes de la vidéo
  • Action unique et claire
  • Inclure une direction visuelle pour l'écran de fin (bouton d'abonnement, superposition de lien, code QR)

Phase 5 : Révision

Présenter le script complet avec la répartition du timing :

"Voici le script :"

[Script complet]

Répartition du timing :

  • Accroche : 5s (~15 mots)
  • Problème : 10s (~25 mots)
  • Solution : 30s (~70 mots)
  • CTA : 10s (~20 mots)
  • Total : 55s (~130 mots à 135 MPM)

"Vous voulez des modifications ?"

Attendre l'approbation. Ne passer à la sortie que lorsque l'utilisateur confirme.

Phase 6 : Sortie

Toujours imprimer le script final approuvé dans le terminal.

Ensuite demander : "Voulez-vous que je l'enregistre dans scripts/<slug>.md ? Ou un autre chemin ?"

C r éer le répertoire s'il n'existe pas. Si le fichier existe déjà, demander s'il faut écraser ou créer une copie versionnée.

Gestion des erreurs

  • gh non disponible -> informer l'utilisateur, proposer une autre entrée
  • PR/référence invalide -> demander à l'utilisateur de vérifier
  • Pas de contexte produit -> demander à l'utilisateur de décrire le produit
  • Le script dépasse la durée cible -> signaler et suggérer des coupes avant la révision

Ce que cette compétence NE fait PAS

  • Enregistrer ou monter la vidéo
  • Générer des vignettes ou des ressources visuelles
  • Créer des animations ou des graphiques animés
  • Rédiger des articles de blog ou des contenus sociaux (utiliser /blog-post ou /social-copy)

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Skills associés