O que Analisador faz?
Envie um vídeo curto (Reel, TikTok ou Short) que você gosta e ele analisa o gancho, o ritmo e a edição. Depois, reutiliza a mesma estrutura para criar um vídeo sobre o seu tópico.
Tudo é executado neste computador. As ferramentas ficam em ~/.claude/skills/analyzer/scripts/ e são executadas com o Python próprio da skill: ~/.claude/skills/analyzer/.venv/bin/python (daqui em diante: PY = esse caminho, AN = ~/.claude/skills/analyzer/scripts).
0. Verificar a instalação (a cada execução)
test -x ~/.claude/skills/analyzer/.venv/bin/python && command -v ffmpeg
Se algum deles estiver faltando, informe o usuário em uma linha e execute o instalador: bash ~/analyzer-skill/install.sh, ou clone primeiro: git clone https://github.com/corbinsylk/analyzer-skill ~/analyzer-skill && bash ~/analyzer-skill/install.sh.
1. Obter o vídeo
Um link (Instagram, TikTok, YouTube Shorts, X) ou um arquivo. Então:
PY AN/fetch.py "<link ou arquivo>"
Ele imprime o caminho do vídeo na sua última linha (os downloads vão para ~/Movies/Analyzer/). Posts públicos baixam sem necessidade de login. Se falhar (conteúdo privado, restrito por idade, removido), peça ao usuário para baixar ou gravar a tela e arrastar o arquivo.
2. Medir o vídeo
PY AN/transcribe.py "<video>"
PY AN/shots.py "<video>"
Ambos usam a pasta de trabalho <nome do vídeo>-analysis/ ao lado do vídeo. transcribe.py gera transcript.md e words.json (cada palavra com seu tempo; uma dica sobre "mps" na primeira execução é inofensiva). shots.py gera pacing.md (todos os números abaixo, mais uma tabela quadro a quadro com o que é dito em cada cena), sheet-N.jpg folhas de contato (pequenas, numeradas, para visão geral) e shots/NN.jpg (um quadro por cena com 720 de largura, grande o suficiente para ler texto na tela; cenas longas também geram NN-a/NN-b, seu primeiro e último momento). Se shots.py encontrar muito menos cenas do que o vídeo obviamente tem, execute novamente com --threshold 0.18; se ele dividir uma cena em muitas (movimento rápido, flashes), use --threshold 0.4.
3. Analisar e escrever a análise
Leia transcript.md e pacing.md. Abra todas as folhas de contato para a visão geral e, em seguida, abra os quadros shots/NN.jpg dos primeiros 3 segundos e de qualquer cena onde algo mude (texto aparece, zoom, gráfico, novo local): não é necessário abrir todos. Você não pode ouvir o vídeo: não diga nada sobre música ou efeitos sonoros além do que a transcrição mostra. A transcrição pode interpretar mal nomes e termos (um esporte, uma marca, um prato): verifique-os com o texto na tela e use a grafia correta no que escrever.
Escreva <pasta de trabalho>/breakdown.md com estas seções, cada afirmação vinculada a um tempo ou número de cena:
- O gancho (0-3 s). As palavras exatas, o que está na tela (enquadramento, texto na tela e sua posição, movimento), quantos cortes e por que ele prende a atenção: a lacuna de curiosidade, a promessa, a quebra de padrão.
- A estrutura. Os momentos em ordem com seus tempos: gancho, configuração ou problema, as reviravoltas, o desfecho, a chamada para ação. Para cada momento: sua função, sua duração em segundos e palavras, e a frase que realiza essa função.
- O ritmo. Os números de pacing.md (cenas, duração média e mediana das cenas, cortes nos primeiros 3 segundos, palavras por minuto) e o que significam. Para contar as palavras de um momento:
PY AN/words.py "<pasta de trabalho>" <início> <fim>(em segundos ou minutos:segundos); ele imprime a contagem de palavras, o ritmo e as palavras: onde acelera, onde segura, como a taxa de cortes acompanha a história. - A edição. Enquadramento e câmera (quanto do quadro o rosto ocupa, zoom-ins, mudanças de ângulo: visualmente a partir dos quadros), texto na tela (estilo, tamanho, posição, quando aparece), legendas (estilo, quantas palavras por vez), B-roll, gravações de tela, gráficos, transições.
- A fórmula. A estrutura como um modelo preenchível que qualquer um poderia reutilizar: cada momento como
[o que vai aqui]com sua duração alvo, contagem de palavras e movimento de edição.
Em seguida, diga ao usuário o gancho, a fórmula e as três coisas que fazem o vídeo funcionar, em poucas linhas, e aponte para breakdown.md.
4. Recriar com o tópico do usuário
Faça uma pergunta se o usuário ainda não disse: "Qual tópico (e para quem é) devo usar para criar o novo vídeo?"
Então escreva <pasta de trabalho>/remake.md:
- O roteiro, palavra por palavra, momento a momento, na mesma estrutura, cada momento com cerca de 10% de variação na contagem de palavras do vídeo de referência (de words.py), para que tenha a mesma duração no mesmo ritmo. O gancho usa o mesmo mecanismo do vídeo de referência (o mesmo tipo de promessa, número, pergunta ou quebra de padrão), nunca suas palavras. Se o usuário disse como fala (um arquivo de voz ou marca, roteiros anteriores neste projeto, instruções próprias), escreva nessa voz; senão, de forma direta e coloquial, como as pessoas falam para a câmera.
- O plano de cenas: para cada momento, o que filmar (enquadramento, para onde olhar, gestos, objetos ou locais) e o movimento de edição naquele momento, baseado no vídeo de referência (um corte, um zoom-in, texto na tela com suas palavras exatas, B-roll a mostrar).
- Texto na tela listado separadamente, com seu tempo.
- Notas de filmagem: diga cada linha duas vezes para que a melhor take seja escolhida; pause um segundo entre as linhas.
5. Corte bruto (quando o usuário tiver filmado)
Quando o usuário arrastar sua filmagem da recriação:
PY AN/transcribe.py "<filmagem>"
Leia transcript.md e words.json da filmagem. Para cada linha do roteiro, escolha a melhor take limpa (completa, sem tropeços; geralmente a última) e escreva <pasta de trabalho da filmagem>/keep.json, na ordem do roteiro:
[{"line": "a linha do roteiro", "start": 12.40, "end": 15.92}]
start = o s da primeira palavra da take, end = o e da última palavra da take, de words.json. Então:
PY AN/rough_cut.py "<filmagem>" "<pasta de trabalho da filmagem>"
Ele corta cada take exatamente nas bordas das palavras, enquadra 9:16 no rosto, junta tudo na ordem com legendas palavra por palavra e escreve rough-cut.mp4 mais rough-cut.jpg (8 quadros ao longo do vídeo). Abra o jpg e verifique se o rosto está enquadrado e as legendas são legíveis. Diga ao usuário o que está no corte bruto e quais movimentos de edição do plano de cenas ele ainda pode adicionar em seu editor (texto, zooms, B-roll).