Communitygithub.com

guion

Converte um briefing em um roteiro de reel ou anúncio, pronto para gravar ou gerar. Escreve o gancho de 3 s, a estrutura frase a frase, a tabela frase → take, a chamada para ação e o copy da publicação, tudo em um único roteiro de produção que alimenta o teleprompter. Não inventa números, nomes nem casos.

O que é guion?

Esta skill transforma um briefing em um roteiro de produção completo para vídeos do tipo reel (até 40 s) ou anúncio (5–15 s), seguindo uma metodologia testada que prioriza o gancho nos primeiros 3 segundos, a correspondência literal entre voz e imagem, e a eliminação de dados inventados. Ela guia o usuário por oito etapas: coleta mínima de campos críticos do briefing (ideia, público, duração, dados permitidos, canal da CTA, restrições), design do gancho visual e sonoro, escrita frase a frase com pausas e gestos, criação da tabela frase→take com verificação literal, cronometragem real, montagem do roteiro de produção a partir de um template, e apresentação de uma única recomendação com até duas perguntas de dados ou escopo. A skill é parte das receitas `reel`, `anuncio` e `tutorial` e apoia plataformas como Claude Code e outras ferramentas de IA baseadas em markdown. Ela se diferencia por regras rígidas: nenhum dado inventado, nenhuma promessa não verificada, e o roteiro do cliente vai literal (sem alterações). O resultado é um arquivo .md pronto para direção, gravação, teleprompter e montagem.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/robinfernandez2016-create/claqueta/tree/HEAD/skills/guion

Perguntar na sua IA favorita

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

Documentação

O que guion faz?

Um bom vídeo é decidido antes de gravar: o que para o dedo nos 3 primeiros segundos, o que se vê em cada frase e para onde manda o final. Esta skill deixa tudo em um único documento que serve para dirigir, gravar, ler no teleprompter e montar.

É a etapa "Roteiro" das receitas reel, anuncio e tutorial (pasta recetas/, na raiz do pacote).

1 · O briefing

Não se escreve com campos adivinhados. Pergunte apenas o que faltar e que mude o resultado.

CampoO que pede
Ideia em uma fraseO que precisa entender quem vê
PúblicoPara quem fala e o que o incomoda
Quem apresentaPessoa em câmera, voz off ou personagem animado; voz real ou sintética
Duração e formatoReel de até 40 s; anúncio de vídeo de 5 a 15 s; vertical ou horizontal
Dados permitidosCada número, preço, prazo ou nome, com sua fonte
Canal da chamada para açãoOnde a pessoa vende: WhatsApp, site, loja
O que NÃO querPalavras, temas, tons ou formatos vetados
Traz roteiro próprio?Se for fechado, vai literal

Se trouxer um vídeo de referência, use antes a skill referencia.

2 · O fluxo

  1. Busque a ideia nova. Diga o que esta peça tem que as anteriores da mesma conta não tinham.
  2. Desenhe primeiro os 3 primeiros segundos: o que se vê aos 0,5 s e o que se ouve até o segundo 3.
  3. Escreva por frases com a estrutura da seção 3. Pausas com "…". Gestos e olhares vão entre parênteses dentro da voz.
  4. Faça a tabela frase → take (seção 4).
  5. Meça: leia em voz alta com cronômetro, em ritmo natural, e some o que dura o teste mesmo que a voz cale (um chat, uma demo). Não estime contando palavras.
  6. Monte o roteiro de produção: modelo em referencias/guion-de-produccion.md.
  7. Mostre e espere. Um roteiro com sua recomendação, não um leque; se for para pauta, com um gancho alternativo. No máximo 1 ou 2 perguntas, só de dados ou de escopo. Um "ok" aprova o roteiro, não as etapas seguintes.

3 · A estrutura que funciona

