Communitygithub.com

morrimoz/roteiro-de-video-e-storyboard

Use esta habilidade sempre que o usuário precisar roteirizar E storyboard de um vídeo de produto de software, aplicativo, SaaS, IA, API, fintech ou startup — como vídeo de lançamento, vídeo hero para home page, reel de lançamento de recurso, demo de produto, explicador, teaser, segmento de keynote, VSL ou corte para redes sociais.

O que é roteiro-de-video-e-storyboard?

Esta habilidade é projetada para ajudar equipes de software a criar vídeos de produto que realmente convertem, combinando um roteiro focado em mudança real e prova verificável com um storyboard detalhado que um motion designer pode executar imediatamente. Em vez de anúncios genéricos ou listas de recursos com adjetivos cinematográficos, a habilidade guia o usuário por um processo de cinco etapas: definir a arquitetura de lançamento e escolher um framework (como AIDA, PAS, ou Hook-CTA), selecionar um gancho intencional, construir uma sequência de prova baseada em módulos e não em menus de funcionalidades, escrever em batidas com transições claras e uma chamada para ação específica, e finalmente produzir um storyboard cena por cena com descrições visuais, timing e notas de produção. A habilidade funciona em qualquer plataforma de IA generativa que suporte markdown (como Claude Code, Cursor ou Codex) e é ideal para lançamentos de produtos, demos, teasers e vídeos para redes sociais. Ela também inclui testes antifraqueza, anti-padrões e instruções para melhorar rascunhos genéricos, garantindo que o vídeo final seja funcional, convincente e pronto para produção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/morrimoz/video-script-storyboard/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Roteiro de Vídeo & Storyboard

Escreva vídeos de produto da maneira que equipes de software fortes realmente os entregam: uma mudança clara, uma sequência de prova crível, uma lógica visual, um próximo passo — depois converta cada batida em um storyboard pronto para produção que um motion designer possa construir imediatamente.

Não escreva um anúncio de marca genérico com UI colada. Não escreva uma lista de recursos com adjetivos cinematográficos. Faça o espectador entender o que mudou, por que isso importa e o que fazer a seguir — depois entregue um storyboard que diga exatamente como cada cena se parece, lê e se move.

A saída é um único documento com duas camadas:

  1. Camada de roteiro — o argumento, a sequência de prova e o texto (governado pela disciplina de lançamento abaixo).
  2. Camada de storyboard — cartões de cena com visuais, texto na tela, narração, timing, psicologia e notas de movimento. Quando o corte mistura filmagens reais, gravação de tela, gráficos projetados e clipes gerados, marque cada cena com uma dessas quatro fontes e um ID de slot para que um editor possa inserir mídia depois.

Comunicando-se com o usuário

Antes de escrever, defina claramente o formato do lançamento. Pergunte pelas coisas que mudam o roteiro:

  • O que exatamente está sendo lançado (novo produto ou um novo recurso de um existente)?
  • Para quem é isto agora?
  • Onde o vídeo será exibido: hero da home page, página de lançamento, keynote, corte para redes sociais, anúncio pago, loja de aplicativos, atualização para investidores?
  • O que a página ou campanha pode carregar fora do vídeo?
  • Qual é a única ação após assistir: experimentar, saber mais, inscrever-se, agendar demo, assistir keynote, ler docs?
  • Que prova você realmente tem: UI, fluxo de trabalho, resultado, cliente, dado, demo ao vivo, antes/depois?
  • Como a peça deve soar: contida, premium, técnica, divertida, urgente, calma?
  • Proporção(ões) de aspecto: 16:9, 9:16, 1:1? (Decida cedo — isso muda o enquadramento e a colocação do texto.)

Se o usuário lhe entregar uma lista inchada de recursos, questione. Um vídeo de lançamento hero não é o lugar para despejar todo o roadmap. Sugira dividir em um teaser, filme hero, demo mais aprofundada, post de lançamento ou vários módulos.

Se pedirem "estilo Apple" ou "estilo Stripe", traduza isso em estrutura, não imitação. Apple significa realidade mudada imediatamente e módulos de produto limpos. Stripe significa que você pode abrir com apostas de categoria para produtos técnicos, mas precisa de prova concreta quase imediatamente.

Prefira um público e uma CTA principal. Se o lançamento atende a vários públicos, deixe a página lidar com a ramificação.

Se um detalhe ausente mudar a direção criativa, faça até três perguntas. Caso contrário, declare suposições e prossiga.


