CommunityEscrita e Ediçãogithub.com

Roteiro de Explicação em Vídeos Curtos

Use ao escrever ou verificar a narração de um vídeo educativo curto (menos de 60 segundos) sobre como algo funciona, ao escolher ou verificar um gancho, quando uma fonte não abre ou se contradiz, ou ao escrever legendas, descrições ou texto na tela que afirmem fatos sobre um episódio.

O que é Roteiro de Explicação em Vídeos Curtos?

Esta skill é um guia detalhado para criadores de conteúdo que produzem vídeos educativos curtos (shorts). Ela se concentra em garantir a precisão factual de cada afirmação, desde o gancho inicial até as legendas na tela. O processo começa com a verificação rigorosa do gancho (a 'frase de abertura' surpreendente), que é a parte mais propensa a erros, e exige o uso de fontes primárias confiáveis, como normas técnicas, órgãos governamentais e documentação oficial, em vez de blogs ou repositórios secundários. A skill fornece uma hierarquia de fontes, instruções para lidar com fontes que não abrem ou se contradizem, e um formato específico para a narração (gancho, revelação, três batidas, linha de virada e encerramento). Além disso, estabelece um orçamento de palavras baseado na velocidade de fala do narrador, garantindo que o roteiro caiba no tempo do vídeo. Ela é útil para roteiristas, educadores e qualquer pessoa que queira criar vídeos explicativos precisos, evitando erros comuns como repetir arredondamentos incorretos de fontes ou adicionar fatos não verificados durante a escrita de descrições e tags.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Livin21/behind-the-things-skills/tree/HEAD/skills/scripting-explainer-shorts

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

O que Roteiro de Explicação em Vídeos Curtos faz?

Visão Geral

Uma explicação só é tão boa quanto sua afirmação mais fraca. Toda frase factual e todo número na tela precisa de uma fonte que você realmente abriu. Um gancho que soa bem geralmente é a linha menos verdadeira do rascunho, então verifique-o primeiro e reescreva-o se falhar.

Processo

  1. Verifique o gancho primeiro. Encontre uma fonte primária (um órgão normativo, fabricante, agência governamental, universidade ou código-fonte publicado) que o afirme. Então:

    • Falhou: reescreva-o para o que a fonte diz. "As listras não são o número" tornou-se "o código de barras não sabe o preço"; "uma partícula de metal radioativo" tornou-se "algo radioativo" (é um óxido, pequeno demais para ser visto).
    • Se mantém com uma nuance: mantenha-o, ajuste as palavras para corresponder à fonte e carregue a nuance em uma batida ("não cozinha de dentro para fora" → as ondas aquecem cerca de uma polegada de profundidade).
    • É comprovável apenas para alguns casos: mantenha-o geral, atribua cada número específico à sua fonte ("O padrão do Android…", "O Windows…") e registre a lacuna como parcialmente verificado.
  2. Pesquise as batidas. Abra cada fonte em vez de confiar em um trecho de busca e cite a linha de suporte. Escolha a fonte mais forte que afirme a afirmação:

    ClassificaçãoFonteExemplo
    1Órgãos normativos, especificações, código-fonte publicadoEMVCo, página do catálogo ISO/IEC, NFC Forum, GS1, AOSP
    2Agências governamentais, reguladores, bancos centraisNRC, EPA, FDA, USDA, Federal Reserve, ECB
    3Documentação do próprio fabricanteVisa, Mastercard, fichas técnicas da NXP, Microsoft Learn
    4Universidades, livros didáticos, artigos revisados por paresanotações de cursos universitários, artigos de conferências
    5Explicadores e imprensa confiáveisapenas quando 1–4 não afirmam a informação

    Nunca cite um espelho ou repositório (IPFS ou outras cópias da Wikipedia, reenvios de PDF), um site de conteúdo raso, um blog de SEO ou material de marketing de fornecedor. Se apenas um espelho abrir, encontre a página original ou uma cópia arquivada dela. A Wikipedia (ou uma cópia dela) pode levá-lo a uma fonte: siga a referência do artigo, abra-a e cite-a.

    • Uma página não abre: tente outro buscador, depois uma cópia arquivada. Se usar um arquivo, identifique-o. Se nada carregar, atenue a linha ou corte-a.
    • A fonte se contradiz ou contradiz a física: diga o valor correto claramente ("cerca de cinco polegadas") e mostre o cálculo em sources.md. Anote o valor da própria fonte em "Simplificado propositalmente". Exemplo: c ÷ 2450 MHz = 12,2 cm ≈ 5 pol, não o arredondamento "4 pol" do USDA.
    • Uma inferência (verdadeira por raciocínio, mas nenhuma fonte diz em uma linha): marque-a como inferência em sources.md.
  3. Escreva a narração (formato abaixo).

  4. Ajuste ao orçamento. O limite é 54 × (as palavras por segundo da voz), obtido do arquivo CHANNEL.md do projeto; são cerca de 140 palavras para uma voz de 2,6 palavras por segundo. A despedida falada está incluída. Conte com wc -w; uma palavra com hífen conta como uma.

  5. Tabela de cenas e empacotamento (consulte o modelo em templates.md).

  6. Escreva sources.md com o modelo: uma linha por afirmação, incluindo todo número mostrado na tela em tags ou leituras, depois "Simplificado propositalmente" e "Parcialmente verificado".

Formato da Narração

  1. Gancho (0–3 s): um fato verdadeiro e surpreendente, dito sobre o objeto, que é totalmente desenhado no primeiro quadro.
  2. A revelação: abra o objeto e mostre o que há dentro. Se a "coisa" for abstrata (um ícone, um sinal), revele o dispositivo que a produz, como o rádio do telefone para as barras de Wi-Fi. Escolha a vista desenhada de modo que a revelação exponha o interior e faça o verbo corresponder ao movimento ("levante a tampa").
  3. Três batidas: o que há dentro → como funciona → o que ninguém espera.
  4. Linha de virada: o fato que as pessoas repetem para um amigo.
  5. Despedida: a frase fixa do canal.

Escreva para o ouvido: frases curtas e soletre os números como falados. Adicione notas de voz para palavras arriscadas, que se tornarão respelings no prompt do TTS.

Todo Outro Texto

Tags na tela, descrições do YouTube, legendas e páginas do site só podem afirmar informações que já estão em sources.md. Adicionar um fato "pequeno" ao escrever o texto é como os erros são enviados.

Erros Comuns

ErroCorreção
Manter um gancho cativante que é "basicamente verdadeiro"Reescreva-o para o que a fonte diz
Repetir o erro de arredondamento de uma fonteVerifique com a física ou uma segunda fonte; mostre o cálculo
Tags com números sem fonteAdicione uma linha de fonte para cada valor na tela
148 palavras para uma voz lentaUse o ritmo medido da voz; limite em 54 × ritmo
Descartar silenciosamente uma fonte que não abreAtenue ou corte a linha; registre como parcialmente verificado
Citar um blog de fornecedor ou um espelho da WikipediaSuba na tabela: a especificação, o regulador, o fabricante

Habilidades Relacionadas