Communitygithub.com

eda-marketing : rédacteur de sous-titres

Génère des légendes vidéo (groupes de mots basés sur le sens, zones de sécurité, évitement UI), transcrit la parole réelle en un transcript corrigé et produit le fichier SRT pour l'étape des sous-titres.

Qu'est-ce que eda-marketing : rédacteur de sous-titres ?

Ce skill est conçu pour les pipelines de production vidéo, en particulier dans le cadre de l'écosystème **eda-marketing**. Il s'occupe de trois tâches distinctes : la création de **légendes incrustées** dans la vidéo (dossier `video/captions/`, propriétés `props.captions`, fichier `speech.srt`) ; la génération de **texte pour les publications** (dossier `captions/<platform>.md`, via le skill `content-repurposer`) ; et la gestion des **textes éditoriaux** (notamment les accents avec `spoken: false`, `editorialCta`). Le texte des légendes est automatiquement écrit dans la langue définie par `brand.json → language`, et le regroupement ainsi que la typographie suivent les règles du pack de langue correspondant (`packages/core/src/lang/<en|ru>.ts`). Il supporte un mode **draft** avant enregistrement (estimation du timing à partir du script) et un mode **post-enregistrement** : transcription avec **faster-whisper** en local, correction du transcript, synchronisation avec le montage, et calibrage du rythme du locuteur. Les modes de groupement incluent `replace` (groupes courts qui se remplacent), `accumulate` (ajout progressif de mots) et `highlight` (sur demande). Le skill insiste sur le respect du sens : il ne sépare jamais une négation de son verbe, une préposition de son complément, un nombre de son unité, et protège les phrases définies dans `brand.json → captions.protectedPhrases`. Des vérifications sont intégrées via `mos qa` pour la densité de texte et l'évitement du chevauchement avec les éléments visuels.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/usredanchenko/eda-marketing/tree/HEAD/plugin/skills/caption-writer

Demander à votre IA préférée

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

Documentation

caption-writer

Trois choses distinctes : légendes incrustées (video/captions/, props.captions, speech.srt) ; texte de publication (captions/<platform>.md, skill eda-marketing:content-repurposer) ; texte éditorial (accents avec spoken: false, editorialCta) — jamais dans le SRT.

Le texte des légendes est dans la langue de la marque (brand.json → language). Les règles de regroupement, de typographie et de syllabes proviennent du pack de langue (packages/core/src/lang/<en|ru>.ts).

Avant l'enregistrement (brouillon)

npm run mos -- captions build <pkg> — estimation du timing à partir du script (brand.json → speech.syllablesPerSec), badge « ESTIMATED TIMING », rendu final bloqué.

Après l'enregistrement

  1. npm run mos -- footage <pkg> (si les sources sont dans input/).
  2. npm run mos -- captions transcribe <pkg> <fichier audio> — faster-whisper local, pas de téléchargement. Pas de modèle → demander l'autorisation avant d'installer (docs/VIDEO_PIPELINE.md).
  3. La transcription ASR est un brouillon. Vérifier les noms, les nombres, les négations, les terminaisons de mots, les mots peu audibles, les limites de phrases. Les corrections vont dans transcript/corrected.<fichier>.json + une ligne dans transcript/CORRECTIONS.md ; transcript/raw-asr.* est immuable. En cas de doute → [inaudible] + demander à l'utilisateur ; ne jamais deviner. Ne jamais prétendre avoir écouté si ce n'est pas le cas.
  4. Si la parole réelle diffère du script, montrer la différence et décider avec l'utilisateur (garder la parole / rééditer / réenregistrer). Les légendes suivent la parole réelle ; n'ajoutez jamais de mots qui ne sont pas dans l'audio.
  5. npm run mos -- captions map <pkg> → npm run mos -- captions build <pkg> --source transcribed.
  6. Optionnel : npm run mos -- captions calibrate <pkg> raw-asr.<fichier>.json --write — le rythme réel du locuteur est écrit dans brand.json.

Modes et regroupement

Mode par défaut : brand.json → defaults.captionMode ; par vidéo : props.captions.mode. replace — des groupes courts se remplacent ; accumulate — les mots construisent un petit bloc progressif ; highlight — sur demande. Emphase : *mot* dans la parole du script (pour la parole transcrite, marquer emphasis dans corrected). Regrouper par sens. Ne jamais séparer une négation de son verbe (« ne / sais pas »), une préposition de son mot (« dans / l'app »), un nombre de son unité (« 30 / secondes »), ni un nom propre. Éviter un mot isolé en fin de ligne. Conserver intacts les brand.json → captions.protectedPhrases. Les règles russes sont dans le pack de langue ru.

Vérification

Studio : début/fin de chaque page, transition légende-accent sans doublon, lisibilité sur téléphone, pas de texte sur les yeux. mos qa vérifie le débordement des lignes avec les métriques réelles des polices.

Individual skills in this repo

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

Skills associés