Communitygithub.com

CrissAlvarezH/roteiro-de-video

Escreva roteiros para vídeos curtos que prendem a atenção do espectador, usando as próprias métricas de vídeo do criador. Use ao escolher a abertura de uma ideia já definida, ao escrever ou ajustar um roteiro antes de gravar (talking-head ou narração explicativa), ou ao transformar insights de um vídeo publicado em lições. Gerar ideias é tarefa do content-ideas.

O que é roteiro-de-video?

Esta skill ajuda criadores de conteúdo a escrever roteiros para vídeos curtos baseados em evidências – principalmente nas métricas de seus próprios vídeos passados. Ela estrutura o roteiro em três momentos críticos: a abertura (0-3 segundos), a segunda frase (3-10 segundos) e a retenção até o payoff final, sempre equilibrando curiosidade e respostas para manter o espectador engajado. A skill suporta revisão de vídeos publicados a partir de capturas de tela da curva de retenção e legendas, além de orientar a criação de roteiros para explicadores e vídeos narrados. Ao final, entrega o roteiro com timestamps, descrição visual, lista de capturas, legenda draft, chamadas alternativas e verificação de fontes contra o roteiro.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

Perguntar na sua IA favorita

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

Documentação

Roteiro de vídeo

Um vídeo curto é decidido antes da gravação por três escolhas: a aposta (quem, além de especialistas, tem um motivo para se importar), as duas primeiras frases (por que continuar assistindo) e a prova (o que o espectador vê que torna a afirmação real). Faça cada escolha com base em evidências: primeiros os vídeos passados do criador, depois declarações da plataforma, por último o gosto pessoal.

O que o espectador busca é a resposta para uma pergunta. A curiosidade o mantém e cada resposta lhe dá um motivo para sair, então um roteiro é um equilíbrio entre os dois: abra uma pergunta cedo e não a feche até que haja outra aberta.

Configuração

SKILL_DIR significa a pasta desta skill. Leia ~/.video-script/profile.md se existir: ele nomeia a biblioteca de vídeos do criador, o arquivo de descobertas, as notas da plataforma, a voz e o ritmo. Antes de propor qualquer coisa, leia o arquivo de descobertas (incluindo testes ainda em andamento) e o índice da biblioteca, e cite os vídeos passados aos quais uma ideia se assemelha. Onde as descobertas conflitarem com um padrão abaixo, as descobertas vencem: elas foram medidas nesta audiência.

Sem perfil, pergunte uma vez pela plataforma, pela audiência e por um vídeo passado que foi bem e outro que não foi, com seus números. Então ofereça-se para criar o perfil e uma biblioteca no formato de biblioteca.

Objetivo significa para que um vídeo é feito: alcance (visualizações de não-seguidores), seguidores, salvamentos ou compartilhamentos. Quando a solicitação não nomear nenhum, presuma alcance e diga isso.

As tarefas aqui são Roteiro e Revisão de um vídeo publicado; ideias vão para content-ideas. Esta skill termina em um roteiro ou uma lição: a gravação é do criador, a edição do video-edit, a animação do animated-video.

Ideias

Gerar ideias e salvá-las é tarefa do content-ideas. Quando um roteiro começa a partir de uma ideia, suas anotações já dizem a abertura, a pergunta que ela abre, o que é retido e a prova: comece por elas e verifique-as contra a fonte antes de confiar.

Roteiro

Enuncie a ideia em uma frase, com seu objetivo. Uma ideia que precisa de duas frases são dois vídeos; pergunte qual fazer primeiro.

Encontre o payoff e a prova mais forte antes da abertura, então escreva a abertura em duas partes: o tópico apresentado como o resultado que esta audiência deseja, nas palavras deles sobre o problema deles, seguido pela afirmação ou prova mais surpreendente que você tem, que abre uma pergunta que o espectador poderia colocar em palavras. Não nomeie o assunto quando nomeá-lo responderia a essa pergunta. Rascunhe no ritmo do criador (do perfil; padrão 3 palavras faladas por segundo). Três momentos estão vinculados ao relógio, e o trecho entre eles segue uma regra; o resto assume a forma natural da história:

  • 0–3 s, a abertura: sobre a aposta do espectador ou o que está na tela. Credenciais vêm depois, como a razão para acreditar; um resultado que o espectador deseja conta como aposta quando abre a pergunta.
  • 3–10 s, a segunda frase: aumenta a aposta da abertura ou afia sua pergunta, sem respondê-la. A maioria das perdas evitáveis ocorre aqui, então o contexto espera. Contexto é tudo que o espectador precisa apenas para acompanhar um detalhe posterior (história, quem é alguém, como algo funciona); o teste: se mover uma linha para depois dos 15 segundos não perde nada nos primeiros 15, é contexto.
  • No meio, a resposta é retida: o payoff não é um momento único. Nomeie a linha que fecha a pergunta da abertura, geralmente um termo que o espectador reconhece: quando a ouvem, pensam que já sabem o resto. Antes dela vai o que leva até lá e vale a pena ouvir por si só: o que a maioria das pessoas erra, o que isso custa a elas, por que as alternativas óbvias falham. Quando finalmente é dita, o mesmo fôlego abre uma nova pergunta, algo sobre ela que não ouviram. Reter significa dar a eles algo mais enquanto isso; uma linha que apenas provoca ou diz "fique até o fim" não é reter, é enchimento.
  • O fim: o payoff final, a promessa da abertura mostrada na tela, então no máximo uma chamada para ação curta. Qualquer coisa após o payoff toca para uma audiência que está saindo.

