CommunityEscrita e Ediçãogithub.com

Roteiro para Vídeo

Escreve, edita e otimiza roteiros para vídeos verticais, incluindo gancho, narração, diálogo, texto na tela, ritmo, desfecho e CTA.

O que é Roteiro para Vídeo?

A habilidade 'Roteiro para Vídeo' (Scriptwriting) capacita agentes de IA a produzirem roteiros profissionais para vídeos curtos e verticais, com foco em clareza, impacto e cronometragem precisa (60 FPS). Ela orienta desde a preparação inicial (briefing, público, tom da marca) até a entrega final do roteiro, passando pela estruturação de cenas, regras de escrita (uma ideia por frase, linguagem conversacional), distinção entre narração e texto na tela, e a criação de uma tabela de roteiro detalhada com beats, timing e intenção visual. A habilidade é útil para criadores de conteúdo, profissionais de marketing e editores que utilizam ferramentas como Remotion para animação, garantindo que o roteiro seja traduzível em timing de renderização. Ela também inclui um rigoroso protocolo de revisão com uma lista de 'sinais de roteiro escrito por IA' (padrões como nominalizações, passivas empilhadas, inflação de importância) e limites seguros de edição para preservar o significado. Suporta plataformas como Claude Code, Cursor e Codex, e seu guia (SKILL.md) documenta todo o fluxo de trabalho de forma prática.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/main/.claude/skills/scriptwriting

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 PARA VÍDEO — Habilidade de Narrativa em Vídeo

Objetivo

Produzir roteiros que sejam claros quando ouvidos, fortes quando lidos na tela e traduzíveis em visuais e timing do Remotion.

1. Preparação

Antes de escrever, entenda:

  • o briefing criativo e o resultado de beyond-video;
  • público, plataforma, objetivo, duração;
  • a mensagem principal e o nível de conhecimento do público;
  • o tom/voz da marca;
  • limites factuais, legais e de fontes;
  • o estilo visual e a capacidade de produção.

Não escreva um roteiro que contradiga o briefing criativo sem explicar o motivo.

2. Estrutura do roteiro

Use uma estrutura adequada, não uma fórmula rígida:

  • Gancho.
  • Contexto/preparação.
  • Desenvolvimento/progressão.
  • Evidência/exemplo/demonstração.
  • Virada/revelação.
  • Desfecho.
  • CTA.

Formato curto não significa que toda frase deve ser mecanicamente curta. Varie ritmo e extensão das frases para que soe natural.

3. Regras de escrita

  • Prefira uma ideia por frase.
  • Evite introduções longas e preenchimento.
  • Use linguagem coloquial adequada ao público-alvo.
  • Use palavras concretas, exemplos, analogias e verbos visuais.
  • Remova repetições que não acrescentam significado.
  • Não use jargão sem contexto.
  • Não faça afirmações absolutas quando a fonte só suporta uma afirmação limitada.
  • Sinalize números, nomes, datas, citações e estatísticas que precisam de verificação.
  • Nunca invente depoimentos ou experiências pessoais.

4. Narração vs. texto na tela

A narração carrega contexto/narrativa. O texto na tela enfatiza palavras-chave e informações que precisam ser lidas. Não copie toda a narração para a tela, a menos que seja uma escolha de design deliberada.

Cada texto na tela deve ser:

  • curto e fácil de escanear;
  • hierárquico;
  • legível em uma tela de celular;
  • dentro da área segura;
  • exibido tempo suficiente para ser lido;
  • em sincronia com os visuais e a narração.

5. Cronometragem a 60 FPS

  • Defina a duração com base na contagem de palavras, complexidade da ideia, pausas e ação visual.
  • As estimativas de velocidade de leitura são apenas um ponto de partida; não presuma que uma única taxa de fala serve para todos os narradores/idiomas.
  • Registre os beats em segundos e converta para quadros, ou trabalhe diretamente em quadros, usando uma regra de arredondamento.
  • Deixe espaço para o desfecho visual e transições.
  • Evite sobrecarregar com muita informação apenas para atingir uma duração.

6. Tabela do roteiro

Use este formato:

Beat/CenaTempo / QuadroNarração / DiálogoTexto na telaIntenção visualSinal de áudio
Gancho...............

Inclua a duração total estimada e uma lista de afirmações que precisam de verificação.

7. CTA

O CTA deve ser uma ação primária: específica, fácil de realizar e relevante para o vídeo. Não adicione automaticamente "curtir, comentar, inscreva-se". Vincule o CTA ao benefício ou ao acompanhamento que o vídeo prometeu.

Coordene o texto do CTA e o contexto final com a habilidade beyond-video; o logotipo de encerramento + CTA devem ser personalizados.

