CommunityEscrita e Ediçãogithub.com

youtube-packaging

Transforme um vídeo finalizado, script ou transcrição em um pacote completo de upload, com cada parte verificada por código. 3 opções de título, uma descrição com capítulos que o YouTube aceita (começando em 0:00, três ou mais, nenhum com menos de 10 segundos), um comentário fixado que faz uma pergunta, um arquivo de legenda SRT com comprimentos de linha limpos e 3 miniaturas finalizadas (1280x720 PNGs dos próprios quadros do vídeo, seis layouts, verificadas quanto a contraste e legibilidade em tamanho de telefone, feitas para 'Testar e comparar' do YouTube). Use quando o usuário disser 'escreva meu título e descrição', 'descrição do YouTube com capítulos', 'faça capítulos', 'marcações de tempo para meu vídeo', 'faça um SRT', 'legendas a partir desta transcrição', 'comentário fixado', 'faça minha miniatura', 'miniatura para este vídeo', 'texto da miniatura', 'empacote este vídeo', 'deixe isso pronto para upload' ou tiver um vídeo finalizado, script de longa duração, transcrição ou marcações de tempo de palavras para publicar.

O que é youtube-packaging?

O YouTube Packaging Skill automatiza a criação de um pacote completo de upload para o YouTube a partir de um vídeo finalizado, script ou transcrição. Ele gera três opções de título com ângulos diferentes (resultado, problema, curiosidade), uma descrição com capítulos seguindo as regras do YouTube (começando em 0:00, três ou mais, nenhum com menos de 10 segundos), um comentário fixado que faz uma pergunta, um arquivo de legenda SRT com comprimentos de linha limpos e três miniaturas finalizadas (1280x720 PNGs) com seis layouts diferentes, todas verificadas quanto a contraste e legibilidade em tamanho de telefone para uso com o recurso 'Testar e comparar' do YouTube. Útil para criadores de conteúdo que precisam de um pacote consistente, otimizado e verificado por código sem esforço manual repetitivo. Funciona no Claude Code, Cursor e Codex. O skill usa scripts Python (Pillow, numpy, Playwright, ffmpeg) para geração e verificação de miniaturas, e ferramentas de linha de comando para validação de pacotes, garantindo que títulos, descrições, legendas e miniaturas atendam às melhores práticas da plataforma e sejam visualmente atraentes e acessíveis.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gabrielebolognese/youtube-packaging/tree/HEAD/skills/youtube-packaging

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

YouTube packaging

Transforme o script ou a transcrição de um vídeo finalizado em tudo o que o upload precisa: títulos, descrição com capítulos, comentário fixado, legendas e três miniaturas. Qualquer nicho, qualquer duração (feito para conteúdo longo, também funciona para vídeos mais curtos).

Os scripts estão na pasta scripts/ ao lado deste SKILL.md. Execute-os com python (3.10 ou mais recente) usando o caminho absoluto dessa pasta. check_package.py e make_srt.py não precisam de mais nada; as miniaturas (thumbs.py) precisam de Pillow, numpy e Playwright com Chromium (python -m pip install pillow numpy playwright depois python -m playwright install chromium) e ffmpeg quando os quadros vêm de um arquivo de vídeo.

1. Reúna as entradas

  • As palavras do vídeo, de preferência primeiro: marcações de tempo de palavras como JSON (de uma ferramenta de transcrição com timestamps de palavras), uma transcrição com timestamps (linhas 0:12 texto, uma transcrição copiada do YouTube, um SRT ou VTT), ou apenas o script (então cada tempo é uma estimativa; diga isso).
  • A duração final do vídeo (para o último capítulo e as legendas).
  • Um recurso ou link que o vídeo promete, se houver. Sem o link real, escreva [LINK] para o usuário preencher.
  • Opcional: descrições anteriores do canal (para que a nova não as repita), o título ou ideia de miniatura de trabalho, o público.

2. Leia o vídeo primeiro

Leia todo o script ou transcrição e observe: a promessa feita nos primeiros 30 segundos, a principal conquista, as seções e onde cada uma começa, os números concretos que o vídeo diz, o momento mais surpreendente. Cada título, texto de miniatura e linha de descrição deve corresponder ao que o vídeo realmente entrega.