Etapa 1 - Escolha a arquitetura e framework de lançamento

Decida qual trabalho este vídeo está fazendo, depois escolha um framework que se adapte à sua duração e objetivo.

Trabalho do vídeo (divisão aproximada):

  • Filme de lançamento hero: apresente o caso rapidamente; a página carrega os detalhes.
  • Demo mais aprofundada: percorra o fluxo de trabalho e responda a mais objeções.
  • Teaser: crie intriga; não tente explicar tudo.
  • Segmento de keynote: você pode gastar algumas batidas a mais em apostas, mas cada minuto adicional precisa de um novo módulo de prova.
  • Clipe de lançamento/recurso: uma atualização, um resultado, um encaminhamento para notas ou produto.

Framework por duração e objetivo:

FrameworkMelhor paraDuraçãoEstrutura
Gancho-CTAAnúncios em redes sociais15-30sProblema → Solução → CTA
PASTráfego frio30-90sProblema → Agitação → Solução
AIDADemos de produto / lançamentos de recurso60-120sAtenção → Interesse → Desejo → Ação
O ExplicadorEducação primeiro60-180sContexto → Como funciona → Benefícios → CTA
VSL ClássicoPáginas de vendas3-10minHistória → Problema → Solução → Prova → Oferta → CTA

Diretrizes de duração:

DuraçãoTipoObjetivo
6-15sMicro-conteúdoConscientização, viralidade
15-30sAnúncios em redes sociaisTráfego, interesse
30-60sTeasers de produto/recursoSolicitações de demo, cliques
60-90sExplicadoresEntendimento, tempo de exibição
90-180sDemos completasInscrições para teste
3-10minVídeos de vendas VSLDecisões de compra

Escreva o roteiro para um trabalho. Um vídeo fica enfraquecido quando tenta ser teaser, manifesto, demo completa e fechamento de vendas ao mesmo tempo. Por padrão, opte por algo mais curto do que a equipe deseja — adicione tempo de execução apenas quando a ideia for genuinamente difícil de visualizar ou cada seção adicionada merecer seu lugar com um novo módulo de prova.


Etapa 2 - Escolha o gancho

Os primeiros 3-5 segundos determinam a maior parte da retenção. Abra na realidade mudada, não na autopromoção. Escolha um gancho intencionalmente:

  1. Chegada direta / realidade mudada. Melhor quando a marca já tem atenção. Declare o que está aqui agora ("GPT-5 está aqui").
  2. Dor → alívio. Melhor para produtos de fluxo de trabalho. Nomeie o atrito, depois mostre o produto removendo-o. ("Cansado de [dor]?")
  3. Tensão antes/depois. Melhor quando o contraste é visual e imediato.
  4. Apostas macro → demo concreta. Melhor para infraestrutura, fintech, IA, lançamentos de API. Abra na mudança de categoria, mas converta em uma transação visível, comando ou fluxo de trabalho dentro da primeira batida principal.
  5. Simbólico / metáfora primeiro. Apenas quando o produto ainda não pode ser mostrado ou é muito abstrato. Amarre a metáfora ao produto rapidamente.
  6. Gancho de demonstração / prova social. Mostre um resultado impressionante imediatamente, ou lidere com um número específico ("10.000 equipes já entregam desta forma").

Mantenha a frase de abertura simples. Evite "revolucionário", "transformador" e preenchimentos similares, a menos que a batida seguinte prove a afirmação de forma visível. Teste o gancho independentemente — ele deve funcionar como um anúncio autônomo.


Etapa 3 - Construa a sequência de prova

Organize o meio por módulos de prova, não por ordem de menu de funcionalidades. Para cada módulo, escreva:

  1. Afirmação: o que mudou.
  2. Prova: o plano, momento do fluxo de trabalho, saída, métrica ou demonstração que a torna crível.
  3. Implicação: por que o espectador deve se importar.

Sequencie por tarefa ou resultado do usuário. Um fluxo de trabalho realista supera uma lista de verificação de recursos. Dê espaço para cada afirmação principal — um módulo de prova forte supera três fracos. Se o produto for técnico ou pesado em infraestrutura, ganhe especificidade cedo; não fique no nível de marketecture por muito tempo.

Onde os elementos de conversão vão (use apenas quando honesto e apropriado):

  • Prova social inicial (15-25%): construa credibilidade antes de grandes afirmações.
  • Prova de recurso (40-60%): um depoimento ou resultado após cada benefício chave.
  • Prova final (80-90%): focado em resultados, logo antes da CTA.

