mason0510/video-frame-analysis-skills

Análise de Quadros de Vídeo

Visão Geral

Consolide o fluxo "vídeo local → ffprobe → extração de quadros com timestamp → contact sheet → OCR → summary.txt / ocr.json" em um skill leve e reutilizável.

Adequado para agentes como Codex, Claude Code e OpenCode processarem vídeos locais de demonstração, gravações de tela e walkthroughs de concorrentes.

Quando Usar

Adequado para:

• O usuário envia um vídeo local e você precisa avaliar o progresso de um produto
• Necessidade de decompor o vídeo em quadros revisáveis, texto OCR e arquivos de resumo
• Extração leve de evidências antes de julgamento humano ou análise mais aprofundada
• Evitar montar manualmente comandos ffmpeg / tesseract a cada vez

Não adequado para:

• Download de vídeos da rede
• Filas de lote de vídeos
• Análise de fluxo em tempo real
• GUI ou plataforma Web
• Modelos pesados de compreensão de vídeo

Início Rápido

bash scripts/video-frame-analysis.sh /caminho/para/demo.mp4 ./out/analise-demo

Saída padrão:

• ffprobe.txt
• frame_*.jpg
• contact.png
• ocr.txt
• ocr.json
• summary.txt

Instalação

Recomenda-se instalar diretamente no Codex / Claude Code / OpenCode:

npx skills add https://github.com/mason0510/video-frame-analysis-skills -g --all

Após a instalação, reinicie a sessão do agente e acione este skill conforme necessário.

Entrada / Saída

Entrada

• Caminho do vídeo local
• Caminho do diretório de saída

Saída

• Metadados do vídeo
• Quadros com timestamp
• Contact sheet
• Texto OCR
• OCR em JSON
• Resumo em texto

Configuração

FRAME_INTERVAL_SECONDS=5 FRAME_WIDTH=420 OCR_LANG=eng \
  bash scripts/video-frame-analysis.sh ./demo.mp4 ./out/demo

Variável	Descrição	Valor Padrão
FRAME_INTERVAL_SECONDS	Intervalo entre quadros (segundos)	8
FRAME_WIDTH	Largura de cada quadro	360
OCR_LANG	Idioma(s) para OCR	chi_sim+eng

Arquivos do Projeto

• scripts/video-frame-analysis.sh: Script principal
• tests/test_video_frame_analysis.sh: Teste mínimo de ciclo fechado
• references/output-format.md: Explicação da estrutura do diretório de saída
• agents/openai.yaml: Informações de exibição para OpenAI/Codex

Erros Comuns

• Tratar como modelo pesado de compreensão de vídeo
• Extração excessiva de quadros gerando ruído no OCR
• Ignorar a contact sheet e focar apenas no texto OCR
• Não verificar se ffmpeg / tesseract estão instalados na máquina