Communitygithub.com

Montage

Construit une version vidéo à partir de l'enregistrement de l'utilisateur : le cut du présentateur, puis un plan de montage avec tous les inserts (scènes 2D, scènes 3D, enregistrements, mots-clés), le son et la musique, le tout avec une seule commande (crewcut render).

Qu'est-ce que Montage ?

Cette compétence transforme l'enregistrement brut d'un utilisateur en une vidéo complète en deux étapes principales : d'abord la coupe du présentateur (meilleures prises, coupes aux pauses, étalonnage), puis un plan de montage détaillé (edit/plan-vNNN.json) contenant chaque insert, ses répliques et repères, ainsi que le son. L'outil crewcut render exécute l'ensemble du plan. La compétence s'appuie sur un pack de style externe (crewcut brand show) pour les couleurs, polices et niveaux, et sur des règles de goût définies dans brand/rules/edit.md et brand/rules/cut.md. Elle est conçue pour les utilisateurs de l'écosystème Crewcut, supporte les rendus locaux et sur GPU loués, et inclut des vérifications automatiques via la compétence cut-check. Le processus insiste sur la symbolique visuelle avant le texte, la comparaison avec des références de qualité, et l'honnêteté sur les sources et les limites techniques.

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

Demander à votre IA préférée

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

Documentation

Montage : un plan, une commande

L'éditeur transforme l'enregistrement de l'utilisateur en une vidéo en deux parties. D'abord la coupe du présentateur : les meilleures prises, coupées aux pauses, étalonnées. Ensuite le plan de montage (edit/plan-vNNN.json) : chaque insert, ses répliques et ses repères, le son. L'atelier crewcut render construit le plan. Rien dans cette compétence ne contient de couleur, de police ou de niveau : ceux-ci proviennent du pack de style (crewcut brand show). Le goût réside dans brand/rules/edit.md et brand/rules/cut.md.

À lire en premier

