subtitle-fix — Réparation, resynchronisation & conversion de sous-titres

SkillFiles & storage

Fixes and converts subtitle files (.srt, .vtt, .ass, .ssa), resyncs timing (global offset, framerate stretch/compress), cleans OCR artifacts, re-encodes to UTF-8, merges or splits tracks, and converts between formats. Use when the user wants to "fi

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the subtitle-fix skill

What this skill tells your AI

The instructions your AI receives, as published by geekfamilycorp/tricorderkit in skills/subtitle-fix/SKILL.md and read by ahel’s review.

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

  1. Détecter format (srt/vtt/ass/ssa) et encodage ; réencoder en UTF-8 si besoin (signaler si ambigu).
  2. Diagnostiquer le type de problème de timing (offset vs drift, cf. ci-dessus).
  3. Corriger : offset et/ou facteur d'étirement ; nettoyer balises parasites et artefacts OCR (l→I, 0→O…).
  4. Convertir vers le format cible en préservant la mise en forme compatible (styles ass→vtt simplifiés).
  5. 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.

Signals

GitHub stars
30
Forks
1
Last commit
Aug 2026
Advanced
Item type
skill
Key
subtitle-fix
Source
github.com/geekfamilycorp/tricorderkit