Ordem de tratamento de objeções: Funciona? (demo + prova) → Funcionará para mim? (casos de uso) → É complicado? (mostre simplicidade) → Vale a pena? (ROI / valor) → E se falhar? (garantia / reversão de risco).

Lidere com transformação, não com recursos. Nomeie a dor antes da solução. Crie urgência através do valor, não escassez falsa — nunca use contagens regressivas falsas ou escassez falsa.


Etapa 4 - Escreva batidas, visuais, ritmo e CTA

Pense em batidas, não em parágrafos. Tipos comuns de batidas: contexto (o que mudou / o que ainda dói), produto (a nova capacidade), prova (ação ao vivo, saída, resultado), lançamento (quem recebe, o que fazer, onde se aprofundar).

Transições devem avançar o argumento, não decorar. Corte seco em uma nova afirmação. Sobreposição ou ponte para continuidade. Desacelere brevemente quando o espectador precisar analisar UI, código ou um resultado.

Gramática visual - mantenha-a restrita: um foco de produto, uma lógica de movimento, uma direção de arte de suporte, um nível de estilização. Mantenha a interface ou prova concreta como heroína. Anime o suficiente para esclarecer e elevar, nunca tanto que o produto entregue pareça decepcionante depois.

Texto na tela faz um de quatro trabalhos: rotular o momento, enquadrar o resultado, direcionar a atenção, pontuar o lançamento. Nunca o use como transcrição da narração. Se o quadro estiver ocupado, simplifique as palavras; se a linha estiver fazendo trabalho explicativo, acalme o quadro. Planeje para visualização sem som (a maioria assiste sem som) — a história deve ser lida apenas com texto/visuais.

Narração (se usada) é escrita em pedaços de pensamento falado. Uma frase deve comprar uma ação visual clara, revelação ou resultado. Tom conversacional sobre UI — prosa de documentação soa rígida quando falada. Deixe momentos importantes respirar.

CTA: mantenha-a simples e voltada para o futuro. Por padrão, use uma CTA após uma sequência de prova concluída ou no final; deixe a página ramificar por público/preços/docs. Mínimo de duas CTAs apenas para VSLs mais longos (um teaser no meio depois que prova suficiente foi estabelecida, mais a final). Seja específico ("Inicie teste gratuito", não "Saiba mais") e remova o atrito ("Sem cartão de crédito" se for verdade). Se a CTA parecer uma interrupção, provavelmente é muito cedo.


Etapa 5 - Produza o storyboard (a entrega)

Converta o roteiro em um documento com estas seções. Seja concreto sobre o que o espectador deve entender e por que a cena existe. Deixe a execução quadro a quadro para o motion designer ou editor. Se a produção precisar de um handoff, termine com quatro listas: filmagens a gravar, prompts de clipes gerados, cenas projetadas e gravações de tela a capturar.

1. Cabeçalho do roteiro

# [Título do Vídeo]

**Tipo**: [Filme de lançamento / Reel de recurso / Explicador / Demo de Produto / Anúncio Social / VSL]
**Duração**: [Total em segundos]
**Proporção de aspecto**: [16:9 / 9:16 / 1:1]
**Objetivo**: [Objetivo principal de conversão]
**Público-alvo**: [Persona específica]
**Framework**: [AIDA / PAS / Gancho-CTA / Explicador / VSL]
**Escolha do gancho**: [Qual gancho e por quê]

## Mensagem chave
[Uma frase: o que os espectadores devem lembrar?]

## Ação desejada
[CTA específica: o que os espectadores devem fazer?]

2. Arco da história + jornada emocional

## Arco da história
Gancho (0-Xs): [Como capturamos a atenção]
Construção (Xs-Ys): [Como construímos interesse/desejo]
Pico (Ys-Zs): [Clímax / proposta de valor principal]
Fechamento (Zs-Fim): [CTA e resolução]

## Jornada emocional
Início: [Frustrado / Curioso / Sobrecarregado]
→ Meio: [Esperançoso / Intrigado]
→ Fim: [Confiante / Animado para agir]

3. Storyboard cena por cena

Escreva um cartão por cena:

## Cena N: [Nome da Cena] (Xs-Ys, Duração: Zs)

**Propósito narrativo**: [Por que esta cena existe - avança a história E a conversão]

**Texto na tela**:
"[Texto exato na tela]"

**Narração** (opcional):
"[Palavras exatas faladas]"

