CommunityEscrita e Ediçãogithub.com

cubxxw/youtube-script-writer

Escreva um roteiro de alta retenção para YouTube — explicativo, tutorial, videoensaio, resenha ou apresentação direta — seguindo a estrutura de embalagem, abertura fria, pilha de valor e retenção que mantém o tempo de exibição além dos pontos de abandono. Use quando for solicitado a escrever um roteiro para YouTube, roteirizar um vídeo longo ou explicativo, rascunhar um gancho de vídeo, esboçar um videoensaio ou transformar uma postagem de blog ou palestra em vídeo. Produz conceitos de título e miniatura, múltiplas opções de gancho, um corpo passo a passo com dispositivos de retenção e um encerramento com chamada para ação.

O que é youtube-script-writer?

Esta skill para agentes de IA (como Claude Code, Cursor, Codex) foi projetada para criadores de conteúdo que desejam produzir roteiros de YouTube com alta retenção de audiência, otimizados para o algoritmo da plataforma. Ela transforma ideias brutas, artigos ou transcrições em roteiros prontos para gravação, com indicações visuais claras, marcadores de ritmo e direções de áudio. A skill é útil porque segue uma estrutura comprovada de retenção (gancho, re-gancho, capítulos, pico de valor e transição suave para CTA), evitando os erros comuns que fazem os espectadores abandonarem o vídeo. Ela suporta qualquer plataforma onde roteiros de YouTube são criados, e seu funcionamento é baseado em um modelo de saída que inclui 3 opções de título e miniatura, 3 variações de gancho, uma tabela de roteiro principal com dicas de áudio e vídeo, e metadados otimizados para busca. A skill opera a partir de entradas mínimas (tópico, público-alvo, duração, tom e objetivo principal), preenchendo lacunas com suposições razoáveis marcadas para confirmação.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/cubxxw/agent-kit/tree/HEAD/skills/youtube-script-writer

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

Habilidade de Redação de Roteiro para YouTube

Esta habilidade ajuda criadores a escrever roteiros altamente envolventes, estruturados e visualmente dinâmicos, otimizados para o algoritmo de retenção do YouTube. Ela converte ideias brutas, artigos ou transcrições em um roteiro pronto para gravação, com dicas visuais claras, indicadores de ritmo e direções de áudio.

O que esta habilidade produz

  • 3 Conceitos de Título e Miniatura: Títulos otimizados para CTR que correspondem a diferentes gatilhos psicológicos (curiosidade, orientado a resultados, contrário) combinados com sugestões claras de layout visual da miniatura.
  • 3 Variações de Gancho (0:00 - 0:30): Diferentes formatos de gancho (declaração contrária, configuração de história, interrupção de padrão) que entregam imediatamente a promessa do título.
  • Tabela de Roteiro Otimizada para Retenção: Um roteiro formatado lado a lado ou em bloco, separando dicas de vídeo (B-roll, ângulos de câmera, sobreposições de texto, zooms) e dicas de áudio (diálogo, narração, efeitos sonoros, mudanças de música).
  • Encerramento e Metadados do Vídeo: Um encerramento de vídeo contínuo projetado para evitar a saída do espectador, juntamente com modelos de descrição otimizados para busca e tags relevantes.

Entradas Necessárias

Trabalhe a partir do que for fornecido. Se algum destes itens estiver faltando, ainda assim produza a saída completa: preencha cada lacuna com uma suposição razoável marcada como (assumido, confirme) e liste essas suposições no final. Faça uma pergunta primeiro apenas quando o assunto central em si estiver faltando (não há nada sobre o que escrever).

  • Tópico/Conceito — Sobre o que é o vídeo? (ex.: "Como construí um SaaS em 30 dias")
  • Público-Alvo — Quem está assistindo? (ex.: desenvolvedores iniciantes, estudantes de design)
  • Duração-Alvo — Duração aproximada em minutos (ex.: 5-7 minutos, 10-15 minutos)
  • Tom/Voz do Roteiro — Ex.: enérgico, educacional, narrativo, conversacional, cômico
  • Objetivo Principal — (ex.: conseguir inscrições na newsletter, vender um curso, aumentar a retenção de espectadores)

Modelo de Ritmo e Retenção

