Communitygithub.com

Sous-titres à partir d'un transcript

Produire une piste de sous-titres précise et correctement chronométrée (SRT ou WebVTT) à partir d'une vidéo

Qu'est-ce que Sous-titres à partir d'un transcript ?

Cette compétence permet de générer des fichiers de sous-titres propres et précis (SRT ou WebVTT) à partir d'une vidéo, en mettant l'accent sur l'accessibilité et la clarté pour les didacticiels. Elle propose deux approches : utiliser un script de narration existant comme référence fiable, ou transcrire l'audio avec un ASR (comme Whisper) puis corriger les erreurs sur les termes techniques, les noms de produits et le code. Les règles de chronométrage assurent que chaque réplique s'affiche au moment où elle est prononcée, avec une durée minimale d'une seconde et maximale de sept secondes, et une vitesse de lecture limitée à environ 17 caractères par seconde. Les formats supportés sont SRT (universel) et WebVTT (pour le web), avec des instructions strictes sur la ponctuation des timestamps et la structure des fichiers. La compétence interdit le stylage, l'incrustation ou l'animation des sous-titres, ces tâches étant déléguées à d'autres outils comme social-video-formatter.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/tutorial-video-studio/tree/main/skills/captions-from-transcript

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 Sous-titres à partir d'un transcript ?

Les sous-titres ne sont pas une option cosmétique – ils sont essentiels pour l'accessibilité, ils retiennent les spectateurs qui regardent sans le son, et dans les didacticiels ils renforcent les termes exacts de l'interface. Cette compétence produit un fichier de sous-titres propre et correctement chronométré. Le stylage et l'incrustation sont traités ultérieurement.

Obtenir d'abord le texte le plus précis

La précision dépend du point de départ :

  • Si un script de narration existe, utilisez-le comme référence. Il est déjà correct sur les termes techniques et les libellés de l'interface. Alignez-le sur l'audio plutôt que de retranscrire à partir de zéro.
  • Sinon, transcrivez l'audio (Whisper, sous-titrage automatique d'une plateforme ou tout ASR), puis corrigez-le en regardant la vidéo. L'ASR déforme systématiquement les noms de produits, le code et les acronymes – corrigez chacun pour qu'il corresponde exactement à ce qui est affiché à l'écran.

Ne livrez jamais le résultat brut de l'ASR. Les erreurs portent toujours sur les mots les plus importants.

Chronométrer les répliques sur la parole

  • Chaque réplique apparaît quand sa ligne est prononcée et disparaît quand elle se termine – alignez sur la parole, pas sur des intervalles arbitraires.
  • Minimum ~1 seconde à l'écran (même pour une réplique courte), maximum ~7 secondes. Coupez tout ce qui dépasse.
  • Pas de blanc au milieu d'une phrase ; de petits écarts entre les phrases sont acceptables et améliorent la lisibilité.

Règles de lignes et de lecture

  • 1 à 2 lignes par réplique, jamais 3.
  • ~32-42 caractères par ligne. Au-delà, cela encombre l'image et dépasse les zones de sécurité.
  • Vitesse de lecture ≤ ~17 caractères/seconde (≈160-180 mots par minute). Si une réplique dépasse cette limite, les mots défilent trop vite – coupez la réplique ou prolongez sa durée.
  • Coupez les lignes aux frontières des propositions, jamais en milieu d'expression. Gardez "vers la page Paramètres" ensemble ; ne laissez pas "vers" tout seul sur une ligne.

Choisir le format

  • SRT – universel, index + HH:MM:SS,mmm --> HH:MM:SS,mmm + texte. À utiliser pour le téléchargement sur la plupart des plateformes et éditeurs.
  • WebVTT (.vtt) – en-tête WEBVTT, timestamps HH:MM:SS.mmm, prise en charge du positionnement et du stylage des répliques. À utiliser pour la balise <track> HTML5 et le lecteur web.

