CommunityEscrita e Ediçãogithub.com

builtnotboosted/roteiro-de-video

Escreve roteiros de vídeo que soam como a pessoa que vai falá-los, para curtos (Reels, TikTok, YouTube Shorts) e longos no YouTube. Gancho caloroso, identidade e pedido de seguir no início, estrutura de retenção que atrasa a resposta, encerramento suave, duração que segue a história, substância de problema real, roteiros reativos para notícias e lançamentos de dados. A saída está pronta para o teleprompter (pausas, lembretes de cena) com breves notas de edição para a skill de edição de vídeo. Use quando alguém disser "escreva um roteiro para mim", "roteire um Reel sobre", "preciso de um curta sobre", "planeje um vídeo no YouTube", "transforme este post em vídeo", "reaja às notícias de hoje em vídeo", "o que devo dizer na câmera" ou antes de uma sessão de gravação.

O que é roteiro-de-video?

Esta skill é especializada em criar roteiros de vídeo que soam naturais e autênticos, como se a própria pessoa estivesse falando espontaneamente, em vez de ler um texto decorado. Ela é projetada para produtores de conteúdo que desejam construir confiança e conexão com seu público, em vez de parecerem um anúncio. A skill suporta tanto vídeos curtos (Reels, TikTok, YouTube Shorts) quanto vídeos longos no YouTube, com estruturas específicas para cada formato: um gancho caloroso que apresenta o problema, uma breve apresentação pessoal com um pedido de seguir, uma seção de intriga que atrasa a resposta, a entrega clara da ideia principal e um encerramento suave com uma sugestão prática. O roteiro gerado é pronto para o teleprompter, incluindo pausas e lembretes de cena, e é acompanhado por três linhas de notas de edição que orientam o editor sobre o gancho na tela, a capa do vídeo e o resultado prometido. A skill prioriza a personalização, lendo o perfil da marca e, crucialmente, o arquivo de aprendizados de voz que documenta como a pessoa realmente fala, garantindo que cada roteiro fique mais próximo de sua voz natural.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/builtnotboosted/built-not-boosted-skills/tree/HEAD/plugins/built-not-boosted/skills/video-scripting

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Roteiro de vídeo

Esta skill é responsável pelo roteiro falado e suas notas de edição. Ela escreve o que a pessoa diz na câmera, na voz dela, moldado para prender a atenção, e entrega três linhas curtas para a skill video-editing para que a edição saiba o gancho na tela, as palavras da capa e o resultado prometido. Legendas e texto da postagem pertencem à skill writing, a escolha do formato e a pesquisa do tópico à research, a edição em si à video-editing, e a garantia de qualidade ao review-loop.

A crença central: um roteiro é um esqueleto para uma pessoa real, não um texto para ser lido em voz alta. Pessoas que soam bem na câmera explicam em torno da página. Escreva para isso, e o vídeo soará como elas, em vez de um anúncio.

Antes de começar

  1. Encontre o espaço de trabalho de marketing (padrão marketing/). Se não houver, diga em uma linha e ofereça brand-setup, ou pergunte o essencial: quem está falando, o que faz, para quem e onde.
  2. Leia brand/brand-profile.md: ## Identidade, ## Público, ## Voz, ## Limites, ## Conformidade, ## CTA e contato. O perfil da marca prevalece nas constantes da marca e nas palavras de conformidade; esta skill possui o método.
  3. Leia brand/voice-learnings.md antes de cada roteiro. É o registro de como essa pessoa realmente fala na câmera, aprendido pela skill voice-loop a partir de seus vídeos filmados e edições manuais. Aplique suas regras atuais; elas superam a orientação geral aqui onde as duas diferirem.
  4. Leia brand/performance-learnings.md para saber o que funcionou (formatos, ganchos, durações), se existir.
  5. Obtenha os fatos. Qualquer afirmação, número ou citação vem da pessoa, do briefing ou da research com uma fonte. Nunca invente uma história de cliente, um número, uma citação ou uma avaliação. Se não houver uma história real, transforme em uma educação honesta.

