CommunityRédaction et éditiongithub.com

script

Rédige le script parlé d'un épisode dans la voix de l'utilisateur, au format téléprompteur, après que le titre et la preuve sont fixés.

Qu'est-ce que script ?

Cette compétence génère le script parlé d'un épisode vidéo, rédigé dans la voix naturelle de l'utilisateur et formaté pour un téléprompteur (crewcut prompter). Elle s'appuie sur les apports du titre approuvé, de la preuve factuelle, du guide vocal `voice.md`, des règles de marque et de la durée cible. Le script suit une structure éprouvée : accroche immédiate, problème concret, démonstration, test personnel avec chiffres réels, petites histoires aux enjeux croissants, côté critique, verdict original et fin conforme à la chaîne. L'outil intègre un module de vérification (`script_check.py`) qui valide la forme, le nombre de phrases, l'ouverture, la fin, les chiffres et la longueur. Il propose également un passage “Humanizer” pour rendre le texte plus oral et authentique, tout en préservant les faits et la promesse du titre. Utilisé pour les commandes comme "écris le script", "texte pour téléprompteur", "réécris le script", "raccourcis le script". Ne convient pas pour les titres ou miniatures. Une variante courte existe via le mode `--short` et la compétence `skills/shorts`.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/marcopatzelt/crewcut/tree/HEAD/skills/script

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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 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

  1. Le titre et le texte de la miniature sont approuvés (brief/TITLE-vNNN.md). Pas de titre, pas de script.
  2. 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.
  3. Lis voice.md (comment l'utilisateur parle, mots à utiliser et à éviter), brand/rules/script.md, et la durée dans edit-style.json (length_minutes) avec le débit de parole dans channel.json (script.words_per_minute).
  4. 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).

  1. 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.
  2. Le problème, dans un cas que le spectateur connaît. Explique un outil inconnu la première fois qu'il apparaît.
  3. Ce qu'il fait, en images, seulement ce que le spectateur ne sait pas encore.
  4. Le propre test, avec des chiffres réels, arrondis comme on parle. Uniquement les tests pour lesquels l'outil est conçu.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. La fin. Si channel.json a 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 le closing_line de 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_sentences phrases. 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

  1. Remplis la structure avec les nombres prouvés.
  2. Coupe : chaque phrase porte ou prouve la promesse.
  3. Mets-le dans la voix de l'utilisateur. Lis chaque phrase dans ta tête : l'utilisateur dirait-il cela face à la caméra ?
  4. Écris le brouillon dans work/script-draft-vNNN.md avec le prochain numéro libre ; n'écrase jamais une version.
  5. 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>".
  6. 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.
  7. 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", puis crewcut card wait. La carte indique "Humanisé" avec ce qui a changé ; sans l'enregistrement, elle est refusée et dit quoi exécuter.
  8. 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/ et voice.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.py dans 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

Individual skills in this repo

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

edit

Builds a video version from the user's recording: the speaker cut, then one edit plan with all inserts (2D scenes, 3D scenes, recordings, keywords), sound and music, built with one command (crewcut render). Use for: edit the video, build the cut, speaker cut, rough cut, insert, b-roll, 2D scene, 3D insert, counter, keyword, music bed, sound, assemble, render the preview, new plan version, short from the long video.

shorts

Makes YouTube Shorts in two modes: Clip (cut from a finished episode: candidates from the transcript and retention, a 9:16 rough cut from the original recording around the face, portrait graphics, music with clear rights, the Critic's own Short check) and Original (a Short recorded for itself: three ideas with a proof from the user's real work, the user talks freely, the Writer shortens, only the speaker is recorded, the crew brings the B-roll). Publishing: one card per Short, or the user's own standing approval for Shorts; at most two a day. Use when: \"make shorts\", \"make a short about …\", \"clip this episode\", \"short from episode N\", \"publish shorts without asking\", \"how are my shorts doing\". Not for long videos (skills/episode, skills/edit).

title

Writes and checks the YouTube title and the thumbnail text of an episode, before the script. Delivers five candidates with a hook and a reason each, one recommendation, and three variants for the A/B test; skills/title/scripts/title_check.py checks every candidate against the style pack. Use when: \"title\", \"video title\", \"YouTube title\", \"what should the video be called\", \"check this title\", \"shorten the title\", \"better title\", \"thumbnail text\". Not for the blog's search title and not for the thumbnail image.

Skills associés