Para um explicador (como algo funciona), leia explicadores antes de rascunhar.

Ao lado de cada linha, escreva o que o espectador vê e a captura necessária (gravação de tela, documento, a pessoa ou produto real). Uma linha que ninguém poderia desenhar é algo que o espectador precisa segurar na cabeça. Para um filme animado, esta coluna é uma nota para o animated-video, que projeta o mundo.

Entregue e salve onde o perfil diz: o roteiro como tempo, linha falada e imagem na tela; a lista de capturas; uma legenda draft carregando as ressalvas e links que o roteiro falado não pode, cuja abertura levanta a pergunta da abertura em vez de respondê-la; o tempo estimado de execução; aberturas alternativas, cada uma com sua própria segunda frase, quando a abertura ainda está aberta; e as afirmações a verificar, com fontes (sinalize qualquer fonte que você não conseguiu abrir). Peça a um agente novo para verificar cada afirmação como redigida no roteiro contra sua fonte: pesquisa correta pode ainda ser exagerada no roteiro.

Quando o criador reescrever algumas linhas, carregue as diferenças estilísticas para as linhas que você ainda possui. Mantenha a redação deles a menos que peçam para editá-la e levante problemas factuais nela separadamente.

Checklist

Compare o roteiro com estes itens, o arquivo de descobertas e as notas da plataforma antes de entregá-lo:

  • Uma ideia. Uma lista merece seu lugar apenas quando cada item prova essa ideia.
  • A aposta é enquadrada por quem afeta e o que eles querem, em palavras que um não-especialista conhece. Nomes de ferramentas e jargão vêm depois que o espectador tem um motivo para se importar.
  • Leia como o espectador: a cada linha, pergunte se você sentiria que já sabe a resposta e sairia. Se sim antes do ponto planejado, mova a linha ou abra a próxima pergunta ali. Diga o que fecha a pergunta da abertura e quando.
  • Toda afirmação é mostrada. Voz, legenda e tela dão o mesmo número.
  • Toda promessa na abertura é paga na tela.
  • Toda frase, lida por si só, diz quem faz o que para o quê, e onde qualquer resultado vai. Substitua objetos omitidos e referências ambíguas pelo substantivo; mantenha pronomes cujo referente está claro. Revisões quebram isso, então verifique novamente após cada uma.
  • Linhas são frases completas e conectadas na voz do criador (o guia de voz que o perfil nomeia), fáceis de dizer em voz alta. Uma linha cortada tão curta que levanta uma pergunta ("a rota completa" de quê?) custa mais do que os segundos que economiza.
  • Cada linha move a história para frente (uma linha que repete a anterior ou anuncia o que vem não move), e o tempo de execução é tão curto quanto a história permite.

Revisar um vídeo publicado

  • Registre cada número: visualizações, espectadores, tempo médio de exibição, seguidores, contagens de interação, cada taxa com seu rótulo, visualizações por fonte, e a curva de retenção com sua duração (lendo insights). A partir de uma captura de tela, leia a curva com python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SECONDS e verifique sua média baseada em área contra o valor do aplicativo. Identifique o vídeo de cada captura de tela por sua miniatura, datas do gráfico e contagem de visualizações; pergunte quando essa evidência não pode decidir.
  • Alinhe a curva com as legendas da renderização final: para cada queda e platô, registre o que foi dito e mostrado nos segundos anteriores. Compare com a biblioteca: vídeos no mesmo formato, e a queda de 3→10 s de cada vídeo.
  • Nomeie a próxima versão quando houver uma que vale a pena fazer: a menor mudança que aborda o que você encontrou, como uma nova abertura ou um corte onde as pessoas saíram, ou o que um vídeo que superou os outros fez de diferente e como repetir.
  • Escreva a entrada da biblioteca do vídeo e a linha do índice, então atualize o arquivo de descobertas: adicione a evidência a cada hipótese que ela toca e mude um status apenas quando dois ou mais vídeos concordarem. Antes de salvar, pegue cada linha e tempo citados do arquivo de legendas, não de um resumo; forneça uma data de postagem apenas com sua fonte; verifique cada palavra de classificação (mais alto, mais baixo, único, melhor) contra o índice, escopado para os vídeos que cobre.

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

Habilidades Relacionadas