O padrão

  • Caloroso e relaxado, não frenético. O oposto de gritos de alta energia e cortes secos. Convidativo, sem pressa, humano. Humor leve onde surgir naturalmente, nunca às custas do cliente.
  • Soa como eles. Se uma linha não sairia da boca deles, reescreva-a. Palavras simples, contrações, comprimento de frase variado.
  • Fique ao lado do espectador, não na frente dele. Evite "a maioria das pessoas erra isso" e "as pessoas costumam pensar", que dizem ao espectador que ele provavelmente está errado. Diga "é fácil perder", "muitos de nós ouvimos". Evite marcadores vazios de hype ("aqui está o que ninguém te conta") que fazem o espectador esperar por uma recompensa; apresente o ponto real claramente.
  • Útil, nunca uma venda. Construa confiança e o público; deixe que as consultas venham disso.
  • Uma ideia por curta. Problemas reais que seu público realmente tem, não enrolação.
  • Sem travessões no texto do roteiro. Use vírgulas, parênteses, pontos finais.

Estrutura: curtas (30 segundos a cerca de 2 minutos, sempre abaixo de 3)

Uma forma, não uma fórmula. Muitos criadores reconhecerão como Gancho, Intriga, Entrega, Saída; nós fazemos do jeito caloroso.

  1. Gancho. Uma frase falada completa, de cerca de 10 a 14 palavras, que nomeia o tópico claramente e dá o interesse humano ou a reviravolta honesta. Não é uma cena encenada, não é um enigma, não é "oi pessoal", não é um logotipo. A tensão vive no fato, não em uma entrega exagerada. Escreva como a frase inteira que eles diriam (muita gente naturalmente abre com um preenchimento como "Então,"); perguntas fragmentadas tendem a ser reescritas na câmera.
  2. Quem-sou-eu e seguir, logo depois. Um breve momento nas próprias palavras da pessoa: nome, o que faz, para quem e onde, se local, depois um pedido leve de seguir. Exemplo: "Sou o Sam, conserto bicicletas na oficina da rua principal. Me segue aí e vamos nessa." Mantenha a linha de identidade consistente entre os vídeos (esse é o objetivo); varie apenas o final para que um lote gravado em uma tarde não abra de forma idêntica. Coloque a localização aqui, não no gancho. Nunca uma promessa de resultado, nunca implorar ("manda aquele like").
  3. Intriga. Uma ou duas frases, geralmente da semana real deles ("teve um cliente essa semana que..."), que fazem o espectador sentir o problema. Seu trabalho é atrasar a resposta, nunca dá-la.
  4. Entregue. A única ideia clara, sem pressa, em palavras simples. Cumpra exatamente o que o gancho prometeu; se o gancho lista números ou retém algo, escreva o resultado primeiro e certifique-se de que o corpo o confirme.
  5. Saída. Uma pequena coisa para tentar hoje, com uma pergunta sobre ela: "Pegue uma régua e verifique sua corrente hoje à noite. Qual foi a sua medida? Me conta nos comentários." Um fio, um pedido, formulado como "isso me ajudou", nunca "você deve". Depois, uma despedida rápida e humana em sua própria linha, com as palavras deles (mantenha a mesma sempre que souber o que eles dizem).

Regra de sem-spoiler: nem o gancho nem a primeira linha após o quem-sou-eu podem dar a resposta. Se derem, o espectador já tem o que veio buscar e passa adiante.

Estrutura: longos (cerca de 8 a 15 minutos, 16:9)

  1. Abertura calorosa: o gancho (a promessa do vídeo), um leve quem-sou-eu para novos espectadores e, se quiser, um motivo suave para se inscrever ("se isso for útil, fique por aqui, tem mais como isso").
  2. Configuração: enquadre o problema e diga o que o espectador vai receber.
  3. Capítulos: cada um uma mini configuração, ensino, resultado. Faça cada transição um pequeno gancho para frente, em vez de um ponto de parada, e planeje dois momentos deliberados de reengajamento por volta de um terço e dois terços. Marcadores de capítulo no roteiro são marcadores silenciosos para a edição; capítulos visíveis para o espectador vêm dos timestamps da descrição.
  4. Resultado e encerramento: cumpra a promessa, depois exatamente três pedidos: uma coisa para tentar, um ponteiro para um vídeo relacionado deles e uma pergunta para comentário. Depois, um fechamento adequado.
  5. Ordem de escrita: resultados primeiro, depois configurações, depois tensão, gancho por último, para que o gancho corresponda honestamente ao que o vídeo entrega.
  6. Busca: título e descrição lideram com a pergunta do espectador em suas palavras ("por que a pressão da minha caldeira caiu?") em vez do mecanismo.

Para roteiros reativos (uma notícia, uma mudança de preço, um lançamento de dados) e mais padrões de gancho e detalhes de retenção, abra references/hooks-and-retention.md.