Vem de um roteiro reescrito à mão que depois foi aprovado como receita para todos: um gancho com uma pessoa concreta e o resultado adiantado venceu um monólogo em "você" com uma lista de razões.

  1. Gancho = uma história em uma frase: alguém concreto ("ela", "ele"), o que aconteceu e o resultado adiantado. Abre um loop. Forma: "[Alguém] [fez ou disse algo difícil]… e mesmo assim [resultado] (gesto para o celular). Olha o que fizemos."
  2. A prova se vê: o chat, a demo, o produto funcionando. A voz não a lê.
  3. Contraste: com a alternativa de sempre ou com o que o cliente faz hoje, e a tese em uma frase ("Isso não é X. É Y.").
  4. Giro: uma verdade emocional do ramo, com a marca como sujeito de uma frase curta ("[Marca] mantém isso…"), não como sobrenome de outra coisa ("um serviço da [Marca]").
  5. Chamada para ação: razão + ordem + benefício, com uma pausa antes da ordem.

Outras entradas válidas para o gancho: uma pergunta, um número real, um personagem animado ou um depoimento real. Nunca o logotipo nem um cumprimento.

Exemplo de fechamento (inventado, para uma loja de tênis; os fatos quem põe é a pessoa):

"Comprar tênis sem experimentar dá medo… Escreva pra gente no WhatsApp e ajudamos você a escolher seu tamanho."

Formatos que funcionaram:

  • Apresentador + b-roll intercalados (clipe, b-roll, clipe, b-roll). O gancho, com o apresentador mostrando a prova no celular.
  • Dois amigos: duas pessoas do ramo conversam; uma sofre o problema e a outra já resolveu. A marca é mencionada uma única vez, na recomendação final e sem números, para não parecer propaganda.
  • Personagem animado + takes: só funciona se cada take ilustrar a frase exata.

Alavancas que valem (mencione-as no roteiro para que possam ser revisadas): loop aberto, orgulho, medo, aversão à perda, inimigo comum. Nunca urgência inventada, vagas falsas nem casos falsos.

4 · Tabela frase → take

Uma linha por frase da voz. É o que mais se corrige quando se pula: uma montagem bem medida, com takes "bonitas e parecidas", foi rejeitada inteira por "não mostra o que você diz".

#Voz (literal)O que se vêDe onde vem~s
1"De novo o tamanho errado?"Alguém abre uma caixa e os tênis não cabemGravado2,5
  • Cada linha passa no teste "isso é literalmente o que diz?". Se diz "não enferruja", vê-se o enferrujado; se diz "sem químicos", vêem-se os químicos riscados, não o produto.
  • Se a ficha do cliente já diz que take vai, vai essa. "Literal" não autoriza a mudá-la.
  • Ordem de busca: o material original do cliente, depois suas seleções e cortes, e o descartado por último. Se não houver take real, stock com licença. Se também não, gera-se (skill generacion-ia, que passa antes por presupuesto).
  • Nenhum take repetido na peça, nem o que já saiu em outra peça recente da conta.
  • Leia o que se lê dentro do take. Um rótulo, uma etiqueta ou uma tela podem contradizer a mensagem.
  • Palavras do ofício: confirme o que cada termo técnico significa antes de escolher seu take. Uma palavra mal entendida dá o take errado.
  • Planos de 3 a 4 s. Uma frase longa leva dois takes. Que as mensagens de um chat mudem não é um novo plano; outra escala, outro ângulo ou outra ideia, sim.
  • No roteiro, "o que se vê" descreve. Antes de montar refaça a ficha com o fotograma real de cada take, mostre, e só monte o que passar.

