Communitygithub.com

usredanchenko/eda-marketing

Gera legendas na tela para pacotes de vídeo usando o motor de legendas (agrupamento por significado, áreas seguras, evasão de UI), transcribe áudio gravado em uma transcrição corrigida e produz o arquivo SRT. Use na etapa de legendas, após a gravação do áudio, ou quando as legendas estiverem dessincronizadas, mal divididas ou duplicadas. O texto de post é tarefa do content-repurposer.

O que é eda-marketing?

Esta skill é especializada na criação de legendas na tela para vídeos, a partir de gravações de áudio reais (ou scripts). Ela gera arquivos SRT formatados com agrupamento inteligente por significado, evitando sobreposição com elementos da interface (UI) e áreas seguras. A skill lida com três fluxos distintos: legendas na tela (`video/captions/`, `props.captions`, `speech.srt`), texto para postagens em plataformas (delegado à skill `eda-marketing:content-repurposer`), e texto editorial com sotaques e CTAs (nunca no SRT). Após a gravação, a skill utiliza um modelo ASR local (faster-whisper) para transcrição, que deve ser corrigida manualmente pelo usuário com foco em nomes, números, negações, terminações de palavras, palavras silenciosas e limites de frases. Ela suporta modos de exibição de legendas (substituição, acumulação e destaque), respeita regras de idioma (incluindo pacotes para en/ru) e frases protegidas. O processo é validado com verificações de estúdio e QA (fontes reais, sem texto sobre olhos).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

caption-writer

Três coisas separadas: legendas na tela (video/captions/, props.captions, speech.srt); texto de post (captions/<plataforma>.md, skill eda-marketing:content-repurposer); texto editorial (accents com spoken: false, editorialCta) — nunca no SRT.

O texto da legenda está no idioma da marca (brand.json → language). As regras de agrupamento, tipografia e sílabas vêm do pacote de idioma (packages/core/src/lang/<en|ru>.ts).

Antes da gravação (rascunho)

npm run mos -- captions build <pkg> — temporização estimada a partir do script (brand.json → speech.syllablesPerSec), selo "TEMPO ESTIMADO", render final bloqueado.

Após a gravação

  1. npm run mos -- footage <pkg> (se as fontes estiverem em input/).
  2. npm run mos -- captions transcribe <pkg> <arquivo de voz> — faster-whisper local, sem downloads. Sem modelo → pedir permissão antes de instalar (docs/VIDEO_PIPELINE.md).
  3. O ASR é um rascunho. Verificar nomes, números, negações, terminações de palavras, palavras silenciosas, limites de frases. Correções vão para transcript/corrected.<arquivo>.json + uma linha em transcript/CORRECTIONS.md; transcript/raw-asr.* é imutável. Não claro → [inaudivel] + perguntar ao usuário; nunca chutar. Nunca afirmar que ouviu se não ouviu.
  4. Se a fala real diferir do script, mostrar a diferença e decidir com o usuário (manter a fala / reeditar / regravar). As legendas seguem a fala real; nunca adicionar palavras que não estão no áudio.
  5. npm run mos -- captions map <pkg> → npm run mos -- captions build <pkg> --source transcribed.
  6. Opcional: npm run mos -- captions calibrate <pkg> raw-asr.<arquivo>.json --write — o ritmo real do autor em brand.json.

Modos e agrupamento

Modo padrão: brand.json → defaults.captionMode; por vídeo: props.captions.mode. replace — grupos curtos substituem uns aos outros; accumulate — palavras constroem um bloco escalonado pequeno; highlight — sob consulta. Ênfase: *palavra* no script (para fala transcrita, marcar emphasis em corrected). Agrupar por significado. Nunca separar uma negação de seu verbo ("não / sei"), uma preposição de sua palavra ("no / app"), um número de sua unidade ("30 / segundos"), ou um nome. Evitar uma palavra solta em uma linha. Manter brand.json → captions.protectedPhrases intacto. As regras do russo estão no pacote de idioma ru.

Verificação

Estúdio: início/fim de cada página, transição legenda-acento sem duplicatas, legibilidade em celular, sem texto sobre os olhos. mos qa verifica estouro de linha com métricas reais de fonte.

Individual skills in this repo

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

Habilidades Relacionadas