Duração e ritmo

  • A duração segue a história. Não encha para atingir um tempo e não corte uma explicação real para caber em 40 segundos. Curtas curtos (30 a 60 segundos) e peças mais completas de 1 a 2 minutos são ambos bons quando a história é contada.
  • Dimensione pelo ritmo. Até que o voice-learnings tenha o ritmo medido da pessoa, assuma cerca de 190 palavras por minuto: cerca de 95 palavras para 30 segundos, 190 para um minuto, 380 para dois. Peças de um ponto deliberado são mais lentas (cerca de 150), resumos rápidos são mais rápidos (cerca de 220). Cerca de 500 palavras faladas é um teto prático para um curta.
  • Escreva próximo ao comprimento falado. No início, algumas pessoas expandem um roteiro para o dobro do seu comprimento na câmera; quando a proporção de entregue para escrito no voice-learnings se estabilizar perto de 1,0, escreva no comprimento total. Deixe os números do voice-loop decidirem.
  • Fatos completos, opiniões em tópicos. As pessoas leem fatos e citações quase palavra por palavra, mas improvisam em momentos de opinião, então escreva os fatos verificáveis e qualquer citação por completo e deixe os momentos de opinião como lembretes curtos.
  • Escreva mais simples do que parece satisfatório no papel. Frases ornamentais são substituídas na câmera pela versão simples. Guarde o capricho para uma metáfora caseira e a linha de resultado; imagens concretas e cotidianas sobrevivem melhor à filmagem.

Conformidade

O perfil da marca ## Conformidade decide. Se o negócio for regulamentado ou o vídeo promover algo com palavras obrigatórias, o padrão é que o aviso obrigatório vá na legenda (escrita por writing), não falado, para que o roteiro permaneça humano e a legenda carregue as palavras exatas. Verifique suas próprias regras: alguns regimes ou políticas de anúncios exigem o aviso na tela ou falado, e então o perfil da marca diz isso e você o segue. De qualquer forma, mantenha a tensão em fatos reais, nunca prometa um resultado ("você com certeza vai economizar"), e não cite um preço ou número na câmera que possa mudar antes de ir ao ar. Um exemplo rotulado para serviços financeiros do Reino Unido está em references/regulated-industries-example.md.

Saída (uma pasta por peça)

Em content/<yyyy-mm-dd>-<slug>/:

  1. script.txt, pronto para o teleprompter: apenas texto falado, quebras de linha limpas, sem cabeçalhos, sem travessões. Pausas (uma linha em branco a cada duas ou três frases e antes do resultado) para que o falante possa desviar o olhar e voltar, o que também dá à edição pontos de corte limpos. Três a seis lembretes de cena em suas próprias linhas entre colchetes angulares e em maiúsculas, duas ou três palavras cada, logo antes da linha a que se aplicam: <ENTRADA>, <APROXIMAR>, <SEGURAR OLHAR PARA CAPA>, <B-ROLL: CHAVES, PORTA>. Detalhes e o exemplo PromptSmart em references/prompter-and-edit-notes.md.
  2. edit-notes.txt, três linhas, nunca no teleprompter:
    GANCHO NA TELA: Marchas pulando?
    CAPA: VERIFIQUE ISSO PRIMEIRO
    RESULTADO: você saberá as duas causas comuns de marchas pulando e como verificar uma hoje à noite
    
    GANCHO NA TELA tem de 3 a 5 palavras que prometem sem dar a resposta. CAPA tem de 2 a 4 palavras verdadeiras e simples para a miniatura. RESULTADO é o que o espectador obtém; se você não gostaria como espectador, não faça o vídeo.
  3. sources.txt: de onde veio cada fato.
  4. Cópia base: salve uma cópia não editada de script.txt em baselines/<yyyy-mm-dd>/<slug>-script.txt. Nunca a edite. A skill voice-loop compara as edições da pessoa e sua entrega filmada com ela, e é assim que o próximo roteiro se aproxima mais dela.

Legendas e títulos para as postagens são então escritos por writing a partir do roteiro e das notas de edição.

Verificações antes de enviar

Passe o roteiro e as notas de edição para review-loop, ou verifique: o gancho cai nos primeiros segundos e não é um spoiler; quem-sou-eu e pedido de seguir no início, sem promessa de resultado; intriga atrasa a resposta; toda promessa no gancho é cumprida; uma etapa de tente-isso com uma pergunta sobre ela; despedida rápida; sem "a maioria das pessoas", sem marcadores de hype; gancho na tela tem de 3 a 5 palavras e não é a resposta; pausas e lembretes de cena presentes; duração dimensionada pelo ritmo; nenhuma história ou figura inventada; conformidade de acordo com o perfil da marca; regras de voice-learnings aplicadas; sem travessões.