5 · O que não se quebra

  • Gancho nos 3 primeiros segundos. Um reel se ganha ou se perde na retenção: um que cumpria toda a lista mas não prendia teve que ser refeito.
  • 40 s no máximo, somados antes de gravar. Se a voz e a prova passarem, corte mensagens, silêncios ou frases sem esperar que peçam: avisar que está longo não basta.
  • O que se vê é literalmente o que a voz diz. Se não, quem olha vê uma coisa e ouve outra.
  • Nenhum dado inventado: números, preços, prazos, pessoas, clientes, casos nem depoimentos. Para soar "feito sob medida", use o possessivo ("Seu catálogo", "Sua voz"). Um nome inventado na tela é lido como real e obriga a explicar "quem é?".
  • Os nomes de demo dentro de um chat simulado são adereços. Um número lido como resultado real, por outro lado, pergunta-se.
  • Um depoimento gerado é um personagem claramente animado. Uma pessoa realista inventada contando sua compra é lido como depoimento real.
  • Números com a mesma base. "Nossos clientes fecham entre X e Y", nunca "seu negócio passará de A a B" se A e B não medem a mesma coisa. Comparações de preço, no mesmo volume e com "até" se for um teto. Misturar bases é prometer o que não se pode cumprir.
  • Os números derivados (um total anual tirado de um dado diário) usam as suposições da pessoa e vão com nota de rodapé. As suposições são dela, não suas.
  • Um número que soa pequeno vai para a nota de rodapé, não para a voz. O pequeno, dito em voz alta, subtrai.
  • O confirmado vai sem muletas que o enfraqueçam ("até hoje" soa inseguro). O não confirmado não vai.
  • Nada de promessas: nem resultados garantidos, nem vagas limitadas, nem prazos exatos na voz ("você recebe em poucos dias", não uma faixa de horas). Um número exato na voz soa como um contrato.
  • A chamada para ação leva razão + ordem + benefício e manda para o canal onde a pessoa vende. Se for WhatsApp, nada de "comente X", "siga a gente" nem "link na bio": busca-se conversas, não seguidores. Uma ordem solta no final soou "muito abrupta". Um desafio ("não acredita?") também se resolve escrevendo.
  • O roteiro fechado da pessoa vai literal: nem uma vírgula. Não acrescente a chamada para ação nem nada por conta própria; proponha em uma linha separada. Acrescentar uma vez obrigou a removê-la.
  • Títulos sóbrios. Nada de frases feitas ("Procura-se X. Não qualquer um.", "o próximo viral"): soam como modelo e baixam o nível. Melhor o fato como ele é.
  • Concorrentes pelo nome, só se a pessoa aprovar.
  • O resultado é o prêmio. O roteiro dá a ele seu próprio plano e seu som, e aí a câmera não abre: um afastamento bem no momento do pagamento quebrou a emoção.
  • Um salto de tempo é uma viagem entre planos de no máximo 1 s, com seu som; nunca um cartaz parado.

6 · Se o roteiro leva um chat ou uma demo

  • Quem responde é o negócio e fala em primeira pessoa: nunca "um consultor confirma" nem "te encaminho". Numa demo, essa frase denunciou o sistema e foi corrigida: quem responde já é o consultor.
  • A voz off pode falar para o dono ("sua equipe"); o chat fala para o cliente final.
  • O chat é gráfico: fotos do produto, uma nota de voz, um documento (catálogo, dados de pagamento). Nunca só bolhas de texto.
  • Fotos de perfil com rostos, não iniciais nem logotipos.
  • Só use dados que já estão no chat ou no briefing.
  • Vê-se como o app de verdade (barra, bolhas, horários, fonte do sistema), não uma versão inventada.
  • Se o apresentador mostra o celular, na tela vai o mesmo chat que depois sai no b-roll: assim parece real.

7 · Copy da publicação

  • A mesma chamada para ação do vídeo, para o mesmo canal.
  • Só os dados que saem no vídeo, com a mesma fonte.
  • Título sóbrio. Se a ficha da marca veta palavras, elas não aparecem.
  • É entregue; só se publica se a pessoa pedir.

8 · Números

O queQuanto
Reel40 s no máximo
Anúncio de vídeo5 a 15 s
Gancho0 a 3 s; o que para o dedo, aos 0,5 s
Plano3 a 4 s; mais só se não houver outro jeito de contar
Algo novo na telaa cada 4 s no máximo
Salto de tempoviagem de no máximo 1 s
Perguntas ao propor1 ou 2, de dados ou escopo
Gancho alternativo1 por roteiro de pauta

9 · Armadilhas conhecidas

  • A voz gravada não é o roteiro: sempre muda algo. Transcreva-a (Whisper) antes de montar ou animar, e meça o final de cada palavra no áudio, não na transcrição.
  • Três versões do mesmo roteiro dessincronizam (direção, técnica e teleprompter). Um só; o teleprompter sai de suas linhas de VOZ.
  • A documentação do produto pode estar atrasada em relação ao produto. Diante de uma contradição, vale o que a pessoa disser; anote em "Dados e fontes".
  • O plano de conteúdos de outra ferramenta também atrasa. Confirme com a pessoa o estado real antes de dar um roteiro como "pronto para gravar".
  • Um número que funcionou numa referência não se copia: use um real da pessoa ou mude de gancho.
  • Um take "parecido" não é o take. Se duvidar, não passa no teste literal.

