Communitygithub.com

guion-video-corto

Cria scripts de vídeo curto (Reels, Shorts, TikTok) beat por beat: linha falada, texto na tela e plano, com 3 hooks para teste A/B e legenda por rede. Escolha o arquétipo (descoberta, autoridade, nutrição, fechamento/ads, depoimento) conforme o nível de consciência do público. Para qualquer marca, com um perfil de marca preenchido uma única vez. Inclui 26 fórmulas de gancho, um verificador de hooks e tempos, trial reels e reels de voz + motion graphics sem câmera. Ativar com "script de vídeo", "script para um Reel", "script de TikTok", "preciso de um hook", "vídeo de depoimento", "vídeo para anúncios", "melhorar retenção", "trial reel", "reel de motion graphics".

O que é guion-video-corto?

Esta skill especializada em roteiros de vídeo curto (Reels, Shorts, TikTok) não escreve um vídeo genérico: primeiro identifica o tipo de vídeo necessário com base na intenção e no nível de consciência do público, depois carrega o playbook correspondente e o constrói sobre um motor de retenção comum. O entregável é um roteiro beat por beat (o que é dito, texto na tela e plano) mais legenda por rede, indicando o arquétipo e o nível de consciência utilizados. A skill é adequada para qualquer marca, pois o perfil da marca é preenchido apenas uma vez e reutilizado. Ela suporta as plataformas Instagram (Reels), YouTube (Shorts) e TikTok, e inclui 26 fórmulas de gancho, um verificador de hooks e tempos (script Python), trial reels para testar hooks organicamente e o formato de voz + motion graphics para produção sem câmera. O fluxo de trabalho começa com o carregamento do perfil da marca, depois a identificação do arquétipo (descoberta, autoridade, nutrição, fechamento/ads, depoimento), a aplicação do motor de retenção comum, a seleção de 3 hooks diferentes, a verificação com o script e a construção do roteiro final. A skill enfatiza a retenção inicial (3 segundos) como métrica chave, usa números reais em vez de adjetivos, e impõe regras rigorosas para nichos regulamentados (saúde, finanças, direito) para evitar promessas não comprovadas ou alegações problemáticas. O usuário pode solicitar apenas o hook, apenas a estrutura ou o roteiro completo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mrchinocontact-star/guion-video-corto-skill/tree/HEAD/skills/guion-video-corto

Perguntar na sua IA favorita

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

Documentação

O que guion-video-corto faz?

Vídeo curto por arquétipo e nível de consciência

Esta skill não escreve "um vídeo genérico". Primeiro identifica que tipo de vídeo a peça precisa, ou seja, sua intenção e o nível de consciência do público. Depois carrega o playbook que corresponde e o constrói sobre um motor de retenção comum a todos. Os números externos são tratados como hipóteses. O que realmente importa são os dados da própria conta.

Entregável: roteiro beat por beat (o que se diz + texto na tela + plano) + legenda por rede + o arquétipo e o nível de consciência usados. Não gera o vídeo: ele é gravado ou editado separadamente.


1. A espinha dorsal: níveis de consciência (Eugene Schwartz)

Isso decide o quão agressivo um roteiro pode ser. Não é uma questão de estilo: depende de quem está olhando.

  1. Inconsciente: não sabe que tem o problema.
  2. Consciente do problema: sente a dor, mas não sabe que há solução.
  3. Consciente da solução: sabe que existem soluções, mas não conhece a sua.
  4. Consciente do produto: te conhece, mas não está convencido.
  5. O mais consciente: está pronto e só precisa da oferta.

Regra de ouro: só se é agressivo com quem já está quente (níveis 4–5). Para um público frio (níveis 1–2), um fechamento duro o espanta. Por isso o vídeo orgânico de descoberta não vende, e o anúncio de retargeting vai direto para a oferta.


2. A métrica que manda

A distribuição é decidida pela retenção inicial, não pelas visualizações. Olhe nesta ordem:

  1. Retenção aos 3 s, ou seja, quantos continuam assistindo após o gancho. É a nota do hook.
  2. Tempo médio de visualização, para saber se o meio do vídeo sustenta.
  3. Compartilhamentos por alcance (compartilhamentos ÷ alcance), o sinal mais forte que se pode ganhar.
  4. Alcance a não seguidores, para saber se o vídeo viajou.
  5. Seguidores por alcance, para saber se o perfil converteu a atenção.