Todo roteiro de YouTube deve seguir esta estrutura para evitar o abandono precoce:

  1. O Gancho (0:00 - 0:30): Prometa valor imediato. Sem introduções, sem animação de logotipo e sem saudação genérica ("Ei pessoal, bem-vindos de volta...").
  2. As Apostas / Re-gancho (0:30 - 1:00): Estabeleça por que este tópico é difícil, urgente ou valioso. Apresente o "vilão" (o problema) e o "herói" (a solução).
  3. Capítulos / Marcos (1:00 - marca de 90%): Divida o conteúdo central em 3 a 5 capítulos distintos. Cada capítulo deve ter uma micro-recompensa clara.
  4. Interrupções de Padrão: Sugira mudanças visuais ou de áudio a cada 4-8 segundos. Use quadros com zoom, texto pop-up, transições de B-roll ou efeitos sonoros (whoosh, ding, pop) para manter a atenção.
  5. A Recompensa / Clímax (marca de 90% - 95%): Entregue o conselho final ou a revelação final prometida no gancho.
  6. Transição Suave para CTA (marca de 95% - fim): Nunca sinalize o fim com "em conclusão" ou "isso é tudo". Faça a ponte do valor final diretamente para recomendar o próximo vídeo ou uma breve chamada para ação antes que o espectador saia.

Formato de Saída

[Título de Trabalho]

Duração-Alvo: [Duração] | Público: [Público-Alvo] | Tom: [Tom]


1. Otimização de Título e Miniatura

Opções de Título

  1. A Lacuna de Curiosidade: [ex.: "A Verdadeira Razão Pela Qual Seu Código é Lento (Não é Python)"]
  2. O Orientado a Resultados: [ex.: "Como Otimizei Meu Aplicativo para Lidar com 100k Usuários em 1 Hora"]
  3. O Contrário: [ex.: "Pare de Usar React para Projetos Simples"]

Conceitos de Miniatura

  • Conceito 1: [Detalhes visuais, ex.: Close-up do apresentador com rosto preocupado, tela dividida mostrando um banner vermelho enorme de 'Erro' de um lado e uma marca de verificação verde limpa do outro. Sobreposição de texto grande e ousada: "PARE DE FAZER ISSO."]
  • Conceito 2: [Detalhes visuais, ex.: Representação gráfica limpa de um gráfico de carga do servidor disparando para a lua, contrastado com uma linha verde plana. Sobreposição de texto: "100K USUÁRIOS."]

2. Variações de Gancho (Escolha Uma)

Variação 1: O Gancho Contrário

  • Visuais: [Apresentador se aproxima da câmera, olhando diretamente para a lente. Zoom rápido na palavra 'Lento' aparecendo em letras vermelhas e ousadas na tela.]
  • Áudio: "Quase todo desenvolvedor com quem converso culpa Python por seus aplicativos lentos. Mas 90% das vezes, a linguagem não é o problema. O gargalo está, na verdade, dentro de uma única linha de configuração que você provavelmente escreveu ontem."

Variação 2: O Gancho de História

  • Visuais: [Mostre B-roll de um editor exibindo 500 logs de erro piscando. Corte para o apresentador esfregando a testa em frustração.]
  • Áudio: "Na terça-feira passada, às 3 da manhã, nosso banco de dados travou completamente sob carga. Estávamos perdendo $200 a cada minuto que o site ficava fora do ar. Depois de horas vasculhando stack traces, encontramos uma correção tão simples que não acreditei que tínhamos deixado passar."

Variação 3: O Gancho de Interrupção de Padrão

  • Visuais: [Um cronômetro regressivo conta a partir de 5 segundos no centro da tela. Efeito sonoro repentino e alto de 'Ding' quando o cronômetro chega a zero.]
  • Áudio (Narração): "Nos próximos 5 minutos, vou mostrar a você exatamente o ajuste de desempenho que salvou nossa equipe $4.000 em custos mensais de servidor. E não, você não precisa reescrever uma única consulta de banco de dados."

3. O Roteiro Principal

