Communitygithub.com

PetarKukric/CLAUDE_SKILLS

Transforme um Reel de referência do Instagram em um roteiro para o seu próprio Reel, ajustado à sua voz e reaproveitado do conteúdo da sua newsletter.

O que é CLAUDE_SKILLS?

Esta skill automatiza a criação de roteiros para Reels do Instagram a partir de um Reel de referência e conteúdo de newsletter. O fluxo principal utiliza a Apify para extrair o vídeo de uma URL do Instagram, envia-o para o Gemini 2.5 Flash para transcrição completa e análise de estrutura (gancho, padrões de linguagem, duração), e então gera um novo roteiro que aplica os mesmos padrões ao tópico da newsletter do usuário. A skill é projetada para ambientes como Claude Code, Codex ou Cursor, e respeita rigorosamente os arquivos de voz e perfil do usuário (`voice.md`, `about-me.md`), garantindo que o roteiro final soe autêntico. Inclui um loop de garantia de qualidade com pontuação mínima de 95/100 e verifica violações comuns, como abertura com "eu", fragmentos staccato e duração excessiva.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PetarKukric/CLAUDE_SKILLS/tree/HEAD/cache/social-media-skills/social-media-skills/1.1.0/skills/reels-scripting

Perguntar na sua IA favorita

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

Documentação

Criação de Roteiro para Reel

Runtime do Codex e Claude

  • Use esta skill no Codex ou Claude com as ferramentas realmente disponíveis na tarefa atual. Os 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 seus arquivos about-me.md, voice.md e outros arquivos de marca relevantes antes do trabalho personalizado. Confirme o autor pretendido se os arquivos entrarem em conflito ou contiverem valores padrão iniciais. Pergunte por fatos faltantes ou execute voice-builder; nunca herde a identidade, contas ou arquivos privados do mantenedor.
  • Resolva as references/ agrupadas em relação a esta pasta de skill. Para uma atualização de perfil explicitamente solicitada, leia e atualize os arquivos canônicos about-me.md, voice.md ou newsletter-voice.md no local, preservando fatos e regras não relacionados do usuário. Os consumidores devem reler esses arquivos canônicos. Use um novo nome de arquivo apenas para novas entregas que entrariam em conflito com arquivos existentes não relacionados. A instalação por si só nunca inicia uma entrevista ou escreve arquivos. Não escreva aprendizados persistentes a menos que solicitado.
  • Use as evidências fornecidas primeiro. Verifique alegações externas por meio de ferramentas de pesquisa/origem disponíveis quando necessário. Se uma fonte ou integração não estiver disponível, nomeie a capacidade ausente 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 os 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 a Etapa 1. Não resuma.

Pré-requisitos

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

  • Variável de ambiente APIFY_API_TOKEN (raspagem do Instagram)
  • Variável de ambiente GOOGLE_AI_API_KEY (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, depois verifique se o provedor e o modelo estão disponíveis. Credenciais ausentes, pacotes, um vídeo privado ou um modelo indisponível deixam esse estágio pendente. Explique o que está faltando; não modifique a configuração da conta nem substitua silenciosamente um provedor.

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

Etapa 1. Obter a referência

Pergunte:

Cole a URL do Reel de referência ou link do Notion. Este é o Reel outlier cujo formato você deseja engenharia reversa.

Aguarde a URL.

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

Etapa 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 roteiro corresponda à voz do usuário.

Etapa 3. Raspar e baixar o Reel

Use uma nova pasta outputs/reels/<slug>/ no projeto selecionado. Reutilize um auxiliar existente adequado 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 postagem/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 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 somente quando dados de comparação fornecidos ou explicitamente solicitados estabeleçam seu desempenho em relação às postagens recentes do mesmo criador; cite a amostra, janela e múltiplos. Não invente essa linha de base.

Etapa 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 [AUDIENCE FROM about-me.md].

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

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

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

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

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

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

Etapa 5. Escrever o novo roteiro do Reel

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

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

Gancho

  • Nunca abra 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 até 3 segundos.
  • Espelhe a contagem de palavras e a estrutura do gancho da análise de referência.

Corpo

  • Português de Portugal. Frases curtas. Sem travessões, sem ponto e vírgula.
  • Use "você" e "só" de forma coloquial ("você só adiciona...").
  • 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 confirmada em funcionamento. Caso contrário, use uma ação relevante seguinte 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 lhe envio [coisa específica]"
  • Curto. Sem o preenchimento "o link para o meu completo".

Duração e estrutura

  • Duração total de 30 a 45 segundos.
  • No máximo 2 pontos-chave, não 3.
  • A 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]

## Duração alvo
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 exata, com promessa de comentário apenas quando a entrega for confirmada]

---

## Legenda
[Espelha o roteiro, formatado para o 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]

Etapa 6. Loop de garantia de qualidade

Revise no assistente em execução: precisão da origem (30), voz do usuário (25), gancho e estrutura (20), duração falada e clareza (15), consistência legenda/CTA (10). Cite evidências para cada pontuação. Corrija violações reais e reavalie, até três passagens. A meta é 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 a duração como estimada. O Claude não é necessário para esta revisão no Codex.

Violações comuns a verificar:

  • Abre com "Eu"
  • Fragmentos staccato de três ou mais
  • Declara a conclusão
  • Gatilho de comentário com várias 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

Etapa 7. Entregar o roteiro

Entregue o roteiro revisado e a legenda correspondente no projeto, com a origem de referência, o 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 trabalho de produção disponível. Esta skill pública não inclui um avatar, pipeline de edição ou publicação.

Regras

  • Nunca pule a meta de QA de 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 fornecidos ou buscados verificados e marque métricas ausentes como indisponíveis.
  • Português de Portugal. 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, reporte 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.

Individual skills in this repo

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

Habilidades Relacionadas