Que fait srt2reel ?
Transforme un fichier audio et son SRT en une vidéo story à 30 fps : scènes animées avec personnages vectoriels simples, cartes de légendes affichant les mots exacts du SRT, une étiquette nommant chaque scène et des effets sonores discrets. Deux formats : portrait (1080×1920, pour les contenus courts) et paysage (1920×1080, pour les vidéos plus longues).
Ce skill construit des vidéos. Il n'écrit jamais l'histoire. Si l'utilisateur donne seulement un sujet ou une idée, dites-lui qu'il faut le fichier audio et son SRT, et demandez-lui les deux.
Parlez à l'utilisateur dans la langue dans laquelle il vous écrit, en phrases courtes et simples. Il n'est peut-être pas technique.
Où se trouvent les choses
Le dossier du skill est ${CLAUDE_SKILL_DIR}. Si cela apparaît comme un espace réservé littéral, c'est le dossier qui contient ce SKILL.md. Il est appelé SKILL ci-dessous.
SKILL/scripts/contient cinq commandes. Exécutez-les telles qu'elles sont écrites ; ne les réécrivez pas.SKILL/template/est le projet vidéo queinit.tscopie.SKILL/references/contient des détails à lire lorsqu'une étape les mentionne.SKILL/assets/kit.jpgmontre chaque élément de scène prêt à l'emploi (kit-wide.jpgpour le format paysage).
Chaque vidéo a son propre dossier de projet, appelé PROJECT ci-dessous. Utilisez ~/reels/<nom-court>.
Entrées
- Le fichier audio (MP3, WAV ou M4A).
- Le fichier SRT avec les mots exacts prononcés. S'il manque, demandez-le. Ne transcrivez pas l'audio vous-même : la reconnaissance vocale se trompe sur les mots, et le SRT est la source de vérité.
- Optionnel : un nom de page ou de chaîne (affiché comme un petit filigrane), un thème de couleurs (
paper,mint,sky), des idées de personnages ou de scènes, des images personnelles à utiliser.
Choisissez le format en fonction de ce que demande l'utilisateur. Un contenu court pour Reels, Shorts ou TikTok est portrait. Une vidéo pour une chaîne YouTube, une leçon ou tout ce qui dépasse trois minutes est paysage. Si ce n'est pas clair, demandez.
Étapes
Travaillez dans cet ordre. Chaque commande affiche ce qu'elle a fait et quoi faire ensuite.
1. Vérifier la machine
node SKILL/scripts/doctor.ts
Si elle affiche FAIL, dites clairement à l'utilisateur ce qui manque et arrêtez-vous. N'essayez pas de contourner un ffmpeg ou Node manquant. Une ligne warn est acceptable.
2. Créer le projet
node SKILL/scripts/init.ts PROJECT --voice <fichier audio> --srt <fichier srt> [--format landscape] [--lang <code>] [--page "<nom>"] [--theme <nom>]
Ceci copie le modèle, l'installe, mesure la voix, trouve les vraies pauses et écrit PROJECT/src/story.json avec une légende par signal SRT, déjà synchronisée avec la voix et ajustée pour tenir. Il installe également les bonnes polices pour la langue.
Lisez toute sa sortie. Elle liste chaque légende avec son heure et chaque pause assez longue pour couper une scène. Si elle avertit que le SRT et la voix ne correspondent pas en longueur, demandez à l'utilisateur avant de continuer.
La langue est devinée à partir du script du SRT. Passez --lang lorsque la devinette pourrait être erronée : une langue en caractères latins autre que l'anglais (es, fr, id, vi), le chinois traditionnel (zh-TW), l'ourdou ou le persan (ur, fa), le marathi ou le népalais (mr, ne). Voir references/languages.md.
3. Planifier les scènes
Lisez les légendes comme une seule histoire et découpez-la en scènes. Commencez une nouvelle scène lorsque le lieu, le temps, le locuteur ou l'idée change, environ toutes les 4 à 7 secondes. Une histoire de 25 secondes a 5 à 7 scènes ; une de 60 secondes en a 9 à 14. Une scène par légende est trop. Placez chaque coupe sur l'une des pauses listées, pas à l'intérieur d'une phrase.
Pour chaque scène, décidez : où elle se déroule, qui y est, ce qu'ils font, et un visuel qui montre ce que dit la légende (un accessoire, un nombre, un indicateur, un tampon) pour que ce ne soit pas seulement une personne qui parle. Utilisez une scène sombre pour le point bas de l'histoire. Terminez sur la dernière leçon ou le résultat de l'histoire.
Une vidéo de plus d'environ deux minutes a trop de scènes pour les écrire une par une. Suivez references/long-videos.md pour celles-ci.
4. Écrire les deux fichiers d'histoire
Seuls ces deux fichiers changent d'une vidéo à l'autre. Laissez tout ce qui se trouve sous src/lib/ tranquille.
PROJECT/src/story.json: liste des scènes avec heures et étiquettes, mots-clés dans les légendes, qui parle quand, effets sonores. Format et règles : references/story.md.PROJECT/src/scenes.tsx: un petit composant par scène, et l'objetSCENESqui les nomme. Comment dessiner les scènes, le kit complet et les zones de mise en page : references/scenes.md. Regardez d'abordSKILL/assets/kit.jpg, puis copiez depuisPROJECT/src/lib/examples.tsx(examples-wide.tsxpour le format paysage).
Le texte des légendes est fixe. Vous pouvez ajouter des {accolades} autour des mots-clés, modifier les sauts de ligne, fusionner deux légendes ou en diviser une, et déplacer les heures. Vous ne pouvez pas ajouter, supprimer ou modifier un mot. La vérification à l'étape 5 rejette toute différence.
Le texte à l'écran que vous ajoutez vous-même (étiquettes, étiquettes, bulles de dialogue) doit être dans la langue du SRT. Limitez-vous à un ou deux mots qui nomment ce que la narration dit déjà : un lieu, un panneau de boutique, une réaction. N'ajoutez pas de nouveaux faits ou phrases.
5. Vérifier, et répéter jusqu'à ce que ce soit propre
node SKILL/scripts/check.ts PROJECT
Il compare le texte des légendes avec le SRT, vérifie les heures, les scènes, les surlignages et les polices, et compile le code des scènes. Corrigez chaque ERROR et relancez. Lisez chaque warn et corrigez ceux qui sont de vrais problèmes.
6. Regarder les images clés, et répéter jusqu'à ce que ce soit correct
node SKILL/scripts/stills.ts PROJECT
Ceci rend une image peu après chaque coupe et une au milieu de chaque légende, et les assemble en planches contact. Ouvrez chaque planche qu'elle liste et regardez-la. Chaque cellule est étiquetée avec son heure, sa scène et son numéro de légende.
Cherchez et corrigez :
- tout ce qui recouvre ou touche l'étiquette en haut ou la carte de légende en bas
- un texte qui dépasse de sa carte, ou des lettres dessinées comme des boîtes vides
- une scène qui ne montre pas ce que dit sa légende
- un personnage dont l'apparence change entre les scènes
- une scène vide ou presque vide
Ajoutez --grid pour dessiner la boîte de contenu et une règle sur chaque image ; utilisez-le pour voir ce qui traverse une zone et où le déplacer. Pour revoir quelques moments après une correction : node SKILL/scripts/stills.ts PROJECT --at 12.5,30. Chaque exécution remplace les planches de l'exécution précédente.
Ne rendez jamais la vidéo complète sans avoir regardé les planches.
7. Rendu
Un rendu prend à peu près la durée de la vidéo sur une machine rapide et plusieurs fois plus sur une petite, alors lancez-le en arrière-plan et interrogez :
node SKILL/scripts/render.ts PROJECT --detach
node SKILL/scripts/render.ts PROJECT --status
--status affiche rendering, puis finishing, puis done ou failed. Vérifiez toutes les 20 à 30 secondes et ne terminez pas votre tour avant qu'il n'atteigne done ou failed. Si vous ne pouvez pas faire de pause entre les vérifications, laissez la commande vous attendre : node SKILL/scripts/render.ts PROJECT --status --wait 100 revient dès que le rendu se termine, ou après 100 secondes ; relancez jusqu'à ce que ce soit le cas.
Si les fichiers que vous remettez à l'utilisateur ont une limite de taille (les chats claude.ai autorisent 30 Mo), ajoutez --max-mb 28.
Le rendu égalise le volume sonore, puis vérifie le fichier final : taille d'image, fréquence d'images, codecs, durée. --status affiche le résultat et le chemin de final_check.jpg, quatre images extraites du fichier final aux heures qu'il liste. Regardez cette image.
8. Livrer
Donnez à l'utilisateur PROJECT/out/final.mp4. Ajoutez une ligne indiquant ce qui n'est pas parfait, et une étape suivante suggérée. Si tout est parfait, dites-le en une ligne.
Règles pour ce qui va dans une vidéo
- Montrez uniquement ce que dit le SRT. N'ajoutez pas d'affirmations, de faits ou de promesses de votre propre chef.
- Pas de politique, de haine, ou de diffamation de personnes réelles. Pas de conseils médicaux ou financiers présentés comme des faits. Traitez les sujets sensibles avec délicatesse.
- Ne copiez pas les personnages, scènes ou designs d'un autre créateur. Dessinez votre propre histoire.
- Ne promettez jamais de vues, de portée ou de revenus à l'utilisateur.
- Rien ne doit clignoter plus de trois fois par seconde.
Choses que l'utilisateur devrait savoir
Dites-les une fois, quand elles sont pertinentes, dans la langue de l'utilisateur :
- La vidéo est construite avec Remotion, qui est gratuit pour les particuliers et les entreprises de jusqu'à trois personnes. Les grandes entreprises ont besoin d'une licence Remotion : https://www.remotion.dev/docs/license
- Les plateformes agissent contre les chaînes qui publient de nombreuses vidéos modèles quasi identiques, et peuvent exiger un label sur une voix synthétique clonée ou réaliste. Voir references/platforms.md.
Quand quelque chose ne va pas
Voir references/troubleshooting.md. Si la machine ne peut pas du tout rendre la vidéo (aucun navigateur ne peut démarrer, pas de ffmpeg, pas de réseau pour la première installation), dites-le clairement et arrêtez-vous au lieu de produire autre chose.