Sem números mágicos. Metas como "70% aos 3 s" circulam sem fonte verificável: use-as apenas como hipóteses. A referência real é a mediana da própria conta. Um vídeo que supera 3× essa mediana é um sinal. Abaixo de 1,5× é um dia normal.

Diagnóstico que economiza meses:

  • Um vídeo com visualizações e sem seguidores tem um problema de perfil, não de hook.
  • Um vídeo sem visualizações tem um problema de hook.

Separe os dois casos antes de reescrever qualquer coisa.


3. O roteador

Identifica a qual arquétipo a peça pertence e carrega seu playbook. Se o usuário não disser, pergunte ou deduza do objetivo.

ArquétipoNível de consciênciaTrabalho do roteiroAgressividadeCTA típicoCanalPlaybook
DescobertaInconsciente → ProblemaQue te encontremVenda zeroSeguir / salvarOrgânicoplaybooks/descubrimiento.md
AutoridadeProblema → SoluçãoQue acreditem em vocêSuaveSeguir / comentarOrgânicoplaybooks/autoridad.md
NutriçãoSolução → ProdutoQue prefiram vocêMédiaPalavra-chave → DMOrgânico + retargeting suaveplaybooks/nutricion.md
Fechamento / AdsProduto → Mais conscienteQue escolham você agoraAlta / diretaAgendar / comprar / aplicarAds (retargeting)playbooks/cierre-ads.md
DepoimentoConsideração → FechamentoQue validem a ofertaSuave-médiaPalavra-chave → DMOrgânico + adsplaybooks/testimonio.md

Cada peça tem uma intenção dominante. Se o usuário quiser "vários em um", separe-os em peças distintas.


4. Fluxo de trabalho

  1. Marca → perfil. Se existir perfiles/<marca>.md, carregue-o. Se não, use perfiles/plantilla-marca.md e peça no chat o contexto mínimo. Nunca invente dados da marca.
  2. Arquétipo → playbook. Use o roteador da seção 3 e leia o playbook correspondente. Lá estão a estrutura, o ângulo do hook, a agressividade e o CTA.
  3. Motor comum. Leia references/motor_hooks_retencion.md e references/formulas_hooks.md. Escolha 3 fórmulas distintas, não três versões da mesma. Para cada uma, escreva separadamente a linha falada e o texto na tela.
  4. Passe pelo verificador. Se houver terminal, execute scripts/guion_check.py (seção 8) e corrija cada alerta. Se não houver terminal, aplique as mesmas regras manualmente.
  5. Construa o roteiro com a estrutura do playbook e o motor. Uma ideia por beat, com loops abertos encadeados.
  6. Plataforma. Ajuste o corte conforme references/plataformas.md. Não reposte o mesmo corte em todas as redes.
  7. Legenda + CTA para a rede solicitada, com o CTA indicado pelo playbook e pelo perfil.
  8. Leia em voz alta. Uma linha "escrita" é notada assim que alguém a diz. Reescreva tudo o que não soar como uma pessoa falando.

Se o usuário quiser apenas o hook, ou apenas a estrutura, entregue essa parte.


5. Motor de retenção (resumo)

Esqueleto base, que cada playbook adapta: Hook (0–3 s) → Tensão → Beats de valor com mini-loops → Prova → Payoff → CTA. O detalhe está em references/motor_hooks_retencion.md.

Regras que valem para todas as intenções:

  • Começar no meio da ação ou pelo payoff. Nada de "olá, neste vídeo…".
  • Não colocar o logotipo nem a marca no início.
  • O frame 1 promete o que o vídeo entrega.
  • Cortes ou mudanças a cada poucos segundos, e um re-hook no meio se o vídeo passar de 30 s.
  • Legendas sempre: o vídeo precisa ser compreendido sem som.
  • O texto na tela é um roteiro separado.
    • Máximo de 6 palavras por cartela, e a cartela do hook aparece no frame 1.
    • Respeite a zona segura em 1080×1920: nada acima de y=230 nem abaixo de y=1440, e os 230 px da direita livres. Verifique na pré-visualização de cada rede.
  • Mude o plano em cada beat. Em um plano fixo de 8 s é onde as pessoas vão embora.
  • Uma ideia por vídeo. Se o roteiro tiver duas, são dois vídeos: diga isso.
  • Números antes de adjetivos. Se faltar um número real, deixe {{seu número}} e avise. Nunca o invente.
  • Depoimentos e casos apenas se forem reais e houver permissão para usá-los.
  • Um idioma por peça: o que é dito, o texto na tela e a legenda vão no mesmo idioma.