**Descrição visual**:
[O que os espectadores veem - específico o suficiente para construir, não para especificar em excesso]
- Fundo / ambiente
- Ponto focal principal (geralmente o produto/prova)
- Visuais de suporte
- Tratamento do texto

**Psicologia do espectador**:
[Estado emocional que criamos · objeção tratada (se houver) · desejo construído]

**Elementos de prova/vendas**:
[Mapeamento afirmação→prova · prova social · reversão de risco · ênfase no benefício - apenas se honesto]

**Transição para a próxima**:
[Como isso flui adiante e por que avança o argumento]

**Notas para o motion designer**:
[Ritmo (rápido/lento), estilo (ousado/sutil), momentos chave a enfatizar, no que segurar]

4. Requisitos de produção

## Ativos necessários
- [ ] Arquivos de logotipo
- [ ] Capturas de tela / mockups / gravações de tela do produto
- [ ] Fotos ou citações de clientes (se usando depoimentos)
- [ ] Elementos de visualização de dados, ícones
- [ ] Direção de música / VO

## Elementos de texto
- Manchetes / subtítulos (liste todos)
- CTAs (liste cada instância)
- Citações de prova social (liste todas, com fonte)

## Diretrizes de marca
- Voz: [Profissional / Casual / Técnica / Amigável]
- Tom: [Contido / Premium / Urgente / Calmo / Empolgante]
- Restrições: [Regras de texto ou visuais, inegociáveis vs. bom ter]

Mantenha as linhas de narração faláveis, o texto na tela curto e a direção visual concreta. Marque métricas inventadas ou nomes de demo como placeholders. Forneça direção visual, não especificações técnicas - deixe a execução quadro a quadro para o motion designer.


Teste o roteiro e storyboard antes da entrega

Clareza e prova:

  • A primeira batida torna a nova realidade clara?
  • Cada afirmação principal recebe prova visível?
  • Um espectador cético conseguiria explicar o que mudou após uma exibição?
  • O meio é organizado por fluxo de trabalho/resultado, não por despejo de recursos?
  • Se você removesse o logotipo da marca, a prova ainda pareceria específica para este produto?

Ritmo e densidade do texto (leia em voz alta):

  • Uma frase tentando cobrir múltiplas ações visuais?
  • Texto na tela repetindo a narração?
  • Grandes afirmações empilhadas em movimento agitado?
  • Nenhuma pausa onde o espectador precisa analisar a interface?
  • Tempo de execução que cresceu sem adicionar prova melhor?
  • Se um momento parecer congestionado, reduza um canal: menos palavras, movimento mais calmo ou menos texto.

Adequação da CTA:

  • O espectador viu prova suficiente antes da CTA?
  • A CTA parece o próximo passo lógico?
  • O filme está tentando segmentar públicos que a página deveria segmentar?

Prontidão para produção:

  • Cada cena tem tempo e duração.
  • As descrições visuais são claras e específicas.
  • Ativos estão listados; notas do motion designer presentes; propósito narrativo declarado por cena.
  • Formato está pronto para entrega sem esclarecimentos.

Se a resposta para qualquer pergunta de clareza for não, o roteiro ainda é muito genérico.


Melhorando um rascunho fraco

Aperte abstração em evidência. Substitua afirmações vagas por uma etapa de fluxo de trabalho, uma saída, um antes/depois visível, um comando real, um artefato concreto, um número com contexto ou um resultado de usuário. "Colaboração poderosa" é fraco. "Revise, comente e entregue do mesmo arquivo" é mais forte. Mostrar isso acontecendo é ainda mais forte.

Corte acúmulo de informações. Não deixe tese macro, narração densa, UI movimentada e muitos rótulos baterem ao mesmo tempo. Escolha o canal principal por batida: se o visual carrega, simplifique a linha; se o conceito é abstrato, acalme o visual e deixe a linha explicar; se o resultado é novo, pause tempo suficiente para registrá-lo.

Divida um filme inchado em vários ativos. Teaser para antecipação · filme hero para o caso principal · demo mais aprofundada para entendimento · página/notas de lançamento para detalhes · cortes para redes sociais/anúncios. Lançamentos repetidos geralmente superam um mega-lançamento superconstruído.


Anti-padrões

Nível de roteiro: abrir com adjetivos em vez de uma realidade mudada · manifesto de marca sem prova · despejo de recursos (cinco recursos, duas s

...

[Cortado para tradução]

}```

[O restante do markdown original foi truncado; a tradução acima preserva a estrutura e o conteúdo conforme fornecido.]

Habilidades Relacionadas