Tempo / CapítuloDicas de Vídeo (B-Roll, Sobreposições, Ângulos de Câmera)Dicas de Áudio (Roteiro Falado, Efeitos Sonoros, Música)
0:30 - 1:00O Re-ganchoMostre gráficos na tela exibindo custos de servidor. Aproxime ligeiramente o zoom no apresentador."A realidade é a seguinte: otimização de banco de dados parece incrivelmente complexa. Mas a maioria dos tutoriais faz você aprender consultas SQL que nunca usará. Hoje, vamos manter isso puramente prático."
1:00 - 3:30Capítulo 1: [Nome do Capítulo][Dica Visual: Transição para captura de tela. Destaque as linhas 12-15 no arquivo de configuração. Adicione destaque do cursor.]"[Diálogo Falado]: Primeiro, vamos abrir o arquivo de configuração padrão. Observe este limite de tamanho de pool específico... [Efeito Sonoro: clique suave]"
3:30 - 6:00Capítulo 2: [Nome do Capítulo][Dica Visual: Corte de volta para o apresentador. Zoom de aproximação no rosto do apresentador para enfatizar o ponto.]"[Diálogo Falado]: Isso nos leva ao próximo passo. Se você definir esse valor muito alto, seu servidor vai congelar. Se for muito baixo, os usuários esperarão para sempre. Aqui está como encontrar o ponto ideal..."
6:00 - 8:30Capítulo 3: [Nome do Capítulo][Dica Visual: B-roll do painel de monitoramento do servidor mostrando uma linha plana se transformando em uma onda saudável.]"[Diálogo Falado]: Depois que aplicamos essa configuração, olhe o que aconteceu com os tempos de resposta. Eles caíram de 800 milissegundos para 45."
8:30 - 9:00A RecompensaMostre tela dividida: tempos de carregamento Antes da Configuração vs Depois da Configuração."Então, ao mudar apenas aquela variável, resolvemos o problema de travamento completamente sem gastar um único dólar em atualizações de hardware."
9:00 - 9:30CTA Suave[Dica Visual: Card na tela aparece apontando para um vídeo relacionado. Sobreposição de texto: 'Assista a seguir: Escalando Bancos de Dados PostgreSQL.']"[Diálogo Falado]: Agora que seu servidor está configurado corretamente, seu próximo gargalo será a indexação do banco de dados. Clique neste vídeo aqui onde explico indexação em menos de 5 minutos..."

4. Metadados Otimizados para Busca

  • Descrição do Vídeo: [Primeiras 3 frases contendo termos-chave para classificação em buscas. Ex.: 'Aprenda como otimizar o desempenho do servidor e evitar travamentos de banco de dados. Este tutorial passo a passo mostra ajustes de configuração de servidor para economizar custos de hospedagem.']
  • Tags Sugeridas: otimização de servidor, configuração de banco de dados, desenvolvimento web, custos de hospedagem, arquitetura de sistemas
  • Link de Chamada para Ação: [Insira o link para a newsletter ou página do produto]

Verificações de Qualidade

  • Cada opção de título tem menos de 60 caracteres para evitar truncamento em dispositivos móveis.
  • Nenhum preenchimento de introdução genérica (ex.: "Bem-vindos de volta ao meu canal," "Não se esqueça de curtir e se inscrever") nos primeiros 60 segundos de qualquer gancho ou seção do roteiro.
  • A direção visual (B-roll, sobreposições de texto, ajustes de zoom) é especificada pelo menos uma vez a cada 10 segundos no roteiro principal.
  • O roteiro faz a transição para a Chamada para Ação imediatamente após a recompensa, sem declarar "em conclusão" ou "obrigado por assistir."
  • As linhas de áudio falado são escritas em linguagem conversacional (frases curtas, pausas naturais, sem jargão acadêmico excessivo).

Anti-Padrões

  • Não escreva parágrafos de diálogo sem dicas visuais acompanhantes. O YouTube é um meio principalmente visual; cada parágrafo de fala precisa de transições visuais.
  • Não apresente patrocinadores, inscrições no canal ou links externos durante o gancho (primeiros 60 segundos).
  • Não crie um único gancho genérico; sempre forneça 3 variações distintas de gancho (Contrário, História, Interrupção de Padrão) para dar flexibilidade ao criador.
  • Não use um encerramento genérico que acione a "rampa de saída do espectador" (ex.: "Isso é tudo para o vídeo de hoje, espero que tenham gostado, vejo vocês na próxima!"). Sugira outro vídeo para manter os espectadores na plataforma.

Exemplos de Frases de Ativação

  • "Escreva um roteiro para YouTube sobre meu sistema de produtividade pessoal."
  • "Ajude-me a roteirizar um vídeo de 10 minutos explicando inflação para estudantes universitários."
  • "Preciso de um esboço e roteiro para YouTube de um tutorial sobre código limpo em Python."
  • "Rascunhe um roteiro de YouTube otimizado para retenção sobre como construir um SaaS em 2026."

Individual skills in this repo

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

Habilidades Relacionadas