Vous voulezLisez
couper l'enregistrement en une coupe du présentateurreferences/record-to-cut.md (son jusqu'à la fin, fichiers fractionnés, dernière prise complète, doubles départs, coupures aux pauses, re-tournage, étalonnage, affichage et verrouillage)
écrire le plan, choisir ou construire une scène, montrer un enregistrementreferences/plan-and-scenes.md (ancres de mots, compter le mix, forme par déclaration, repères, nouvelle scène 2D, réutilisation, enregistrements)
faire la musique, régler les niveaux, ou louer un GPUreferences/sound-and-gpu.md (musique au fil de l'histoire, choisie par mesure, niveaux, pièges GPU, la carte de coût)
construire une scène 3Dcompétence 3d-scene
vérifier avant de montrercompétence cut-check (exécutée par le Critique, jamais par vous)

Noms des scènes et leurs clés de données : templates/2d/BLOCKS.md et templates/3d/README.md. Ne copiez pas les listes de clés ici.

Comment une version est fabriquée

  1. Coupe du présentateur (references/record-to-cut.md) : crewcut ingest, crewcut transcribe, crewcut cut …. Exécutez python3 skills/cut-check/scripts/cut_check.py <decisions> dessus et corrigez chaque ERREUR avant de construire dessus.
  2. Mots du montage final : crewcut transcribe audio/voice-vNNN.wav → work/words-vNNN.json. Tous les temps du plan proviennent de ces mots.
  3. Comptez le mix, puis listez les emplacements (section ci-dessous). Envoyez la liste sous forme de carte avant le grand rendu : crewcut card propose --episode $CREWCUT_EPISODE --step edit --kind mix --title "Inserts pour v002" --file edit/mix-v002.md. Continuez à construire pendant qu'elle est ouverte ; la carte est un aperçu, pas un verrou.
  4. Écrivez le plan avec un petit script générateur (edit/make_plan.py) qui fixe chaque temps à partir d'une ancre de mot. Ne tapez jamais les secondes à la main. Schéma : docs/architecture.md, "Plan de montage". Les valeurs laissées null proviennent du pack.
  5. crewcut render plan edit/plan-vNNN.json : liste chaque insert avec ses images et repères. Lisez-le. Un insert d'une demi-seconde est une mauvaise ancre.
  6. crewcut render 2d edit/plan-vNNN.json : inserts 2D, en local.
  7. 3D : crewcut render probe edit/plan-vNNN.json <id> donne une image fixe à demi-taille. Regardez-la à côté de la référence avant toute autre chose (compétence 3d-scene). Ensuite l'estimation des coûts et la carte (section "GPU loué ou local"), puis crewcut render 3d edit/plan-vNNN.json --rented --gpus N ou --local.
  8. crewcut render cut edit/plan-vNNN.json : assemblage avec le fond musical, les hits, la frappe, les silences, le ducking et la cible de loudness du pack. La sortie est non vérifiée. Dites au Showrunner : "construit, non vérifié, ne pas montrer".
  9. Passez la version au Critique (crewcut job add --episode $CREWCUT_EPISODE --identity critic --step edit "check plan-vNNN"). Ce n'est qu'après que les deux vérifications affichent 0 ERREUR que l'aperçu va dans export/, que le Showrunner le montre sous forme de carte avec le fichier (crewcut card propose … --kind preview --file export/<id>-vNNN-preview.mp4), et immédiatement après avoir montré : crewcut render shown edit/plan-vNNN.json. Dès lors, tout changement est une nouvelle version du plan, même pour deux images.

Un texte ou un nombre modifié : changez le plan (nouvelle version), exécutez les étapes 5 à 9. Seuls les inserts modifiés sont rendus à nouveau. crewcut render all <plan> exécute 2D, 3D et cut en une seule fois quand rien ne nécessite un coup d'œil entre les deux.

D'abord le mix, ensuite le plan

Ces règles s'appliquent à chaque plan, avant qu'une image ne soit rendue. Les limites proviennent de edit-style.json.

  1. Le symbole avant le texte. Chaque insert montre d'abord quelque chose qui se produit. Une carte de texte (headline, post) uniquement là où le spectateur doit lire une source réelle : au maximum text_cards_max sources et au maximum text_share_max des inserts plein écran. keyword uniquement pour un nombre ou un nom, au maximum keywords_max, chacun au maximum keyword_max_words mots. Comptez par type avant de rendre ; la vérification de style recompte.
  2. Symbolique signifie 2D et 3D. 3D là où un objet avec une action est l'idée. Dessin 2D pour les processus, quantités, manières et comparaisons : des formes qui se construisent, bougent ou changent. Par emplacement, choisissez ce qu'un spectateur comprend en 2 secondes. Une scène contient au plus un mot ou un nombre, sur le mot parlé.
  3. La barre est la référence, pas "ça rend". Comparez avec baseline.json et brand/references/. Les GPU loués sont pour la qualité : pleine résolution, suffisamment d'échantillons, ombres douces, bords propres. La 2D est du motion design, pas un diaporama : les parties se construisent les unes après les autres, la caméra dérive un peu, les transitions sont douces.
  4. Vérifiez chaque scène avant le cut. Une image fixe et une bande de 5 images à côté de la référence. Si cela ressemble à un diaporama, un clip art ou un modèle, jetez-le et reconstruisez-le. Quelques très bonnes scènes battent de nombreuses scènes moyennes ; réutilisez une scène 2 à 4 fois avec un autre mot ou état.
  5. Matériel réel, sans qu'on le demande. Une publication, une annonce ou un résultat tiers va dans l'image : la publication sous forme de carte avec une marque sur le mot parlé, une courte vidéo tierce sur une carte avec sa source visible. Jamais de capture d'écran inventée, jamais de logo d'entreprise que vous avez fabriqué.
  6. La musique appartient à l'histoire (references/sound-and-gpu.md). Instruments uniquement, calme sous la voix, avec une note de source et de droits.
  7. Calculez vite, jamais inactif. Pendant que les machines chargent, continuez à travailler en local (plan, 2D, cut). Chaque étape distante a une limite de temps. À la fin, prouvez qu'aucune machine ne tourne.
  8. Montrez la liste avant le grand rendu (étape 3) : temps, type, une ligne de ce qu'on voit, le nombre de cartes de texte.

Scènes

Scènes 2D (HTML, rendues par Chromium, stylisées par les tokens de la marque) et scènes 3D (Blender par code, templates/3d/). Clés de données : templates/2d/BLOCKS.md, templates/3d/README.md. Quelle forme pour quelle déclaration : references/plan-and-scenes.md, section 3.

TypeScènes
2D nombres et quantitéscounter, bars, grid, wave
2D sources et matériel réelheadline, post, clip-card, cards, swap
2D idées dessinéesarea, flow, untangle
2D par-dessus le présentateur (transparent)keyword
3Dobject-word, row, grid3d, stack, slide, box, scale (kit partagé templates/3d/stage.py)
enregistrement"kind": "clip" avec file, at, speed : un enregistrement terminé en plein écran

Le pack neutre fournit peu de scènes 3D générales. Les scènes propres à l'utilisateur vont dans brand/templates/ (ne jamais modifier les modèles de l'application). Une nouvelle scène reçoit une ligne dans BLOCKS.md ou templates/3d/README.md et n'est pas testée tant qu'une image de celle-ci n'a pas été examinée.

