Communitygithub.com

reel-from-raw

Transforme une vidéo brute de type talking-head (Hinglish ou anglais, verticale 9:16) en un Reel Instagram édité avec Remotion : coupures de silence, zooms punch-in, titres 3D, panneaux de terminal, fuites de lumière, effets sonores, carte de suivi.

Qu'est-ce que reel-from-raw ?

Ce skill permet à un agent IA de transformer une vidéo brute de type « talking-head » (Hinglish ou anglais, format 9:16) en un Reel Instagram prêt à être publié, en utilisant la bibliothèque Remotion. Il est conçu pour fonctionner avec des assistants comme Claude Code (via des hooks) ou OpenCode (via un plugin dédié). Le skill suit un workflow rigoureux en 10 étapes : création du projet, transcription (avec correction des erreurs de compréhension via un glossaire), coupure des silences, génération d'une feuille de beats approuvée par l'utilisateur, construction de la scène dans `Reel.tsx`, vérification de type automatique, contrôle visuel via des captures d'instantanés, vérification des effets sonores, prévisualisation dans Remotion Studio, et rendu final uniquement sur demande explicite. Il impose des règles strictes : ne jamais deviner les timings (ils sont extraits de `work/words.txt`), utiliser uniquement les composants de la bibliothèque `src/`, respecter des zones de sécurité précises, et ne pas lancer de rendu complet sans l'autorisation de l'utilisateur (`RENDER_OK=1`). Les effets sonores sont prédéfinis (whoosh, pop, typing…) avec des volumes calibrés, et le skill propose des recettes exactes pour des demandes courantes comme modifier le volume global ou changer un son spécifique.

Compatible avec✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

Demander à votre IA préférée

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

Documentation

Reel à partir d'une vidéo brute

Validé sur deux reels : Linux Day 2 et Linux Day 1 (avec effets sonores). library/Reel.tsx est le reel du Jour 1. Recopiez ses motifs. N'inventez pas un nouveau style.

Fonctionne sur macOS et sur Linux / Windows WSL. Installation : voir README.md dans le dépôt.

