reels-scripting

Reels Scripting

Codex e Claude runtime

• Use esta skill no Codex ou no Claude com as ferramentas realmente disponíveis na tarefa atual. Exemplos de AskUserQuestion descrevem as perguntas, não uma API obrigatória: use uma ferramenta de perguntas disponível dentro de seus limites, ou pergunte no chat. Reutilize respostas e material de origem já fornecidos.
• Trabalhe no projeto selecionado pelo usuário. Leia seu about-me.md, voice.md e arquivos de marca relevantes antes de um trabalho personalizado. Confirme o autor pretendido se os arquivos entrarem em conflito ou contiverem valores padrão iniciais. Pergunte por fatos faltantes ou execute o voice-builder; nunca herde a identidade, contas ou arquivos privados do mantenedor.
• Resolva references/ agrupados em relação a esta pasta de skill. Para uma atualização de perfil explicitamente solicitada, leia e atualize o about-me.md, voice.md ou newsletter-voice.md canônico no local, preservando fatos e regras do usuário não relacionados. Os consumidores devem reler esses arquivos canônicos. Use um novo nome de arquivo apenas para novas entregas que colidiriam com arquivos existentes não relacionados. A instalação sozinha nunca inicia uma entrevista ou escreve arquivos. Não escreva aprendizados persistentes a menos que solicitado.
• Use as evidências fornecidas primeiro. Verifique afirmações externas por meio de ferramentas de busca/fonte disponíveis quando necessário. Se uma fonte ou integração estiver indisponível, nomeie a capacidade faltante e ofereça entrada de texto/exportação fornecida. Nunca invente fatos, experiência em primeira pessoa, métricas ou uma execução bem-sucedida de ferramenta.
• Conecte apenas serviços necessários para a rota escolhida por meio da conta existente do usuário. Nunca imprima credenciais ou sobrescreva conexões. Rascunhar, salvar e revisar não autorizam publicação, envio de mensagens ou alteração de contas.

CRÍTICO: Início automático ao carregar

Quando esta skill for acionada, vá direto para o Passo 1. Não faça um resumo.

Pré-requisitos

A rota completa de análise de vídeo Apify + Gemini precisa de:

• APIFY_API_TOKEN variável de ambiente (raspagem do Instagram)
• GOOGLE_AI_API_KEY variável de ambiente (análise de vídeo Gemini 2.5 Flash)
• Node.js 18+ e os pacotes apify-client e @google/generative-ai

Verifique apenas as capacidades necessárias para a rota escolhida. Para extração de URL e análise de vídeo Gemini, verifique se as credenciais existentes do usuário estão presentes sem imprimi-las, então verifique se o provedor e o modelo estão disponíveis. Credenciais, pacotes, um vídeo privado ou um modelo indisponível ausentes deixam esse estágio pendente. Explique o que está faltando; não modifique a configuração da conta ou substitua silenciosamente um provedor.

Um vídeo fornecido pode pular o Apify. Uma transcrição/análise fornecida pode pular os Passos 3 e 4 e apoiar um script baseado em transcrição rotulada no Passo 5, mas não é um resultado de análise de vídeo Gemini. Reutilize pacotes instalados; verifique a documentação atual do SDK oficial e do ator antes de gerar um script auxiliar, e obtenha a aprovação do usuário antes de incorrer em custos do provedor.

Passo 1. Obter a referência

Pergunte:

Cole o URL do Reel de referência ou link do Notion. Este é o Reel outlier que você quer usar como base para o formato.

Aguarde o URL.

Se o usuário colar um link do Notion, leia-o por meio de um conector Notion autorizado disponível, localize o URL do Reel do Instagram na página e extraia-o. Se nenhum URL do Reel for encontrado na página do Notion, peça ao usuário para colar o URL do Reel diretamente.

Passo 2. Obter o tópico da newsletter

Pergunte:

Qual é o tópico da sua newsletter que você quer reaproveitar neste Reel? Cole a seção relevante da newsletter ou digite a ideia central em uma frase.

Aguarde o tópico. Leia newsletter-voice.md, voice.md e about-me.md do projeto, se existirem, para que o script corresponda à voz do usuário.

Passo 3. Raspar e baixar o Reel

Use uma nova pasta outputs/reels/<slug>/ no projeto selecionado. Reutilize um auxiliar adequado existente, se presente; caso contrário, escreva um pequeno script Node.js específico para a tarefa lá que:

1. Use apify-client e a rota existente apify/instagram-reel-scraper, após verificar seu esquema documentado atual, para o único Reel solicitado. Nunca raspe comentários, respostas ou threads de comentários, inclusive via deepScrape ou numComments. Verifique se o provedor suporta coleta apenas de post/vídeo antes de chamá-lo; caso contrário, solicite um upload de vídeo. Não adivinhe entradas alternativas do ator.
2. Extraia videoUrl do item retornado.
3. Baixe o vídeo para outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4.
4. Salve os dados brutos da raspagem em outputs/reels/<slug>/reel_data_{shortCode}.json.

Execute o script. Confirme o tamanho do arquivo e os metadados (visualizações, curtidas, contagem agregada de comentários se disponível, primeiros 200 caracteres da legenda) antes de continuar.

Um único Reel é uma referência, não um outlier verificado. Chame-o de outlier apenas quando dados de comparação fornecidos ou explicitamente solicitados estabelecerem seu desempenho em relação às postagens recentes do mesmo criador; cite a amostra, a janela e as múltiplas. Não invente essa linha de base.

Passo 4. Analisar com Gemini 2.5 Flash

Estenda o script Node (ou execute uma segunda passagem) que:

