O que Visualizador de Vídeos faz?
Prepare artefatos de vídeo que o GitHub Copilot possa inspecionar: legendas, folhas de contato de quadros, um índice de quadros, um manifesto e um pacote de prompt.
Este skill é inspirado em bradautomates/claude-video, mas tem como alvo workflows do GitHub Copilot. Não assuma paralelismo de Read do Claude Code. Gere os arquivos primeiro, depois inspecione apenas os artefatos necessários para a pergunta do usuário.
Quando Usar
- O usuário pede para assistir, inspecionar, resumir, comparar ou diagnosticar um vídeo.
- A entrada é uma URL de vídeo suportada por
yt-dlp, ou um arquivo local.mp4,.mov,.mkvou.webm. - A tarefa depende tanto do que é dito quanto do que aparece na tela, como reproduções de bugs, demonstrações de produtos, vídeos de lançamento, tutoriais, webinars, anúncios ou gravações de tela.
Não é o Melhor Uso
- Não burle DRM, paywalls, autenticação ou termos do site.
- Não solicite ou armazene cookies, tokens de portador, URLs assinados ou credenciais privadas de mídia.
- Se uma API oficial ou transcrição existente responder à tarefa sem processamento de vídeo, prefira esse caminho mais leve.
Fluxo de Trabalho Principal
- Execute preflight se as dependências forem incertas:
python .github/skills/video-watch/scripts/preflight.pyUsepython .github/skills/video-watch/scripts/preflight.py --url-modepara entradas de URL. - Produza artefatos:
python .github/skills/video-watch/scripts/video_watch.py <url-ou-caminho> --question "<o que responder>"Use--transcript-file <caminho>quando outra ferramenta, Azure Speech ou Speech Translator Desktop Plus já tiver produzido uma transcrição. Para mídia privada ou autenticada, prefira--detail transcript --metadata-only --transcript-file <caminho>e não passe cookies, tokens de portador ou credenciais de URL assinada. - Leia os artefatos nesta ordem:
manifest.json→prompt.md→transcript.md→frame-index.md→contact-sheet.jpg→ arquivos selecionados emframes/apenas se necessário.manifest.jsonregistra SHA-256 para bytes de origem local, ou para bytes de vídeo de URL baixada quando um download ocorreu. Execuções de URL apenas com metadados deixam o hash nulo em vez de buscar a mídia. - Responda a partir dos artefatos. Indique quando a resposta é apenas transcrição, apenas quadros, ou limitada por amostragem esparsa.
- Para momentos nomeados, execute novamente com
--start/--endpara focar o orçamento de quadros.
Modos de Detalhe
| Modo | Uso |
|---|---|
transcript | Apenas legendas ou transcrição auxiliar. Mais rápido. |
efficient | Pequena passagem visual para triagem rápida. |
balanced | Folha de contato padrão para a maioria das gravações de tela e demonstrações. |
token-burner | Maior passagem visual quando o usuário precisa explicitamente de ampla cobertura visual. |
Pontos de Verificação Rubber Duck
- Antes de alterar o fluxo de trabalho deste skill, revise o plano quanto a escolha primitiva, dependências ocultas, limites de segurança e ordem de artefatos do Copilot.
- Após editar, revise
SKILL.md, scripts e referências para comportamento autocontido, qualidade de gatilho, contagem de linhas e validação executável. - Trate o crítico como somente leitura. O produtor aplica as mudanças e executa novamente a validação.
Referências
| Necessidade | Referência |
|---|---|
| Fluxo de trabalho detalhado | references/workflow.md |
| Dependências e configuração | references/dependencies.md |
| Orçamento de quadros e folhas de contato | references/frame-budget.md |
| Backends opcionais Scout/Whisper/Azure Speech | references/backends.md |