Nichos regulamentados (saúde, finanças, direito…)

  • Sem promessas de resultados nem alegações que a marca não possa provar.
  • Em peças que são veiculadas, não aludir a atributos pessoais do espectador, como "Você está acima do peso?" ou "Você tem dívidas?". Fale do serviço e do resultado.
  • Antes/depois apenas se for real, com consentimento e permitido pela plataforma.

6. Perfis de marca

A marca não muda o motor: apenas o veste.

  • perfiles/plantilla-marca.md é um modelo em branco. É preenchido uma vez por marca e salvo como perfiles/<marca>.md.
  • Se não for indicado para qual marca é a peça, pergunte antes de escrever.
  • O que faltar (preços, prazos, garantias, números) é marcado com [COMPLETAR] e o usuário é avisado.

7. Formato de entrega

| # | Tempo | O que se diz (voz) | Texto na tela | Visual / plano |
  • 3 variantes de hook acima, para o A/B.
  • Legenda por rede abaixo. A primeira linha curta com curiosidade, antes do "… mais".
  • Etiqueta no final: arquétipo + nível de consciência + plataforma.

8. Verificador (scripts/guion_check.py)

Está em Python 3, sem dependências, e funciona em português e inglês.

python scripts/guion_check.py hooks.txt                       # um hook por linha → ranking 0–100
python scripts/guion_check.py --hook "Perdi 40 clientes por um formulário sem resposta."
python scripts/guion_check.py guion.txt --beats --objetivo 30 --ppm 160   # uma linha por beat

Faz cinco verificações do hook:

  • Duração: é dito em 3 s ou menos.
  • Concretude: tem números, nomes ou prazos.
  • O que está em jogo: nomeia um custo, uma perda ou um erro.
  • Carga para frente: o importante vai nas primeiras palavras.
  • Para quem fala: usa tu/você ou nomeia um público.

Abaixo de 50 ainda não é hook.

Com --beats revisa o roteiro completo e marca:

  • um hook de mais de 3,5 s;
  • beats de mais de 4,5 s;
  • três beats seguidos sem nada concreto;
  • falta de loop, quando a última linha não retoma nenhuma palavra do hook.

Não prevê visualizações: detecta saudações, preâmbulos, hooks vazios e roteiros longos.

O gancho tem 5 camadas, e o script só mede a voz e o texto. Antes de entregar, verifique manualmente se estas camadas dizem a mesma coisa e chegam nos primeiros 3 s:

  1. o texto na tela;
  2. o visual, ou seja, o que se vê no frame 1;
  3. o vocal, a primeira linha falada;
  4. o som: música, efeito ou um silêncio intencional;
  5. a legenda, sua primeira linha.

Se duas camadas competirem, remova uma.

Palavras por minuto: calibre-as com a voz real da pessoa medindo um vídeo já gravado (palavras ÷ minutos). Enquanto não estiver medido, use 160 em português e 170 em inglês como ponto de partida, e avise.


9. Trial reels e formato "voz + motion"

Os trial reels são reels que o Instagram mostra primeiro apenas para não seguidores. São um laboratório gratuito para testar hooks.

  • Cada reel pode ter sua versão trial com outro hook, para fazer um A/B real.
  • Olhe a retenção aos 3 s, o alcance a não seguidores, os compartilhamentos e os seguidores por alcance. O que vencer é publicado normalmente ou veiculado.
  • Convém um volume que possa ser mantido, não rajadas.

O formato voz + motion graphics não precisa de câmera e serve para fazer volume:

  • A voz real é gravada separadamente, e a animação vai no After Effects ou outra ferramenta.
  • A estrutura é a do motor: hook visual com texto no frame 1 → 4–7 beats de 2–4 s, cada um com uma mudança visual → payoff → CTA.
  • Entregue também uma folha de animação que diga, para cada beat, o texto na tela, o elemento visual, o movimento e a duração.

10. Arquivos

  • playbooks/: a estrutura de cada intenção. É lido no passo 2.
  • perfiles/: a voz e a identidade de cada marca. É lido no passo 1.
  • references/motor_hooks_retencion.md: padrões de hook, retenção, legendas, A/B e um roteiro resolvido. É lido no passo 3.
  • references/formulas_hooks.md: 26 fórmulas de gancho em português e inglês. É lido no passo 3.
  • references/plataformas.md: como adaptar o corte para Reels, Shorts e TikTok. É lido no passo 6.
  • scripts/guion_check.py: o verificador local.

Habilidades Relacionadas