Communitygithub.com

Transcrever Vídeo

Transcreve localmente qualquer arquivo de vídeo ou áudio para texto com timestamps no nível da palavra, usando um serviço whisper.cpp empacotado em Docker. Retorna transcript.txt, transcript.srt e transcript.words.json.

O que é Transcrever Vídeo?

Este skill permite transcrever localmente qualquer arquivo de vídeo ou áudio para texto com timestamps precisos no nível da palavra, usando o whisper.cpp — sem chamadas a APIs externas ou projetos em nuvem. Ele é especialmente útil para gerar legendas sincronizadas, overlays ou transcrições completas. O skill funciona em três plataformas principais: Claude Code, Cursor e Codex, e é acionado por comandos como "transcreva este vídeo", "obter transcrição" ou "transcrever-vídeo". Internamente, ele gerencia todo o ciclo de vida do Docker: verifica se o Docker e o ffmpeg estão disponíveis, constrói a imagem personalizada do Whisper (compilando whisper.cpp e incluindo o modelo ggml-base.en.bin), inicia o contêiner, extrai o áudio em WAV mono 16 kHz e envia para o serviço de transcrição. Os resultados são salvos como transcript.txt, transcript.srt e transcript.words.json (com timestamps no nível da palavra), e uma linha JSON de saída é gerada para integração programática com outros skills, como /produce-video.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/transcribe-video

Perguntar na sua IA favorita

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

Documentação

O que Transcrever Vídeo faz?

Transcreve localmente qualquer arquivo de vídeo/áudio usando um serviço whisper.cpp empacotado. Sem projeto externo ou API em nuvem. Retorna timestamps no nível da palavra (necessários para overlays/legendas sincronizadas).

Quando usar

  • "Transcreva este clipe / vídeo / áudio", "obtenha uma transcrição com timestamps".
  • Como sub-etapa de /produce-video.

Como executa

Tudo é gerenciado pelo executor empacotado — nunca peça ao usuário para gerenciar o Docker:

node scripts/transcribe.mjs <caminho-para-video-ou-audio> [--out <dir>] [--port 9111] [--language en] [--no-word-ts] [--task transcribe|translate]
node scripts/transcribe.mjs --stop      # para o contêiner quente

O executor:

  1. Verifica se o daemon do Docker está acessível (falha com orientação se não estiver).
  2. Constrói a imagem transcribe-video-whisper a partir de assets/whisper-service/ se ela estiver faltando (a primeira construção é lenta: compila whisper.cpp e empacota o modelo ggml-base.en.bin).
  3. Inicia o contêiner transcribe-video-whisper (porta do host 9111 → contêiner 9001); reutiliza se já estiver em execução, executa docker start se estiver parado.
  4. Aguarda GET /healthz responder ok.
  5. Extrai um WAV mono de 16 kHz da entrada com ffmpeg local (whisper.cpp só decodifica WAV) e então o envia para /transcribe com word_ts=true.
  6. Escreve transcript.txt, transcript.srt, transcript.words.json em --out (padrão: o diretório do arquivo de entrada) e imprime uma linha JSON de resultado no stdout.

Saídas

  • transcript.txt — texto simples.
  • transcript.srt — texto de legenda.
  • transcript.words.json — [{ "word", "start", "end" }], em segundos, ordenados por tempo. Esta é a fonte de sincronização para overlays/legendas.

Linha de resultado no stdout (para chamadas programáticas como /produce-video):

{ "ok": true, "outDir": "...", "wordCount": 38, "segmentCount": 2, "files": { "txt": "transcript.txt", "srt": "transcript.srt", "words": "transcript.words.json" } }

Requisitos

  • Docker é OBRIGATÓRIO — o serviço Whisper executa em um contêiner, portanto o Docker Desktop deve estar instalado E em execução. O executor verifica isso primeiro e falha com orientações de instalação/inicialização se o Docker estiver ausente ou seu daemon estiver parado; não há fallback sem Docker.
  • ffmpeg é OBRIGATÓRIO (usado para extrair um WAV mono de 16 kHz para o Whisper) — o executor verifica sua presença antecipadamente e falha se não estiver no PATH.
  • Node ≥ 22.

Notas

  • O contêiner permanece em execução (--restart unless-stopped) para reuso quente; pare com --stop.
  • Se timestamps de palavra forem solicitados mas nenhum for retornado, o executor falha (a sincronização de overlay depende deles).
  • Consulte references/ para o ciclo de vida do Docker, a forma da API e a proveniência do fornecimento.

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Habilidades Relacionadas