Que fait script ?
Le Writer écrit ce que l'utilisateur dit dans la vidéo. Objectif : l'utilisateur le lit une fois et l'enregistre. Chaque phrase porte ou prouve la promesse du titre et de la miniature.
Avant d'écrire
- Le titre et le texte de la miniature sont approuvés (
brief/TITLE-vNNN.md). Pas de titre, pas de script. - La preuve est approuvée (
brief/PROOF-vNNN.md). N'invente jamais un nombre, une expérience ou une citation. Si quelque chose manque, demande via le chat (crewcut say) avant d'écrire ; le script n'a pas de lacunes ni de placeholders. - Lis
voice.md(comment l'utilisateur parle, mots à utiliser et à éviter),brand/rules/script.md, et la durée dansedit-style.json(length_minutes) avec le débit de parole danschannel.json(script.words_per_minute). - Lis les fins des trois derniers scripts, afin que ce verdict prenne une nouvelle forme.
Structure
Deux formes. Utilise la forme test pour un outil ou une affirmation ; utilise la forme histoire quand quelque chose s'est passé (détails dans references/forms.md).
- Ouverture, de 2 à 6 phrases. Les premières secondes portent la promesse et son nombre : la phrase 1 nomme l'outil ou le sujet et son affirmation. Pas de salutation, pas de question, pas de "dans cette vidéo". Les 30 premières secondes confirment le clic : le spectateur voit qu'il a obtenu la vidéo promise par le titre et la miniature. Au plus une boucle ouverte, résolue à la fin.
- Le problème, dans un cas que le spectateur connaît. Explique un outil inconnu la première fois qu'il apparaît.
- Ce qu'il fait, en images, seulement ce que le spectateur ne sait pas encore.
- Le propre test, avec des chiffres réels, arrondis comme on parle. Uniquement les tests pour lesquels l'outil est conçu.
- Une ligne d'abonnement, juste après le premier résultat fort : ce que le spectateur obtient de la chaîne. Si aucun vendeur ne paie pour les tests, dis-le dans cette ligne. Jamais au début, jamais comme une supplication à la fin.
- Petites histoires avec des enjeux croissants. Chaque bloc entre l'ouverture et le verdict a un objectif, un obstacle et une solution ; de bloc en bloc, les enjeux montent (plus de données, plus d'argent, un test plus difficile). Le test le plus fort vient en dernier, avant le verdict ; l'ouverture peut l'annoncer mais pas le dévoiler.
- Le côté critique. Le chiffre du vendeur contre la propre mesure ou une mesure indépendante ; les limites. Si l'outil ne tient pas sa promesse, dis-le, et le titre retourne à l'étape titre.
- Le verdict, dans sa propre forme à chaque fois : une tâche pour le spectateur, le seul chiffre qui reste, ce que cela signifie pour le travail du spectateur, un rappel de l'image d'ouverture. Pas une question de clôture fixe.
- La fin. Si
channel.jsona une offre ou une mention obligatoire (script.end_mentions), elle vient dans les dernières phrases, dans les mots de l'utilisateur. La dernière phrase est leclosing_linede la chaîne quand il y en a une.
Vidéos de comparaison : au maximum deux blocs avec la même construction à la suite ; le troisième change de forme. Un nouvel accroche à la moitié. Chaque affirmation une fois. Le coût et le temps de tous les candidats une fois, ensemble à l'écran, pas à la fin de chaque bloc.
Mots
- Les mots de l'utilisateur depuis
voice.md; jamais les mots de sa liste d'évitement. - Phrases courtes : médiane d'environ 10 à 12 mots, jamais plus de
script.sentence_max_words. - Au maximum trois noms de produits dans une phrase ; les listes plus longues vont à l'écran.
- Exclus : les connaissances de base du public, les détails dont personne ne se soucie (nombre de tests, commutateurs internes), les noms de fichiers, les commandes, les sujets secondaires, les personnes privées, pourquoi un exemple a été choisi, les coûts qui ne font pas partie de la promesse.
- Pas de ton publicitaire ou commercial : dis ce qui a été testé, ne promets rien au spectateur. Pas de grand "pas ceci, mais cela" dans l'ouverture.
- Les affaires se montrent à travers des exemples, pas en s'adressant aux affaires du spectateur.
Format téléprompteur
L'utilisateur lit depuis un téléphone placé à côté de la caméra.
- Seul le texte parlé se trouve au-dessus d'une ligne
---. Les notes pour le montage (scènes, clips, d'où vient chaque nombre) vont en dessous. - Un paragraphe est une respiration : 1 à
script.paragraph_max_sentencesphrases. Une ligne vide est une courte pause. - Trois lignes vides séparent les parties : là, le montage peut couper, là le téléprompteur change de page, là un clip peut passer.
- Pas de crochets, d'indications scéniques, de titres, de chapitres, d'horodatages ou de ligne de titre. Des tirets seulement si le pack les autorise.
- Marque le ou les deux mots clés d'un paragraphe en gras. Le mode points du téléprompteur les affiche à la place du texte intégral, pour un utilisateur qui veut parler librement.
Étapes
- Remplis la structure avec les nombres prouvés.
- Coupe : chaque phrase porte ou prouve la promesse.
- Mets-le dans la voix de l'utilisateur. Lis chaque phrase dans ta tête : l'utilisateur dirait-il cela face à la caméra ?
- Écris le brouillon dans
work/script-draft-vNNN.mdavec le prochain numéro libre ; n'écrase jamais une version. - Passage Humanizer (voir ci-dessous). Écris le résultat dans
brief/SCRIPT-vNNN.md(même numéro), puis enregistre-le :crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<les motifs qui s'appliquaient>". - Vérifie jusqu'à 0 erreur :
python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<titre>" --name "<outil>" --proof brief/PROOF-vNNN.md. Lis chaque avertissement et indice ; un indice que tu conserves reçoit une phrase de raison en dessous de---. Si tu modifies le script pour passer la vérification, enregistre à nouveau le passage : la carte a besoin de l'enregistrement du fichier exact. - Carte :
crewcut card propose --episode <id> --step script --kind script --title "Script, version N" --file brief/SCRIPT-vNNN.md --body "<mots>, environ <min> min, vérification : 0 erreurs", puiscrewcut card wait. La carte indique "Humanisé" avec ce qui a changé ; sans l'enregistrement, elle est refusée et dit quoi exécuter. - Après le oui :
crewcut prompter <id>affiche le lien téléphone et un code QR. Dis à l'utilisateur en un message : le lien, combien de parties, environ combien de temps. Le téléprompteur n'affiche que le texte au-dessus de---.
Passage Humanizer
Chaque brouillon de script passe par Humanizer (blader/humanizer, MIT) avant que l'utilisateur ne le voie : aussi bien pour les longues vidéos que pour les Shorts. Crewcut télécharge sa version la plus récente au démarrage ; dans Claude Code, c'est la compétence humanizer:humanizer (exécute-la comme n'importe quelle compétence), avec Codex son texte est dans ton prompt. crewcut skills status affiche la version.
- Mode "Embedded", avec la voix de l'utilisateur. Lis d'abord chaque fichier dans
brand/voice/: les propres mots parlés de l'utilisateur issus de ses vidéos. Donne-les à Humanizer comme échantillon vocal. Pas d'échantillons : mode simple ; la carte le dit. - Ce qu'il faut le plus rechercher : les contrastes "pas X mais Y" ; les lignes de clôture qui n'apportent rien de nouveau ; les dictons qui semblent profonds ; une montée en scène avant le point ("voilà le truc") ; les listes de trois ; le sens gonflé et le langage publicitaire.
- Ce qui reste : les propres mots et expressions de l'utilisateur (ceux dans
brand/voice/etvoice.md) même quand Humanizer les lisserait ; chaque nombre, nom, affirmation et la promesse du titre. Le passage change la façon dont ça sonne, jamais ce que ça dit. - Ce qui est hors de portée : faire passer le texte aux détecteurs d'IA. Humanizer édite pour les humains, et nous aussi.
Ce que la vérification ne peut pas voir
Si un exemple devient trop large, si une partie s'écarte du fil conducteur, si un test correspond à la promesse, si la voix ressemble à celle de l'utilisateur. C'est le travail de lecture aux étapes 2 et 3.
Prévu
- Feuille de repérage et deux prises par partie (première libre avec une feuille de repérage, puis à partir du script ; le montage prend la meilleure prise) : format dans
references/forms.md; le vérificateur et le mix de prises (zettel.pydans le studio) ne sont pas encore portés. - Script contre enregistrement : comparer le script approuvé avec la transcription pour apprendre les vrais mots de l'utilisateur (ces transcriptions peuvent devenir de nouveaux échantillons vocaux).
- Une liste de vérification de phrases par langue (mots de remplissage, phrases de vente) comme données dans
voice.md.
Sources
-
Humanizer par blader, https://github.com/blader/humanizer (MIT), construit sur les "Signes d'écriture IA" de Wikipédia. Utilisé comme compétence, téléchargé au démarrage ; son texte ne fait pas partie de ce dépôt.
-
Vexian dans le podcast de Grant Owen, "The Crazy Genius Who Solved The Youtube Algorithm" : https://www.youtube.com/watch?v=41HMFGbENj4. Retenu : l'accroche est les premières secondes, chaque bloc est une petite histoire, le test le plus fort vient en dernier, la ligne d'abonnement avec indépendance, l'offre tard dans la vidéo.
-
Le manuel de production de MrBeast (public depuis 2024), résumé : https://simonwillison.net/2024/Sep/15/how-to-succeed-in-mrbeast-production/ Retenu : la première minute délivre ce que titre et miniature ont promis.
-
Narration dans les courtes vidéos de fondateurs : Farza (https://www.youtube.com/@farzatv), Chris Raroque (https://www.youtube.com/@raroque), Roy Lee (https://www.youtube.com/@im_roy_lee), Riley Brown (https://www.youtube.com/@rileybrownai), Varun Mayya (https://www.youtube.com/@VarunMayya), Codie Sanchez (https://www.youtube.com/@CodieSanchezCT). Retenu : première personne, le tournant, les chiffres réels irréguliers.