3. Capítulos

  • Um capítulo por seção; seu tempo é a primeira palavra falada dessa seção. Com marcações de tempo de palavras ou uma transcrição com timestamps, encontre as primeiras palavras de cada seção. Com apenas um script, estime (palavras antes da seção / palavras por minuto) e marque os tempos como estimativas para corrigir após a edição.
  • Regras do YouTube: a lista começa em 0:00 (o gancho pertence a esse capítulo), tem três ou mais capítulos, nenhum com menos de 10 segundos, em ordem de tempo, tempos a partir de uma hora escritos 1:05:00. Um capítulo com menos de 10 segundos é mesclado ao vizinho.
  • Um título de capítulo diz o que a seção cobre ou pergunta, não o que conclui ("O erro de regar", não "Pare de regar diariamente"); 2 a 6 palavras; sem travessão.

4. Títulos (3 opções)

  • Cada opção adota um ângulo diferente: o resultado, o problema ou erro, a lacuna de curiosidade ou contraste. Coloque as palavras que um espectador pesquisaria no início.
  • No máximo 60 caracteres (o YouTube permite 100, mas títulos mais longos são cortados em telefones e na pesquisa).
  • Os primeiros 30 segundos do vídeo devem confirmar a promessa do título; um título que a abertura não sustenta perde espectadores nos primeiros segundos.
  • Números apenas quando o vídeo os diz. Sem hashtags, links, palavras de hype ou mais de duas palavras em maiúsculas.

5. Miniaturas (3 imagens finalizadas)

  • Os textos: no máximo 5 palavras, legíveis em tamanho de telefone. A miniatura adiciona ao título em vez de repeti-lo: juntos eles contam a história (título: a promessa; miniatura: as apostas, o resultado, a reviravolta). Números apenas do vídeo.
  • As imagens: python <pasta-do-skill>/scripts/thumbs.py frames VIDEO_OU_PASTA_DE_IMAGENS work/ mantém os quadros mais nítidos e diferentes como work/frames/f01.png ...; abra work/frames.jpg e escolha o quadro que mostra o resultado (um rosto reagindo, o resultado, o antes e depois). Sem vídeo? Use as próprias imagens ou capturas de tela do usuário em uma pasta; nunca a foto de um estranho.
  • Escreva work/thumbs.json: três variantes que diferem em UMA coisa (o texto, a imagem ou o layout), para que o "Testar e comparar" do YouTube mostre qual funciona. Seis layouts: simple, shock (zoom e anel), big-number, header, comparison (duas imagens), blur (uma revelação). Formato, layouts e opções (foco, palavra de destaque, lado do texto, cores da marca): references/thumbnails.md.
  • Renderize: python <pasta-do-skill>/scripts/thumbs.py render work/thumbs.json out/ [--brand brand.json]. Ele escreve out/thumb-a.png e seguintes e out/thumbs.jpg: cada variante grande, como um bloco inicial do YouTube com o título, e em tamanho de telefone, com suas verificações (1280x720 abaixo de 2 MB, no máximo 5 palavras, letras com pelo menos 54 px de altura e ainda legíveis em tamanho de telefone, o texto dentro do quadro, contraste 4.5:1 contra o que está atrás dele). Abra thumbs.jpg, corrija cada falha (texto mais curto, "shade": 0.65, outro layout ou imagem) e renderize novamente.

6. Descrição

Nesta ordem:

  1. Abertura: 2 linhas, cada uma com no máximo 160 caracteres, mostradas antes de "...mais". Elas dizem a promessa novamente com palavras novas para uma pessoa que ainda está decidindo se clica: não o título uma segunda vez, sem link.
  2. Resumo: um parágrafo curto (no máximo 900 caracteres) do que o espectador ganha. Frases simples, sem lista.
  3. Linha do recurso (apenas se o vídeo prometer um): o que é, depois o link ou [LINK].
  4. Capítulos: um por linha, 0:00 Título.
  5. Opcional: créditos ou links que o criador sempre adiciona.

No máximo 5.000 caracteres no total. Sem hashtags por padrão (os tópicos vão nas tags), sem palavras de hype, sem travessão e não mais de 30 por cento de suas sequências de três palavras compartilhadas com uma descrição anterior.

7. Comentário fixado e tags

  • Comentário fixado: uma pergunta ligada ao problema central do vídeo ou ao próximo passo do espectador, fácil de responder em uma palavra ou uma linha. No máximo 200 caracteres, sem link.
  • Tags (opcional): 3 ou mais, no máximo 500 caracteres no total, sem # e sem vírgula dentro de uma tag.

8. Legendas

python <pasta-do-skill>/scripts/make_srt.py words.json -o video.srt                   # marcações de tempo de palavras
python <pasta-do-skill>/scripts/make_srt.py transcript.txt --end 18:42 -o video.srt   # linhas com timestamps
python <pasta-do-skill>/scripts/make_srt.py --validate video.srt                       # verifica um arquivo existente