Adaptando

  • Suas palavras: coloque a linha de quem-sou-eu da pessoa e a despedida no perfil da marca ## Voz ou ## CTA e contato, e deixe voice-loop refiná-las a partir de filmagens reais.
  • Mais de um apresentador: dê a cada um seu próprio quem-sou-eu e mantenha seus voice-learnings separados se falarem de forma diferente.
  • Seu teleprompter: qualquer aplicativo de teleprompter funciona; verifique uma vez se sua rolagem por rastreamento de voz passa pelas linhas de lembrete de cena limpa.
  • Seus limites: qualquer coisa sobre a qual você não possa aconselhar ou reivindicar vai no perfil da marca ## Limites; roteiros podem educar sobre isso e sinalizar, nunca posicioná-lo como fazendo isso.

Referências

  • references/hooks-and-retention.md: padrões de gancho, ganchos na tela, forma de retenção, roteiros reativos e de lançamento de dados, encerramentos. Abra quando o gancho não estiver funcionando ou para uma reação a notícias.
  • references/prompter-and-edit-notes.md: formatação de teleprompter, lembretes de cena, notas de edição e hábitos de gravação. Abra ao preparar uma sessão de filmagem.
  • references/worked-example-short.md: um curta completo para um pequeno negócio neutro, roteiro mais notas de edição.
  • references/regulated-industries-example.md: como isso funciona para um negócio regulamentado (serviços financeiros do Reino Unido como exemplo).

Saiba mais: https://builtnotboosted.com/skills/video-scripting

Individual skills in this repo

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

builtnotboosted/image-generation

Produces finished social images with any image model (Google Gemini image, "Nano Banana", as the worked example) - feed statics, carousel slides, short-form video covers, YouTube and article thumbnails, local listing cards and animated statics. Bakes the headline into the scene instead of pasting text on top, keeps text inside the profile-grid safe zone, locks the likeness of real people to their reference photos, hits exact platform sizes, writes alt text and re-judges every re-roll on the filed file. Use when someone says "make an image for this post", "create a thumbnail", "make a cover from my video", "design a carousel", "animate this static", "the image model won't do 4:5", "my headline is getting cut off in the grid", or when a content pack needs its visuals.

builtnotboosted/review-loop

The quality gate every piece of content passes before it is filed, scheduled or posted. Runs a self-critique, then an independent review by a fresh subagent that sees only the finished work and the criteria (never the builder's reasoning), then fix and re-judge until there is a clean pass. Covers what to do when a piece can't pass unattended (hold, flag, ship the rest). Use when someone says "review this", "check this before it goes out", "QA the pack", "is this ready to post", "get a second pair of eyes on this", "proofread the captions", or when any other Built Not Boosted skill hands work over for checks.

builtnotboosted/scheduling

Gets finished posts into a social media scheduler (or posted by hand) safely. Queue-only with explicit timezone offsets, live dedup against scheduled and already-published posts, media readiness checks, correct post types (shorts, reels, carousels, first comments, manual-posting reminders), alt text, a link gate that sends copy back for a rewrite rather than stripping it, and confirmation before anything goes live. Writes and keeps a scheduling manifest for each pack. Works with any scheduler; Publer is the worked example. Use when someone says "schedule this", "queue these posts", "put this in Publer", "book in this week's content", "post this on Tuesday at 7", "move that post", "what's already scheduled", or hands over a finished content pack to go out.

builtnotboosted/video-editing

Edits filmed talking-head footage into release-ready vertical shorts (1080x1920) and 16:9 YouTube long-forms with ffmpeg and Whisper. Keeps exactly one clean read of every script line (no stumbles, restarts or double reads), never leaves a flat single shot (punch-ins, reframes, B-roll, motion graphics), captions from the finished audio, normalises loudness to -14 LUFS, makes a real-frame cover and runs a QA gate that re-transcribes the render and refuses delivery until it passes. Syncs extra cameras by sound and writes YouTube chapters. Use when someone says "edit my video", "cut this clip", "remove my retakes", "edit out the fluffs", "add captions to my video", "make a short from this footage", "sync my two cameras", "make a thumbnail from my video", or hands over raw footage and a script.

Habilidades Relacionadas