Produisez une sortie valide et analysable – ponctuation correcte des timestamps (SRT utilise une virgule avant les millisecondes, VTT un point), ligne vide entre les répliques, pas d'espace en fin de ligne.

Propre ou littéral

Pour les didacticiels, sous-titrez propre : supprimez les mots de remplissage ("euh", "hum", les faux départs), gardez le sens exact. Conservez intacts les termes techniques, le code et les libellés de l'interface. Ne passez en mode strictement littéral que si l'utilisateur le demande explicitement (contexte juridique, recherche, citations exactes).

QA de la synchronisation

Vérifiez ponctuellement par rapport à la vidéo réelle au début, au milieu et à la fin – le décalage s'accumule. Confirmez que les répliques apparaissent sur leurs lignes et disparaissent avant le début de la suivante. Corrigez tout sous-titre qui persiste sur une image inappropriée.

Transmission

Le fichier .srt / .vtt terminé alimente social-video-formatter pour l'incrustation et le stylage de la plateforme, ou directement l'élément <track> du lecteur web. Laissez la couleur, la police, la position et l'animation à ces étapes – cette compétence produit un texte précis et bien chronométré, et rien de plus.

Ne pas

  • Ne stylisez, colorez, positionnez ou n'incrustez pas les sous-titres dans l'image – c'est le rôle de social-video-formatter.
  • N'animez pas les mots un par un – c'est le rôle de kinetic-typography.
  • Ne livrez pas de sortie ASR non corrigée ; les erreurs se concentrent exactement sur les termes importants.
  • Ne mettez pas 3 lignes ou ne dépassez pas la limite de vitesse de lecture pour éviter de couper une réplique – coupez-la.

Individual skills in this repo

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

Kinetic Typography

Put text in motion the right way - title cards, animated captions, lower-thirds, callouts, and word-by-word reveals - with a reading-time-per-word budget so copy holds long enough to read, plus enter/exit timing, weight and size transitions, and type hierarchy in motion. Use when someone asks to

Motion Design Principles

The craft layer for motion: pick the right easing (ease-in / ease-out / ease-in-out / spring), get timing and spacing right, build the anticipation→action→follow-through arc, and apply Disney

Narration Script

Write the spoken voiceover for a tutorial or demo - the actual words, phrased for the ear and synced one-instruction-per-action to what is on screen, with a pacing budget and a confident, jargon-checked tone. Use when someone says

Product Demo Director

Direct the craft of putting a real software UI on screen - cursor choreography, zoom/pan/callout language, screen-recording vs recreated-UI, and making state changes legible with highlights, focus pulls, and slow-downs. Use when filming or recreating an app for a product demo, feature walkthrough, onboarding clip, or release reel and asking

Remotion Compose

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says

Remotion Render

Renders a Remotion composition to MP4 and runs the edit-and-re-render loop - CLI render commands, 1080p/4K/9:16 presets, concurrency tuning, codec selection, batch variants from a JSON data file, and Lambda for cloud rendering. Use when someone says

Remotion Setup

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just

Screencast Capture

Capture clean raw screen and camera footage for a tutorial or product demo - choosing the recorder (macOS Screenshot toolbar, QuickTime, OBS, Windows Game Bar), setting resolution / frame-rate / cursor / microphone, prepping a distraction-free stage, and recording in retakeable segments. Use when someone says

SkillMedev/tutorial-video-studio

Plan a product demo, feature announcement, or launch video as a beat sheet and shot list BEFORE animating - hook in the first 3s, problem, reveal, proof, CTA - with target duration and pacing per scene type, output as a JSON scene plan that remotion-compose consumes directly. Use when someone says

Social Video Formatter

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says

Sound and Music Sync

Score a video like an editor: beat-match cuts to the music, land SFX on transitions, pace the voiceover so it breathes, source royalty-free tracks safely, and duck the music so the VO sits clearly on top. Use when adding music, sound effects, or voiceover to a video, when asked to

Skills associés