1. Leia o .mp4 baixado como base64.
2. Chame genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }).
3. Envie o vídeo com este prompt exato:

Estou estudando este Reel para escrever meu próprio roteiro em um estilo semelhante para meu público de [PÚBLICO DE about-me.md].

## Transcrição Completa
- Transcreva CADA palavra com timestamps

## Gancho
- Primeiras palavras exatas faladas
- Contagem de palavras do gancho
- O que faz ele parar a rolagem?

## Padrões de Linguagem
- Comprimento médio da frase
- Proporção você/seu vs eu/meu
- Transições entre pontos
- Onde estão os minimizadores 'apenas'?

## Estrutura
- Duração total
- Divisão de seções com tempos
- Qual é o momento antes/depois?
- Qual é o CTA?

## Um insight chave
- A técnica mais importante para aprender com este Reel

Salve a análise em outputs/reels/<slug>/analysis_reference_{shortCode}.md.

Passo 5. Escrever o novo roteiro do Reel

Usando a análise do Passo 4, o tópico da newsletter do Passo 2 e os arquivos de voz do usuário, escreva um novo roteiro do Reel para outputs/reels/<slug>/reel-[slug].md.

Aplique estas regras (não negociáveis):

Gancho

• Nunca comece com "Eu". Use "isto", "você", um fato ou uma menção de nome.
• Formatos comprovados: "Isto mudou... para sempre" / inversão negativa ("X é inútil a menos que...") / declaração de capacidade.
• O gancho cria curiosidade ou interrupção de padrão em 3 segundos.
• Espelhe a contagem de palavras e estrutura do gancho da análise de referência.

Corpo

• Inglês britânico. Frases curtas. Sem travessões, sem ponto e vírgula.
• Use "você" e "apenas" de forma conversacional ("você apenas coloca...").
• Nunca mescle três ou mais fragmentos staccato. Combine em uma frase fluente.
• Nunca declare a conclusão. Deixe os fatos fazerem o trabalho.
• Use um CTA de comentário apenas se o usuário tiver uma entrega real e uma automação de trabalho confirmada. Caso contrário, use uma próxima ação relevante que não faça promessa de entrega.

Gatilho de comentário (apenas quando suportado)

• Apenas uma palavra em maiúsculas (SCRIPT, WIKI, PROMPTS, VIDEO).
• Deve se relacionar diretamente com o que está sendo prometido.
• Sem aspas, sem "abaixo", sem pontuação final.

CTA

• "Comente [PALAVRA] e eu te envio [coisa específica]"
• Curto. Sem o "o link para meu completo" de enchimento.

Duração e estrutura

• Alvo de 30 a 45 segundos no total.
• Máximo de 2 pontos chave, não 3.
• Legenda espelha o roteiro. Atualize ambos juntos.

Estrutura do arquivo de roteiro

# Reel: [título]

## Análise de referência
- URL: [url do reel]
- Visualizações: [número]
- Técnica chave: [da análise Gemini]

## Alvo de duração
30-45 segundos

## Gancho (0-3s)
[Palavras exatas]

## Ponto 1 ([início]-[fim]s)
[Palavras exatas]

## Ponto 2 ([início]-[fim]s)
[Palavras exatas]

## CTA ([início]-[fim]s)
[Próxima ação relevante, com promessa de comentário apenas quando a entrega for confirmada]

---

## Legenda
[Espelha o roteiro, formatado para Instagram]

## Gatilho de comentário (apenas se configurado)
[PALAVRA ou não aplicável]

## Entrega (apenas se prometida)
[O recurso real disponível ou não aplicável]

---

## Notas visuais
[Cortes, ideias de B-roll, sobreposições de texto]

Passo 6. Ciclo de QA

Revise no assistente em execução: precisão da fonte (30), voz do usuário (25), gancho e estrutura (20), duração falada e clareza (15), consistência da legenda/CTA (10). Cite evidências para cada pontuação. Corrija violações reais e reavalie, até três passagens. Portão é 95/100; se não resolvido, relate um rascunho com os bloqueadores específicos em vez de inflar a pontuação ou afirmar que está pronto. Cronometre uma leitura em voz alta quando disponível; caso contrário, rotule duração estimada. O Claude não é necessário para esta revisão no Codex.

Verificações comuns de violações:

• Começa com "Eu"
• Fragmentos staccato de três ou mais
• Declara a conclusão
• Gatilho de comentário com múltiplas palavras ou estilizado
• Duração acima de 45 segundos quando lido em voz alta
• 3 pontos em vez de 2
• Legenda não espelha o roteiro

Passo 7. Entregar o roteiro

Entregue o roteiro revisado e a legenda correspondente no projeto, com fonte de referência, método de análise e quaisquer verificações não resolvidas. O usuário pode gravá-lo ou solicitar explicitamente seu próprio fluxo de produção disponível. Esta skill pública não fornece um pipeline de avatar, edição ou publicação.

Regras

• Nunca pule o portão de QA 95/100.
• Sempre leia voice.md e about-me.md antes de escrever. A correspondência de voz não é negociável.
• Nunca invente métricas do Reel de referência. Use apenas metadados verificados fornecidos ou obtidos, e marque métricas ausentes como indisponíveis.
• Inglês britânico. Sem travessões. Sem ponto e vírgula.
• Cada roteiro inclui a legenda correspondente; inclua um gatilho de comentário apenas quando a entrega prometida funcionar.
• Se o acesso à referência falhar, relate o estágio com falha e ofereça entrada de vídeo/transcrição fornecida. Não fabrique análise de vídeo.
• Gemini 2.5 Flash é o modelo. Não substitua sem a aprovação do usuário.