10 · O que se entrega e o que se verifica

Entrega-se o roteiro de produção (.md): ideia, preparação, ordem de gravação, takes com sua VOZ literal, tabela frase → take, notas de edição, copy da publicação, gancho alternativo se for pauta, dados e fontes, e mudanças em relação à versão anterior. O teleprompter são suas linhas de VOZ, sem tocar.

Verifica-se e diz-se ao entregar:

  • A duração cronometrada (voz mais prova) cabe no máximo.
  • O gancho está marcado e dura 3 s ou menos.
  • Cada número, preço, prazo e nome tem sua fonte em "Dados e fontes".
  • Cada frase tem seu take e cada take passa no teste literal.
  • A chamada para ação leva razão + ordem + benefício e vai para o canal do briefing.
  • O teleprompter coincide letra por letra com as linhas de VOZ.
  • Se o roteiro era da pessoa, não mudou nem uma vírgula.

Individual skills in this repo

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

robinfernandez2016-create/color

Corrige e iguala el color de material real antes de montarlo o entregarlo. Detecta midiendo si un clip es S-Log3 o HLG de celular y lo pasa a Rec.709 (SDR), coloriza cada clip de apoyo antes de usarlo, iguala tomas con una LUT por toma, separa persona y fondo en dos capas, etalona en Premiere con Lumetri por script y revela fotos RAW. Úsalo cuando alguien diga «igualar el color», «corrige el color», «coloriza estos clips», «que todas las tomas se vean iguales», «se ve lavado», «se ve oscuro / amarillo / verdoso», «está muy frío», «la piel sale rara», «el celular sale naranja», «esto está en log», «en QuickTime se ve distinto», «revela estas fotos» o «la foto sale tumbada».

robinfernandez2016-create/control-calidad

El filtro por el que pasa todo render antes de que lo vea la persona. Mide duración y fps, escala y bordes, zonas seguras, negros, vídeo congelado, último fotograma, volumen y picos, siseo y alfa real; repasa la lista de errores que ya salieron; mide el ritmo con `referencia.py`; compara cada corrección con la versión anterior para no romper lo aprobado, y deja que un supervisor con veto firme «aprobado» o «cambios». Úsalo antes de cada entrega y cuando digan «revisa el render antes de mandármelo», «¿está listo para entregar?», «pásalo por control», «¿se rompió algo con el cambio?», «compáralo con la versión anterior» o «apunta esta corrección para la próxima».

robinfernandez2016-create/generacion-ia

Genera imágenes, vídeo y voz con IA (Higgsfield, Kling, Seedance, GPT Image, HeyGen, ElevenLabs y otros) sin desperdiciar créditos y sin que el resultado mienta. Elige el modelo según lo que haya en el plano, mantiene el mismo personaje dentro de la pieza, hace presentadores con voz clonada y lip-sync, compone croma sobre foto, protege el producto real del cliente (que se reproduce, no se recrea) y corrige editando lo aprobado en vez de regenerar. Siempre pasa antes por la skill `presupuesto`. Úsalo cuando digan «genérame una imagen», «hazme un vídeo con IA», «anima esta foto», «clona mi voz», «que hable sin grabarlo», «haz un 360 del producto», «mete este croma en la foto», «ponle otro fondo» o «no me gusta, hazlo otra vez».

robinfernandez2016-create/motion

Hace motion graphics como código con Remotion (gráficos animados, brolls, alfas sobre el vídeo o por detrás de una persona, pop-ups, subtítulos, simulacros de chat, 3D y la portada del reel) con la marca en un archivo de tokens, bocetos de 2 o 3 fotogramas antes del render y salida con fondo o con transparencia. Úsalo cuando digan «hazme un gráfico animado», «anima este dato», «hazme un broll», «un pop-up aquí», «ponle subtítulos», «subtítulos con palabras clave», «simula un chat de WhatsApp», «que salga detrás de mí», «hazlo en 3D», «con fondo transparente», «la portada del reel» o «renderiza el MG».

Habilidades Relacionadas