Règles de mix (valeurs du pack)

  • Part 3D : environ graphics_mix.3d des inserts ; la 2D porte les chiffres ; le présentateur est à l'écran entre les deux.
  • Coupez sur le mot, pas sur le tempo. Le mot dans l'image arrive 0 à 3 images avant qu'il ne soit prononcé.
  • Divisez les longues séquences du présentateur avec "speaker": [{"at": s, "zoom": z}] (zoom de zoom_base à zoom_punch, jamais au-dessus de zoom_max).
  • Le présentateur n'est jamais plus court que speaker_min_seconds entre deux parties plein écran, et au moins speaker_open_close_seconds au début et à la fin.
  • Son : fond musical à music_db avec duck, un hit uniquement aux endroits forts, frappe sous les compteurs, une courte pause dans la musique avant le nombre le plus important. Loudness loudness_lufs, pic réel au maximum true_peak_db.
  • Sources honnêtes : une carte de titre nomme la source réelle.
  • Ne prétendez jamais à une vérification visuelle ou auditive qui n'a pas eu lieu. Cette session ne peut pas entendre : nommez les temps.

Lorsque vous appliquez une règle provenant d'une source nommée, vous pouvez le dire en une ligne, par exemple crewcut say --episode $CREWCUT_EPISODE --cite "montage rapide et légendes de mots-clés après le style de montage d'Alex Hormozi" "…".

GPU loué ou local

  • Les images 3D sont rendues dans Blender Cycles. Local signifie le CPU du conteneur : acceptable pour les sondes à demi-taille et les scènes très courtes. Tout ce qui est plus long va sur un GPU loué.
  • Coût d'abord. crewcut compute estimate --kind blender --frames N [--local-sec-per-frame S] imprime le temps et l'argent pour le local et la location. Mettez l'estimation sur une carte (--kind spend, titre avec le montant), attendez avec crewcut card wait <id>. Sortie 3 signifie non : rendez localement ou abandonnez la scène. Seule une identité avec may_spend: true loue (l'Éditeur).
  • Toujours : images fixes à demi-taille d'abord, puis l'animation.
  • Seuls le code de la scène et les polices vont sur une machine louée. Jamais de séquences, voix, clés ou données privées.
  • À la fin : crewcut compute destroy --all-ours, puis crewcut compute ledger --episode ID ; le rapport à l'utilisateur contient la dépense et la preuve qu'aucune machine ne tourne. Aussi après un échec.
  • Pièges et ce que les outils en font : references/sound-and-gpu.md, section B.

Limites honnêtes

  • L'agent ne peut pas entendre. Tout jugement sur la musique et la voix est une liste d'écoute avec les temps pour l'utilisateur.
  • La détection d'un reste de mot, d'un double départ ou d'un saut de niveau trouve des candidats, pas des certitudes.
  • La vérification de style mesure les limites ; si une scène a bonne allure, seul un humain peut le dire. Mettez les images à côté de la référence et dites clairement quelles scènes sont encore en dessous.

Prévu

  • Re-timing des rendus 3D lorsque les temps des mots changent de quelques images, afin qu'ils ne soient pas rendus à nouveau.
  • Musique générée sur un GPU loué via crewcut compute (le studio l'a fait à la main ; voir references/sound-and-gpu.md).
  • Enregistrements de pages Web comme étape de rendu (Chromium est dans le conteneur ; pas encore de commande).
  • Feuilles de comparaison (image de scène à côté de la référence) en une seule commande.
  • Un auto-test sur l'épisode de démo dans examples/demo/ une fois qu'il existe.

Sources

Aucune connexion ni approbation de la part de ces personnes ; nous avons pris des idées et écrit notre propre résumé.

  • Alex Hormozi (style de montage et légendes réalisés par son éditeur Ryan Magin), https://www.youtube.com/@AlexHormozi : montage rapide sur le mot et légendes courtes de mots ; ici réduit aux légendes de mots-clés.
  • fern (chaîne YouTube), https://www.youtube.com/@fern-tv : inspiration pour le look d'argile 3D uniquement. Aucune valeur n'en provient.

Individual skills in this repo

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

script

Writes the spoken script of an episode in the user's own voice (voice.md), in teleprompter form, after title and proof are fixed: opening that delivers the title's promise, small stories with rising stakes, the critical side, a verdict in its own form, the channel's closing line. skills/script/scripts/script_check.py checks form, sentences, opening, ending, numbers against the proof, and length. Delivered through the web teleprompter (crewcut prompter). Use when: \"write the script\", \"teleprompter text\", \"rewrite the script\", \"shorten the script\", \"make it sound natural\", \"script for the episode\". Not for titles or thumbnails. Short scripts: the `--short` mode of the check and skills/shorts.

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