Règles strictes

  1. Chaque superposition est synchronisée à partir des secondes de work/words.txt. Ne devinez jamais un timing.
  2. Utilisez uniquement les composants de src/ (bibliothèque). N'ajoutez un nouveau composant que si aucun composant existant ne correspond à un beat.
  3. Gardez le visage dégagé. Zones de sécurité (1080x1920) :
    • Étiquettes et titres en haut : y de 90 à 400.
    • Visage et cou : y d'environ 450 à 1350. Rien ici à l'exception des cartes de titre plein écran (3 s max).
    • Tout le reste se place sous le cou (le premier bouton de la chemise) : y de 1360 à 1880. Panel commence à BELOW_NECK (1360). Utilisez fit pour redimensionner un panneau haut afin qu'il se termine à 1880.
    • Trouvez la ligne du cou pour chaque nouvelle vidéo : capturez une image avec une grille y et observez. Mettez à jour BELOW_NECK dans ui.tsx.
  4. Ne lancez pas le rendu de la vidéo complète sauf si l'utilisateur le demande dans le chat. Utilisez scripts/stills.sh pour vérifier. Un hook bloque remotion render sans RENDER_OK=1.
  5. Ne téléchargez rien (modèles, polices, musique, packs sonores) sans demander à l'utilisateur.
  6. Lisez reference/known-problems.md avant de déboguer quoi que ce soit.
  7. Dans OpenCode, le plugin ~/.config/opencode/plugins/reel-from-raw effectue le même travail que les hooks Claude (blocage du rendu, vérification de type, rappel d'instantanés). Ouvrez les images des feuilles avec l'outil de lecture. Si votre modèle ne peut pas voir les images, demandez à l'utilisateur de vérifier les feuilles.

Règles de périmètre (suivre exactement)

  1. Ne faites que ce que l'utilisateur a demandé. Modifiez uniquement les fichiers et valeurs nécessaires à la demande.
  2. Une vérification (vérification de type, vérification d'instantanés, rappel d'un hook ou plugin) est uniquement une vérification. Corrigez uniquement ce qui enfreint une règle de ce fichier ou de reference/style-spec.md. Ne refaites jamais le style, n'ajoutez pas un composant, n'ajoutez pas une scène, et ne modifiez pas le texte, le timing ou le volume à cause d'une vérification.
  3. Si vous pensez que quelque chose d'autre devrait changer, dites-le à l'utilisateur en une ligne. Ne le modifiez pas.
  4. Ne modifiez jamais ~/.claude/skills/reel-from-raw/ (ce skill) pendant que vous travaillez sur une vidéo. Modifiez uniquement le projet vidéo.
  5. Un fichier de test que vous créez (par exemple src/__probe.ts) doit être supprimé avant de terminer.

Flux de travail (nouvelle vidéo)

Exécutez chaque étape. Chaque script affiche OK: en cas de succès. Arrêtez-vous et corrigez en cas d'ERROR.

#ÉtapeCommande / action
1Créer le projetbash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (par exemple ~/Coding/motion-videos/<nom>). Il copie la bibliothèque, les fichiers sonores et les hooks, et installe les paquets npm (ou les clone depuis $REEL_SEED).
2Transcrirebash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (utilisez en pour l'anglais uniquement). Corrigez ensuite les erreurs de compréhension avec reference/glossary.md.
3Couper les silencespython3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Utilisez --start/--end pour supprimer un faux départ ou une fin.
4Feuille de beatsSuivez reference/beat-sheet-prompt.md. Écrivez work/beats.md. Montrez-la à l'utilisateur s'il souhaite approuver le plan.
5Construiresrc/Reel.tsx est le reel du Jour 1. Réécrivez-le à partir de la feuille de beats. Dans Root.tsx, définissez id (par exemple LinuxDay3) et le vrai handle. Supprimez les composants de scène que le reel n'utilise pas. Gardez les assistants At et r().
6Vérification de typeAutomatique : un hook exécute tsc --noEmit après chaque modification. Corrigez chaque erreur signalée.
7Vérification visuellebash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, puis lisez chaque out/stills/sheet*.jpg. Vérifiez également les images des beats : stills.sh <dir> 120,450,.... Vérifiez par rapport à reference/style-spec.md. Corrigez et répétez.
8Vérification sonoreLes effets sonores accompagnent les composants (voir « Effets sonores »). Vérifiez que public/sfx/typing.wav et public/sfx/pop.wav existent. N'ajoutez pas de sons en dehors du tableau sauf si l'utilisateur le demande.
9PrévisualisationAjoutez une entrée launch.json exécutant npx remotion studio --no-open --port <libre> dans le projet. Donnez à l'utilisateur l'URL http://localhost:<port>. L'utilisateur écoute les sons ici.
10Rendu (uniquement sur demande)RENDER_OK=1 npx remotion render <Id> out/<nom>.mp4 --gl=angle (exécutez en arrière-plan, environ 3-5 min pour 90 s).

Effets sonores

src/sfx.tsx contient tous les sons. SFX liste les sons. <Sfx src at volume frames name> joue un son at images dans la séquence en cours.

Clé dans SFXSourceInternet nécessaire
whoosh, ding, click, switch, whip@remotion/sfx (fichiers sur remotion.media)Oui, pour Studio et le rendu
poppublic/sfx/pop.wav (créé par code)Non
typingpublic/sfx/typing.wav (créé par scripts/make-typing-sound.py)Non

Les composants de la bibliothèque jouent déjà ces sons. Vous ne les ajoutez pas manuellement.

MomentFichier (dans le projet)SonVolume
Titre d'accroche / sous-pucescenes/Intro.tsx (Hook)whoosh / whip0.54 / 0.48
Carte de titre du jourscenes/Intro.tsx (DayTitle)whoosh / ding0.6 / 0.36
Puces de liste de commandesscenes/Intro.tsx (CommandList)pop par puce0.36
Balise de commande / nom de commandescenes/Commands.tsx (CommandTag)whoosh / switch0.54 / 0.48
Lignes de bloc-notesscenes/Commands.tsx (NoteCard)typing par ligne0.6
Panneau inférieur apparaîtui.tsx (Panel)pop0.48
Commande de terminal tapéeui.tsx (Terminal)typing pour chaque ligne de commande0.6
Fuite de lumièreReel.tsxwhoosh0.48
Badge Terminé / Clic de suiviscenes/Outro.tsx (DayDone, FollowCard)ding / click0.48 / 0.72
Tout <Sfx> sans volumesfx.tsx (valeur par défaut)-0.42

Le volume va de 0 (silencieux) à 1 (plein). Gardez chaque son en dessous de la voix.

Demandes courantes (recette exacte)

L'utilisateur demandeFaites exactement ceci
« Augmenter / diminuer tous les effets sonores de N% »Multipliez chaque volume={x} sur une ligne <Sfx, et la valeur par défaut dans sfx.tsx, par (1 ± N/100). Arrondissez à 2 décimales. Ne touchez pas à CutVideo.tsx (c'est la voix). Exécutez grep -rn "<Sfx" src avant et après, et montrez les valeurs modifiées.
« Changer uniquement le volume du clavier / de la frappe »Modifiez uniquement les lignes avec src={SFX.typing} (ui.tsx Terminal et scenes/Commands.tsx NoteCard).
« Changer uniquement le son X »Trouvez sa ligne dans le tableau ci-dessus. Modifiez uniquement ce volume.
« Le son du clavier est faible / créez-en un nouveau »python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <projet>/public/sfx/typing.wav. Gardez d'abord une copie de l'ancien fichier. Modifiez les nombres dans le script uniquement si l'utilisateur demande une sensation différente.
« Supprimer un son »Supprimez cette ligne <Sfx .../>.
« Où puis-je l'entendre avant le rendu ? »Studio (étape 9). Appuyez sur Lecture ou Espace. Studio se recharge automatiquement après chaque modification sauvegardée.
« Comment faire le rendu moi-même ? »Terminal : cd <projet> && npx remotion render <Id> out/<nom>.mp4 --gl=angle. Interface Studio : bouton Rendu (extrémité droite de la barre au-dessus de la timeline) → onglet Vidéo → définir le Nom de sortie → Rendre la vidéo. La progression s'affiche dans l'onglet Travaux. Le paramètre OpenGL est déjà angle.
« Faire le rendu »Étape 10, avec RENDER_OK=1. Donnez ensuite le chemin complet du fichier de sortie.
« Changer le handle »Root.tsx defaultProps.handle.

Comment fonctionne le timing

  • src/timeline.ts : CUTS (secondes brutes supprimées), out(sec) mappe une seconde brute à une image de sortie.
  • <At from={rawSec} to={rawSec} name="..."> affiche un bloc pour cette plage parlée.
  • r(t0, t) donne un délai en images à l'intérieur d'un bloc, pour « faire apparaître ceci quand le mot à t est dit ».
  • CutVideo alterne le zoom 1.0 / 1.14 par segment (punch-in sur chaque coupure). N'ajoutez pas plus de zoom.

Plan de la bibliothèque

FichierExportationsUtilisation pour
theme.tsDISPLAY (Anton), SANS (Inter), MONO, couleurs C, extrude()Tout le texte et les couleurs. Pas de nouvelles polices ou couleurs.
sfx.tsxSFX, SfxEffets sonores (voir ci-dessus)
ui.tsxPop, useIn, useOut, BELOW_NECK, Panel, TermFrame, TerminalApparition élastique, panneau moitié inférieure, terminal tapé
scenes/Intro.tsxHook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeakOuverture, transitions de sections
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCardUn sujet par section : balise en haut, visuel dans Panel
scenes/Commands.tsx (Jour 2, texte codé en dur)IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearchAjoutez des props pour le texte avant de les réutiliser
scenes/Outro.tsxDayDone({day}), NextDay({day, commands, at}), FollowCard({handle})Fin (NextDay est facultatif)
Reel.tsxReelReel complet du Jour 1. Utilisez-le comme exemple pour la structure.

Conservez les tailles, couleurs et animations lorsque vous modifiez le texte.

Skills associés