Communitygithub.com

Visualizador de Vídeos

Prepare URLs de vídeos ou arquivos de vídeo locais para análise pelo GitHub Copilot, extraindo legendas, quadros amostrados, folhas de contato e um pacote de prompt. Use quando o usuário pedir ao Copilot para assistir, inspecionar, resumir ou diagnosticar um vídeo, gravação de tela, demonstração, webinar, URL do YouTube/Loom/TikTok/X/Vimeo ou arquivo .mp4/.mov/.mkv/.webm.

O que é Visualizador de Vídeos?

Este skill, chamado 'Visualizador de Vídeos', permite que o GitHub Copilot analise vídeos extraindo artefatos como legendas, folhas de contato de quadros, índices de quadros, manifestos e pacotes de prompt. Ele é ideal para desenvolvedores que desejam que o Copilot entenda o conteúdo visual e auditivo de vídeos, como reproduções de bugs, demos de produtos, tutoriais ou gravações de tela. O skill suporta tanto URLs de vídeos (YouTube, Loom, TikTok, X, Vimeo) quanto arquivos locais (.mp4, .mov, .mkv, .webm). Ele funciona executando scripts Python que geram artefatos de forma sequencial, que o Copilot pode então inspecionar. O fluxo de trabalho evita violar DRM ou requisitar credenciais, e oferece modos de detalhe (transcrição, eficiente, balanceado, consumidor de tokens) para equilibrar custo e cobertura visual. Ele também inclui verificações de validação e referências para workflow, dependências e orçamento de quadros.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktsmm/Agent-Skills/tree/HEAD/video-watch

Perguntar na sua IA favorita

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

Documentação

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, .mkv ou .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

  1. Execute preflight se as dependências forem incertas: python .github/skills/video-watch/scripts/preflight.py Use python .github/skills/video-watch/scripts/preflight.py --url-mode para entradas de URL.
  2. 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.
  3. Leia os artefatos nesta ordem: manifest.json → prompt.md → transcript.md → frame-index.md → contact-sheet.jpg → arquivos selecionados em frames/ apenas se necessário. manifest.json registra 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.
  4. Responda a partir dos artefatos. Indique quando a resposta é apenas transcrição, apenas quadros, ou limitada por amostragem esparsa.
  5. Para momentos nomeados, execute novamente com --start / --end para focar o orçamento de quadros.

Modos de Detalhe

ModoUso
transcriptApenas legendas ou transcrição auxiliar. Mais rápido.
efficientPequena passagem visual para triagem rápida.
balancedFolha de contato padrão para a maioria das gravações de tela e demonstrações.
token-burnerMaior 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

NecessidadeReferência
Fluxo de trabalho detalhadoreferences/workflow.md
Dependências e configuraçãoreferences/dependencies.md
Orçamento de quadros e folhas de contatoreferences/frame-budget.md
Backends opcionais Scout/Whisper/Azure Speechreferences/backends.md

Individual skills in this repo

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

Habilidades Relacionadas