Communitygithub.com

Legendas a Partir de Transcrição

Produz uma faixa de legenda precisa e com temporização correta (SRT ou WebVTT) a partir de um vídeo.

O que é Legendas a Partir de Transcrição?

Esta skill automatiza a criação de legendas de alta qualidade para vídeos, com foco em acessibilidade e clareza para tutoriais ou qualquer conteúdo onde termos técnicos e nomes de interface são cruciais. Ela orienta o usuário a obter o texto mais preciso possível, seja usando um roteiro existente como base ou corrigindo a saída de um sistema de reconhecimento de fala (ASR), que tende a errar justamente nos termos mais importantes. A skill estabelece regras rigorosas de temporização (alinhamento com a fala, duração mínima e máxima por legenda), formatação (1-2 linhas, comprimento e velocidade de leitura adequados) e quebra de linhas (em limites de oração), garantindo legibilidade. Por fim, ela gera arquivos SRT ou WebVTT válidos, prontos para uso em players web ou para serem passados para ferramentas de queima de legendas (como social-video-formatter), sem adicionar estilos ou animações. O diferencial é a ênfase em legendas "limpas" (com correções de muletas e falsos inícios), mas fiéis ao significado, e a verificação de sincronia em pontos críticos do vídeo.

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

Perguntar na sua IA favorita

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

Documentação

O que Legendas a Partir de Transcrição faz?

Legendas não são um polimento opcional - são acessibilidade, mantêm espectadores assistindo sem áudio e, em tutoriais, reforçam termos exatos de interface. Esta skill produz um arquivo de legenda limpo e com temporização precisa. Estilização e queima (burn-in) são feitas posteriormente.

Obtenha o texto mais preciso primeiro

A precisão vem de onde você começa:

  • Se existir um roteiro de narração, use-o como verdade absoluta. Ele já está correto em termos técnicos e rótulos de interface. Alinhe-o ao áudio em vez de transcrever do zero.
  • Caso contrário, transcreva o áudio (Whisper, legenda automática da plataforma, ou qualquer ASR) e, em seguida, corrija-o em relação ao vídeo. O ASR invariavelmente deturpa nomes de produtos, código e acrônimos - corrija cada um para corresponder exatamente ao que está na tela.

Nunca entregue a saída bruta do ASR. Os erros estão sempre nas palavras de maior valor.

Temporalize as falas à fala

  • Cada legenda aparece quando sua linha é falada e desaparece quando termina - alinhe à fala, não a intervalos arbitrários.
  • Mínimo de ~1 segundo na tela (mesmo para uma legenda curta), máximo de ~7 segundos. Divida qualquer coisa maior.
  • Sem lacunas no meio de uma frase; pequenas lacunas entre frases são aceitáveis e ajudam na legibilidade.

Regras de linha e leitura

  • 1-2 linhas por legenda, nunca 3.
  • ~32-42 caracteres por linha. Acima disso, sobrecarrega o quadro e ultrapassa as áreas seguras.
  • Velocidade de leitura ≤ ~17 caracteres/segundo (≈160-180 ppm). Se uma legenda exceder esse limite, as palavras passam rápidas demais - divida a legenda ou aumente sua duração.
  • Quebre linhas em limites de oração, nunca no meio de uma frase. Mantenha "para a página Configurações" junto; não deixe "para" sozinho em uma linha.

Escolha o formato

  • SRT - universal, índice + HH:MM:SS,mmm --> HH:MM:SS,mmm + texto. Use para upload na maioria das plataformas e editores.
  • WebVTT (.vtt) - cabeçalho WEBVTT, timestamps HH:MM:SS.mmm, suporta posicionamento/estilização de legendas. Use para a tag <track> do HTML5 e para o player web.

Produza saída válida e analisável - pontuação correta dos timestamps (SRT usa vírgula antes dos milissegundos, VTT usa ponto), linha em branco entre legendas, sem espaços em branco à direita.

Limpa vs. verbatim

Para tutoriais, legende de forma limpa: remova muletas ("hum", "ahã", falsos inícios), mantenha o significado fiel. Preserve exatamente termos técnicos, código e rótulos de interface. Use estritamente verbatim apenas se o usuário precisar explicitamente (contextos legais, pesquisa, citações exatas).

Verifique a sincronia

Faça verificações pontuais contra o vídeo real no início, em um ponto intermediário e no final – o descompasso se acumula. Confirme que as legendas aparecem em suas linhas e desaparecem antes do início da próxima. Corrija qualquer legenda que persista no quadro errado.

Entregue

O arquivo .srt / .vtt finalizado alimenta o social-video-formatter para queima (burn-in) e estilização da plataforma, ou o elemento <track> do player web diretamente. Cor, fonte, posição e animação ficam para essas etapas – esta skill produz texto preciso e bem temporalizado, e nada mais.

Não faça

  • Não estilize, colore, posicione ou queime legendas no quadro – isso é função do social-video-formatter.
  • Não anime palavras palavra por palavra – isso é função do kinetic-typography.
  • Não entregue ASR não corrigido; os erros se concentram exatamente nos termos que importam.
  • Não coloque 3 linhas ou estoure o orçamento de velocidade de leitura para evitar dividir uma legenda – divida-a.

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

Habilidades Relacionadas