8. Protocolo de revisão

Ao editar um roteiro:

  • identifique o objetivo da revisão;
  • mantenha as partes que ainda funcionam;
  • não mude a mensagem principal sem explicar;
  • verifique novamente os fatos após as alterações;
  • verifique a sincronia com o storyboard e a duração;
  • registre as concessões quando o roteiro for encurtado.

8a. Sinais de roteiros escritos por IA

Roteiros de narração são lidos em voz alta; padrões mecânicos são percebidos mais rápido pelo ouvido do que pelos olhos. Verifique o rascunho contra esta lista antes de finalizar. Uma única ocorrência geralmente é aceitável; o que se procura é um padrão repetido. A lista foi escrita para inglês, com um exemplo em indonésio por padrão, porque os mesmos sinais aparecem em diferentes idiomas; para outros idiomas, construa uma lista equivalente em vez de traduzir esses exemplos literalmente.

CódigoPadrãoExemplo em inglêsExemplo em indonésioCorreção
A1Verbos nominalizados (tradução literal)"perform an analysis of", "have an impact on""melakukan pembahasan"Use o verbo direto: "analyze", "affect"
A2Passivas empilhadas / agente ausente"changes were made by the team""telah dilakukan perubahan oleh tim"Restaure o agente: "the team changed…"
A3"Pode" / "talvez" em toda afirmação"this can help improve…""ini dapat meningkatkan…"Afirme quando for verdadeiro; hesite apenas quando a fonte hesitar
A4Conectivos genéricos"in terms of", "with regard to", "where""terkait", "dalam hal", "di mana"Divida a frase ou use o conectivo preciso
B1Excesso de conectivos"Moreover… Therefore… As a result…" em todo parágrafo"Selain itu… Oleh karena itu…"Remova a maioria; a ordem das ideias já as conecta
B2Preâmbulos de listas"There are three things you need to know:""Ada tiga hal yang perlu diketahui:"Vá direto ao primeiro item
B3Fechamentos com resumo"In conclusion…", "At the end of the day…""Kesimpulannya…"Termine com um desfecho concreto ou o CTA
C1Inflação de importância"crucial", "revolutionary", "game-changing""sangat penting", "revolusioner"Substitua por um fato concreto ou remova
C2Fórmula de contraste repetida"It's not X, it's Y" mais de uma vez"Bukan X, tapi Y"Mantenha uma; transforme as outras em afirmações diretas
C3Fórmula de transformação"From X to Y", "Beyond X""Dari X menjadi Y"No máximo uma vez por vídeo
C4Abstrações personificadas"technology asks", "the era demands""zaman menuntut"Use um sujeito humano/organizacional real
C5Fechamentos discursivos"Now is the time…", "It's time to…""Inilah saatnya…"Um verbo concreto: o que o espectador deve fazer
D1Tamanho uniforme de frasesCada frase tem 12–15 palavras—Misture frases muito curtas com frases mais longas
D2Tríades constantes"fast, easy, and efficient" em toda frase"cepat, mudah, dan efisien"Escolha a palavra mais forte
E1Termo + glosa em toda menção"skill (a reusable instruction)… skill (a reusable instruction)""skill (keterampilan)…"Explique uma vez, depois mantenha consistência
E2Palavras de marketing vazias"seamless", "robust", "next-level"—Diga o que realmente acontece
F1Sobrecarga de emoji/símbolo em texto na tela🚀✨ em toda linha—Apenas quando tiver uma função visual clara

Limites de edição segura:

  • Não toque em: nomes próprios, nomes de produtos, números, datas, unidades, citações diretas e termos técnicos padrão (API, frame, render).
  • Palavras de conteúdo devem sobreviver. Antes de editar, marque os substantivos e conceitos que carregam a afirmação em cada frase. Remova apenas preenchimento e inflação; não troque palavras de conteúdo por sinônimos que alterem o significado. Quando estiver em dúvida, restaure a frase original.
  • Não edite em excesso. Se mais de cerca de um terço das palavras mudar, pare e verifique se o significado ainda é o mesmo. O objetivo é um roteiro que soe natural, não um novo roteiro.
  • Após editar, verifique novamente a duração da narração: frases enxutas alteram o cronograma do storyboard.

Referência de ideia: epoko77-ai/im-not-ai (MIT) — estrutura de categorias e limites seguros de edição. A lista de padrões acima foi escrita do zero, não traduzida da lista coreana.

9. Entregáveis

Forneça o roteiro final, narração/diálogo separados, texto na tela, cronometragem dos beats, CTA, duração estimada e notas de verificação de fatos.

Individual skills in this repo

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

Habilidades Relacionadas