Communitygithub.com

utillayer/youtube-agent-skill

Escreva e valide o título e a miniatura de um vídeo do YouTube como uma unidade, verificando truncamento, duplicação e falta de clareza antes da publicação. Use para 'ideias de título', 'como devo chamar isso', 'texto da miniatura', 'meu CTR está baixo', embalagem, ou qualquer solicitação para renomear ou reembalar um vídeo existente.

O que é youtube-agent-skill?

Esta habilidade ajuda criadores de conteúdo a criarem títulos e miniaturas para vídeos do YouTube que funcionam juntos como uma unidade coesa, evitando erros comuns como repetição, truncamento e falta de clareza. Ela é especialmente útil para otimizar a taxa de cliques (CTR) e melhorar o apelo visual do vídeo nas telas de busca e feeds. Suportada em plataformas como Claude Code (com expansão da variável `${CLAUDE_SKILL_DIR}`) e em outras ferramentas onde o diretório é acessível, a skill utiliza um script Python (`title.py`) para analisar títulos e miniaturas. A habilidade também inclui um perfil de voz personalizável (voice.md) e recomenda a geração de dez opções para selecionar as duas melhores, permitindo testes A/B no YouTube Studio para decisões baseadas em dados.

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

Perguntar na sua IA favorita

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

Documentação

yt-package

O título e a miniatura são UMA única unidade. Escrevê-los separadamente é o motivo pelo qual a maioria das embalagens falha: a miniatura repete o título, e metade da superfície de clique diz a mesma coisa duas vezes.

python3 ${CLAUDE_SKILL_DIR}/title.py --title "..." --thumb "AI RAN IT"
python3 ${CLAUDE_SKILL_DIR}/title.py titles.txt --thumb "AI RAN IT"   # um por linha, classificados

As ferramentas estão na pasta desta habilidade. ${CLAUDE_SKILL_DIR} é essa pasta no Claude Code; em qualquer lugar onde não seja expandida (claude.ai, Codex), use a pasta de onde este SKILL.md foi carregado.

Antes de escrever

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

Regras que a ferramenta impõe, e por quê

  • Cerca de 60 caracteres sobrevive na busca do desktop, cerca de 40 no feed inicial do celular. O YouTube não publica nenhum desses números - o truncamento é por largura de pixel e varia por superfície - então trate-os como o lado seguro de uma imprecisão, não como uma regra. Ambos são reportados porque falham de forma diferente: um corte no desktop perde o final, um corte no celular pode perder o assunto. 100 é o limite rígido, e < > não são permitidos.
  • A miniatura não deve repetir o título. Palavras diferentes, mesma promessa.
  • No máximo três palavras na miniatura. No tamanho do feed, uma quarta palavra é um borrão cinza.
  • Um número, um nome ou uma data supera qualquer adjetivo disponível para você.
  • Duas palavras em maiúsculas é o limite antes que um título pareça spam.

Escreva dez, mantenha duas

Gere dez títulos, execute todos através de title.py, mostre ao usuário os três primeiros com suas pontuações e o problema específico de cada um. Para o vencedor, escreva o resumo da miniatura: a expressão, o enquadramento, as três palavras, e o que o fundo precisa fazer para manter contraste no tamanho do feed.

Então deixe o YouTube decidir

O Studio pode testar A/B até três títulos, três miniaturas, ou ambos, e escolhe com base no tempo de exibição. Ele funciona no Studio do desktop, precisa de recursos avançados ativados, leva até duas semanas, e não funciona com Shorts. Se os dois primeiros estiverem próximos, diga isso e entregue ambos para um teste, em vez de fingir que o linter consegue diferenciá-los. A pontuação é uma verificação, não uma previsão.

A porta

Nada aqui publica. Esta habilidade escreve e você publica. Cada saída termina em um bloco que o usuário copia, e a última linha de cada execução é a pergunta: vai publicar, ou mudar?

Individual skills in this repo

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

Habilidades Relacionadas