agentleFS
joaoguirunasjoaoguirunas/team-os/.claude/skills/youtube-packaging/SKILL.md

youtube-packaging

Skill6 starsChanged 2 days agoMITView on GitHub

Método do pacote de vídeo do YouTube — título (máx. 100, ideal 60–70), texto de thumb (≤5 palavras, 1280×720), descrição (máx. 5000, 125 visíveis), capítulos do corte final a partir de 00:00 (≥3), tags (≤30 e ≤500 caracteres), categoryId, idioma e 2–3 variantes para A/B. Use ao montar, revisar ou aprovar o pacote de um vídeo antes do upload.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

YouTube Packaging — título, thumb e descrição como um pacote só

O espectador decide em um segundo, olhando thumb + título juntos. Pacote bom não repete a mesma frase nos dois: a thumb mostra, o título explica, a descrição confirma. E todo o pacote promete só o que o vídeo entrega.

Usada por: youtube-content (escreve), youtube-strategist (julga), youtube-publisher (valida antes do upload).

1. Limites (validar antes de entregar)

CampoLimiteIdeal / regra do método
Título100 caracteres60–70; palavra-chave nos primeiros ~40
Descrição5.000 caracteres125 primeiros autoexplicativos (é o que aparece na busca e antes do "mais")
Tagsaté 30 tags e 500 caracteres somadostrabalhar com folga (~450); sem #, sem aspas, sem duplicata
Thumb1280×720 (16:9), largura mínima 640≤5 palavras; legível em tamanho de celular; arquivo dentro do limite do Studio (conferir)
categoryIdnúmero da categoria27 Educação, 28 Ciência e Tecnologia, 26 Guias e Estilo, 22 Pessoas e Blogs, 24 Entretenimento
IdiomadefaultLanguage e defaultAudioLanguagept-BR para canal brasileiro
Capítuloscomeçam em 00:00, ≥3, cada um ≥10 ssó do corte final

Remover caracteres de controle e quebras estranhas de título e tags. Limites mudam: se updated desta skill tiver mais de 6 meses, conferir na Central de Ajuda do YouTube antes de bloquear entrega.

2. Título

  • Promessa clara, específica, que o vídeo paga (o gancho de /youtube-scriptwriting confirma o título)
  • Palavra-chave de busca no começo quando o vídeo é de busca; curiosidade quando é de navegação/sugestão — declare qual
  • Número só se for real e estiver na lista de claims
  • Sem CAIXA ALTA inteira, sem "(CHOCANTE)", sem promessa que o vídeo não cumpre
  • Ano no título só se o conteúdo envelhece de verdade

3. Thumb (brief para o estúdio)

O texto e a ideia são seus; a arte é do social-design / social-photo, sob brief.

  • ≤5 palavras, complementar ao título (nunca a mesma frase)
  • Um foco visual (rosto com emoção real, objeto, antes/depois, resultado)
  • Contraste legível em miniatura; sem texto na zona do carimbo de duração (canto inferior direito)
  • Nada que não está no vídeo (cena, pessoa, resultado)
  • Imagem gerada por IA na thumb entra na avaliação de mídia sintética (/youtube-publishing)

Brief:

Thumb {id} — variante A
Texto (≤5 palavras): …
Foco visual: …
Emoção/tensão: …
Relação com o título: complementa {como}
Proibido: …

4. Descrição

Estrutura:

  1. 125 primeiros caracteres: o que a pessoa ganha assistindo, com a palavra-chave. Sem link, sem "neste vídeo"
  2. 2–4 linhas de contexto (para quem é, o que tem de original)
  3. Capítulos (do corte final)
  4. Fontes dos claims citados (link da fonte primária)
  5. Links úteis (material, vídeo relacionado, playlist) — só os que existem
  6. Divulgação obrigatória quando houver: patrocínio, link de afiliado, mídia sintética relevante
  7. 0–3 hashtags no fim (as primeiras aparecem acima do título)

5. Capítulos

  • Gerados a partir do arquivo final exportado — nunca do roteiro (a edição muda a minutagem)
  • Primeiro capítulo em 00:00; mínimo 3; cada um com pelo menos 10 s
  • Rótulo = o que a pessoa encontra ali ("Configurando o webhook"), não "Parte 2"
  • Os rótulos devem bater com as cenas do roteiro (a retenção por cena usa esses nomes)
00:00 O erro que trava 90% das automações   ← só se o 90% estiver na lista de claims
00:42 O que você precisa antes de começar
02:15 Passo 1 — conectar a conta

6. Tags

  • Complemento, não estratégia: título e descrição pesam mais
  • Ordem: termo principal → variações → erros de digitação comuns → termo do nicho
  • Sem tags de outros canais/marcas sem relação (enganoso)

7. Variantes para A/B (2–3)

  • Variar uma coisa por variante (só o título, ou só a thumb, ou o par inteiro com hipótese única)
  • Cada variante com hipótese escrita: "B troca promessa por curiosidade porque {motivo}"
  • Todas passam pelo gate — variante não aprovada não entra no teste
  • Quem conduz e julga o teste é a youtube-publisher (/youtube-analytics, z ≥1,96); troca ao vivo só com confirmação do usuário

8. Formato de entrega

social-media/youtube/{id}/pacote.md:

## Pacote — vídeo {id} — corte final: {arquivo} ({duração})
Tipo de descoberta: busca | navegação/sugestão
Título A (n caracteres): …
Título B (n caracteres): …
Thumb A: texto … | brief: …
Thumb B: texto … | brief: …
Descrição: (texto completo, 125 iniciais marcados)
Capítulos: (do corte final)
Tags (n tags / n caracteres): …
categoryId: 27 | defaultLanguage: pt-BR | defaultAudioLanguage: pt-BR
Claims citados na descrição: #1, #4 (ver claims.md)

9. Checklist do gate

  • Título ≤100 (ideal 60–70) e pago pelo vídeo
  • Thumb ≤5 palavras, 1280×720, complementar ao título, nada que não está no vídeo
  • 125 primeiros caracteres autoexplicativos; descrição ≤5000
  • Capítulos do corte final, 00:00, ≥3, ≥10 s cada
  • Tags ≤30 e ≤500 caracteres; sem duplicata
  • categoryId numérico e idiomas preenchidos
  • Todo número do pacote está na lista de claims com fonte
  • 2–3 variantes com hipótese, todas aprovadas

Método adaptado de darkzOGx/youtube-automation-agent (MIT) — limites de metadados, descrição com 125 visíveis e capítulos; reescrito para o fluxo de squad.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.