Communitygithub.com

ai-video-script

Escreve a narração e o storyboard para um vídeo curto: roteiro falado com revisão de três passos para remover o sabor de IA, lista de planos, grade de batidas e film.json como a única fonte da verdade. Executa após ai-video-brief, antes da renderização.

O que é ai-video-script?

O skill ai-video-script é especializado em criar roteiros e storyboards para vídeos curtos, funcionando como uma etapa intermediária entre a definição do briefing (ai-video-brief) e a renderização final. Ele gera quatro artefatos principais: script.md (narração com timing e notas de revisão), storyboard.md (tabela de planos), beat-grid.json (batidas musicais) e film.json (a única fonte da verdade que centraliza todas as informações). O processo começa com a escrita da narração como texto falado, seguido por uma revisão de três passos que elimina clichês de IA, verifica sobreposição com textos fonte e garante que o roteiro soe natural quando lido em voz alta. Em seguida, constrói o storyboard com regras precisas de duração de planos (1,5 a 5 segundos), mudanças visuais a cada 2-3 segundos, movimentação de câmera e elementos de cena, e define uma grade de batidas sincronizada com a música. O skill foi projetado para ambientes de desenvolvimento de agentes de IA como Claude Code, Cursor ou Codex, onde é invocado após o briefing e antes da renderização, garantindo que cada mudança seja feita primeiro no film.json e depois propagada para os demais arquivos.

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

Perguntar na sua IA favorita

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

Documentação

ai-video-script: 口播与分镜

Quando usar

O briefing está bloqueado e o usuário escolheu um ângulo narrativo. Este skill escreve o roteiro falado, a lista de planos, a grade de batidas e film.json. Não inicie a renderização antes desses arquivos existirem.

1. Escreva o roteiro primeiro

  • Escreva a narração como texto falado, não como prosa escrita. Leia cada linha em voz alta na sua cabeça: se uma frase não puder ser dita em uma respiração, divida-a.
  • Estime a duração em cerca de 4,5 caracteres chineses por segundo apenas para planejamento. O tempo final sempre vem da duração real da narração, nunca da estimativa.
  • Regra de duração do plano: cada plano leva o máximo entre tempo de ação, tempo de leitura e estimativa de narração, mais uma pausa. A duração total do filme é a soma de todos os quadros do plano. Nunca estique o áudio para caber em um plano.

2. Revisão de três passos para remover o sabor de IA

Execute todos os três passos no roteiro antes de ir para o storyboard. Mantenha as notas de revisão em script.md.

  • Passo 1, cortar clichês de IA: remova frases feitas, intensificadores vazios e frases que não dizem nada com muitas palavras. Cada frase deve carregar um fato, imagem ou ação concreta.
  • Passo 2, verificação de sobreposição: se o roteiro adapta um texto fonte, as palavras reais compartilhadas com a fonte devem ser no máximo 15 por cento, sem 8 caracteres consecutivos idênticos. Reescreva, não parafraseie nas bordas.
  • Passo 3, verificação de leitura em voz alta: o roteiro deve soar como uma pessoa falando, não como um ensaio. Corte construções apenas escritas e frases que só funcionam no papel.

3. Construa o storyboard

Use templates/storyboard.md. Regras:

  • Um plano dura de 1,5 a 5 segundos e mostra exatamente uma coisa.
  • Uma mudança visível a cada 2 a 3 segundos: entrada, ação principal, ação secundária, saída ou transição.
  • Abra os primeiros 3 segundos com uma cena pequena e concreta, não um cartão de título. Um exemplo concreto percorre todo o filme.
  • Cada linha do plano tem: número, intervalo de tempo, imagem, ação, movimento de câmera, texto na tela (no máximo 8 caracteres), método.
  • Escolha 2 palavras de destaque fixas para todo o filme, mais 3 a 8 palavras de ênfase em legendas. Use-as consistentemente.
  • Alterne A-roll e B-roll pelo menos uma vez a cada 8 a 12 segundos.
  • Nomeie o elemento principal, os elementos de suporte e o fundo para cada plano. O elemento principal move-se primeiro e mais; os elementos de suporte seguem 2 a 5 quadros depois com movimento menor.
  • Dê a cada grande ação seis fases: preparar, esticar, impacto, achatar, ultrapassar, estabilizar.
  • Mantenha uma direção principal de luz para todo o filme, com realces e sombras de contato seguindo a ação.

4. Grade de batidas

Música primeiro: escolha a faixa, defina seu BPM, escreva templates/beat-grid.json com timestamps e marcas de batida forte/fraca. Coloque ações pesadas e cortes em batidas fortes. Mova efeitos sonoros do próprio movimento. Use curvas de ease-in-out; nenhum movimento linear, exceto movimento mecânico deliberado.

5. film.json é a única fonte da verdade

Escreva templates/film.json: título, formato, fps, duração, estilo, voz e a lista de planos com tempos de início/fim, imagem, narração, texto na tela e método. Cada etapa posterior (renderização, narração, revisão) lê este arquivo. Se o roteiro mudar, atualize film.json primeiro, depois derive o resto novamente.

Contrato de saída

  • script.md (narração + timing + notas de revisão de três passos).
  • storyboard.md (tabela de planos).
  • beat-grid.json (BPM + batidas fortes/fracas).
  • film.json (única fonte da verdade).

Regras

  • Não escreva código de renderização neste skill. Apenas texto e timing.
  • Um plano que não pode ser descrito em uma linha da tabela são dois planos; divida-o.
  • Fatos incertos permanecem marcados como "a verificar" até serem verificados; nunca os suavize com palavras confiantes.

Individual skills in this repo

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

Habilidades Relacionadas