Dicas: até duas linhas de 42 caracteres, na tela por 1 a 7 segundos, cortadas em finais de frase primeiro, depois em vírgulas; um número fica com sua unidade e um nome nunca é dividido; sem sobreposição, pelo menos 80 ms entre dicas. Tudo ajustável (--max-chars, --max-lines, --min-dur, --max-dur, --gap-ms). O relatório vai para stderr; saída 0 significa que o arquivo está limpo. Linhas com timestamps sem pontuação (legendas automáticas brutas) são cortadas apenas por comprimento e pausas: pontue a transcrição primeiro para obter dicas melhores.

9. Verifique o pacote

Escreva o pacote neste formato Markdown (JSON com as mesmas chaves também funciona: titles, description, pinned_comment, thumbnail_texts, tags, duration):

---
duration: 18:42
---

## Títulos
1. ...
2. ...
3. ...

## Descrição
```
Linha de abertura um.
Linha de abertura dois.

Parágrafo de resumo.

0:00 Primeiro capítulo
...
```

## Comentário fixado
...?

## Texto da miniatura
1. ...
2. ...
3. ...

## Tags
tag um, tag dois, tag três

Depois execute:

python <pasta-do-skill>/scripts/check_package.py package.md --srt video.srt --source transcript.txt
python <pasta-do-skill>/scripts/check_package.py package.md --duration 18:42 --earlier old-desc-1.txt old-desc-2.txt
  • --duration (ou duration: no arquivo) verifica o último capítulo; sem ele, o final do último subtítulo é usado. --source verifica se cada número em um título ou texto de miniatura aparece no vídeo e se a abertura compartilha palavras com cada título. --earlier bloqueia uma descrição repetida.
  • FAIL deve ser corrigido; WARN corrigido ou explicado. Código de saída 0 significa que nada falhou (--strict também falha em avisos, --json imprime resultados legíveis por máquina).
  • Limites e a lista de palavras de hype estão em scripts/package-rules.json; copie-o, mantenha as chaves para alterar, passe --rules my-rules.json (por exemplo "allow_hashtags": true, "title_max": 70).

Corrija cada falha, execute novamente e depois devolva.

10. Devolva

  1. package.md: os três títulos (marque sua escolha e diga por que em uma linha), a descrição pronta para colar, o comentário fixado, os três textos de miniatura, as tags.
  2. O arquivo .srt e os três PNGs de miniatura (out/thumb-a.png, -b, -c), com out/thumbs.jpg.
  3. Etapas de upload: cole a descrição (o YouTube constrói os capítulos a partir de suas linhas de tempo), carregue o SRT como legendas no idioma do vídeo, adicione as três miniaturas em "Testar e comparar", substitua qualquer [LINK], fixe o comentário após a publicação, mantenha os últimos 20 segundos livres para a tela final.
  4. A linha de resultado do verificador e qualquer aviso aceito com sua razão.

Mais detalhes sobre cada regra e por que ela existe: references/packaging-rules.md.

Exemplo prático

examples/transcript.txt é a transcrição com timestamps de um vídeo de 10:06 sobre como cultivar comida em uma pequena varanda; examples/words.json contém as marcações de tempo de palavras para seus primeiros 46 segundos.

python scripts/make_srt.py examples/transcript.txt --end 10:06 -o test-out.srt
python scripts/check_package.py examples/package.md --srt test-out.srt --source examples/transcript.txt

O primeiro imprime fez 149 dicas de 1497 palavras, 0:00.4 a 10:03.0 e srt: ok; o segundo termina com Resultado: 0 falhas, 0 avisos, 11 aprovados. Seus títulos adotam três ângulos (resultado: "Cultive Comida Real em uma Varanda Pequena (Mesmo que as Plantas Te Odeiem)"; método: "O Teste de Sol de Um Dia que Decide o que Sua Varanda Cultiva"; problema: "Por que Plantas de Varanda Morrem, e o Truque do Balde que Conserta"), e seus textos de miniatura ("6 HORAS OU NADA", "REGA-SE SOZINHO", "PARE DE MATAR PLANTAS") cada um adiciona algo que os títulos não dizem. examples/package-weak.json mostra as falhas: um título longo com uma hashtag, capítulos começando em 0:05, um capítulo de 6 segundos, um comentário fixado com link e sem pergunta, um texto de miniatura de 8 palavras (9 falharam).

Habilidades Relacionadas