subtitle-fix
Corrige et convertit des fichiers de sous-titres (.srt, .vtt, .ass, .ssa) — resynchronise le timing (décalage global, étirement/compression de framerate), nettoie les artefacts OCR, réencode en UTF-8,
SKILL.mdskills/subtitle-fix/SKILL.md
GitHubsubtitle-fix — Réparation, resynchronisation & conversion de sous-titres
Promu depuis un brouillon généré par
doc-to-skill(validé 2026-06-24). Couvre les pannes courantes de sous-titres — timing, encodage, format — sans toucher au sens (la traduction est déléguée).
Quand l'utiliser / quand déléguer
- Ici : timing décalé/dérivant, mauvais encodage, mauvais format, artefacts OCR, fusion/découpe de pistes.
- Déléguer : traduire le texte → skill de langue/traduction (ex.
polyglotte) ; extraire/muxer une piste depuis une vidéo → outil média dédié.
Diagnostic du timing (clé)
- Décalage constant (offset) : tout est en avance/retard de N secondes → appliquer
+/- N s. - Dérive (drift) : l'écart grandit avec le temps → conversion de framerate (23.976 ↔ 25 ↔ 29.97) ou ré-échelonnage par deux points d'ancrage (timecode début connu + timecode fin connu → facteur + offset).
- Mixte : corriger d'abord le facteur (drift), puis l'offset résiduel.
Workflow
- Détecter format (srt/vtt/ass/ssa) et encodage ; réencoder en UTF-8 si besoin (signaler si ambigu).
- Diagnostiquer le type de problème de timing (offset vs drift, cf. ci-dessus).
- Corriger : offset et/ou facteur d'étirement ; nettoyer balises parasites et artefacts OCR (l→I, 0→O…).
- Convertir vers le format cible en préservant la mise en forme compatible (styles ass→vtt simplifiés).
- Vérifier : montrer 3-5 timecodes d'échantillon avant/après + un résumé du diff.
Garde-fous
- Sauvegarde de l'original avant toute écriture ; jamais d'écrasement sans confirmation.
- Ne traduit pas le contenu ; en cas d'encodage source ambigu, proposer les hypothèses plutôt que deviner.
- Préserver l'ordre et la numérotation des cues ; ne pas perdre de lignes lors d'une conversion.
- Outillage local (ffmpeg/sous-titres ou parsing maison) — pas de service en ligne requis.