Communitygithub.com

nategoldai/youtube-agent

Escreva um roteiro de vídeo do YouTube a partir de uma ideia bruta - opções de gancho de 21 fórmulas, pontuadas, e o roteiro completo com marcas de retenção. Use sempre que o usuário quiser um roteiro de vídeo, um gancho, uma linha de abertura, 'o que devo dizer', 'escreva meu próximo vídeo', ou estiver prestes a gravar sem os primeiros quinze segundos definidos.

O que é youtube-agent?

Esta skill transforma uma ideia simples em um roteiro completo para vídeos do YouTube, otimizado para manter a audiência assistindo até o final. O processo começa com a geração de cinco opções de gancho baseadas em 21 fórmulas comprovadas, que são então pontuadas pelo sistema 'hookscore.py' para selecionar as duas melhores. Em seguida, a skill estrutura o roteiro em cinco partes fundamentais: gancho, virada (0:15-0:45), corpo com marcas visuais, payoff e encerramento, garantindo que os primeiros 15 segundos cumpram três objetivos críticos. A ferramenta respeita o perfil de voz do usuário (armazenado em ~/.claude/youtube/voice.md) e evita inventar números ou fontes, solicitando informações reais quando necessário. Compatível com plataformas como Claude Code e outros agentes de IA, ela entrega os dois melhores ganchos com pontuações, o roteiro completo com marcações visuais, tempo estimado de execução e uma explicação da fórmula escolhida, finalizando sempre com a pergunta: 'Enviar ou alterar?'.

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

Perguntar na sua IA favorita

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

Documentação

yt-script

Transforma uma ideia em um roteiro que as pessoas assistem até o fim.

Existem ferramentas nesta pasta e elas realmente funcionam. Use-as. Não julgue o gancho pelo olho.

python3 hookscore.py hooks.txt              # classifique suas opções de gancho
python3 hookscore.py --hook "uma linha"      # avalie apenas um

Antes de escrever

  1. Leia ~/.claude/youtube/voice.md se ele existir. É o perfil de voz do usuário: como ele fala na câmera, palavras que nunca diz, com quem está falando e o que não vai afirmar. Se estiver faltando, peça três de seus próprios vídeos, leia ou transcreva-os, descubra a voz e escreva o arquivo. Um roteiro na voz errada é pior do que nenhum, porque ele terá que dizê-lo em voz alta.
  2. Nunca invente um número, um resultado ou uma fonte. Se um dado ajudaria e você não o tiver, peça-o ou escreva a linha sem ele.

A estrutura

Os primeiros 15 segundos são todo o trabalho. Eles precisam fazer três coisas ou o vazamento do vídeo: confirmar o que o título prometeu, abrir uma pergunta que o espectador não consegue deixar de lado e mostrar que a recompensa está por vir.

  1. Gancho. Escreva CINCO usando as 21 fórmulas, execute-os com hookscore.py, mantenha os dois melhores e mostre ao usuário ambos com suas pontuações. Nunca entregue apenas um.
  2. A virada (0:15-0:45). Diga o que o vídeo fará, em uma frase, e comece a fazê-lo. Sem introdução do canal, sem "antes de começarmos", sem pedido de inscrição. Essas são a causa mais comum da queda aos 0:30.
  3. O corpo. Uma ideia por batida. Marque cada batida com o que está NA TELA, não apenas o que é dito – uma cabeça falante sem nada para olhar é um podcast.
  4. A recompensa. Entregue o que o gancho prometeu, claramente, e diga que você está entregando: "esse é o prompt, está na descrição".
  5. O fechamento. Um pedido. Não três.

O que devolver

  • os dois melhores ganchos com seus painéis de pontuação
  • o roteiro, batida por batida, com [NA TELA: ...] em cada batida
  • um tempo estimado de duração a 150 palavras por minuto
  • uma linha dizendo qual fórmula o gancho vencedor usou e por que ela se adequa a esta ideia

O portão

Nada disso é publicado. Esta habilidade escreve e você publica. Cada resultado termina com um bloco que o usuário copia, e a última linha de cada execução pergunta: lançar ou alterar?

Individual skills in this repo

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

nategoldai/youtube-agent

>- Review a YouTube channel from top to bottom - packaging, consistency, the first fifteen seconds, and what to fix first. Use for "audit my channel", "why isn't my channel growing", "look at my videos", or a pasted channel URL.

nategoldai/youtube-agent

>- Write replies to YouTube comments in the creator's voice, sorted by which ones are worth answering. Use for "reply to my comments", "deal with the comment section", "someone asked X", or a pasted comment thread.

nategoldai/youtube-agent

>- Turn the transcript of a raw recording into an edit decision list - dead air, filler lines and retakes, with timecodes. Use for "edit this", "cut the dead space", "tighten this video", "I rambled", or any request to shorten footage from a transcript.

nategoldai/youtube-agent

>- Write and check a YouTube video's title and thumbnail as one pair, testing for truncation, repetition and vagueness before it goes live. Use for "title ideas", "what should I call this", "thumbnail text", "my CTR is low", packaging, or any request to rename or repackage an existing video.

nategoldai/youtube-agent

>- Plan a week or a month of YouTube uploads - what to post, when, and in what order, sized to how much time the creator really has. Use for "plan my week", "content calendar", "what should I post", "no idea what to make next".

nategoldai/youtube-agent

>- Read a YouTube Studio audience-retention export, find where viewers really drop off, and say what to change. Use for "why do people stop watching", "my retention is bad", a pasted retention chart or CSV, or "fix my pacing".

nategoldai/youtube-agent

>- Write the description, chapters, tags and search-facing text for a YouTube video, aimed at what a real person would type. Use for "write my description", "add chapters", "timestamps", "tags", "SEO", "help this video get found", or "nobody can find this".

nategoldai/youtube-agent

>- Find the Shorts hiding inside a long video and write them, using the transcript to pick moments that stand on their own. Use for "cut this into shorts", "clip this", "repurpose this video", or "what should I clip".

nategoldai/youtube-agent

>- Find what's really working in the user's niche on YouTube, rank it by how far each video beat its own channel, then name the formula. Use for "what's working right now", "find viral videos in my niche", "why did this blow up", competitor research, or a swipe file.

Habilidades Relacionadas