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 escritos1: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 comowork/frames/f01.png ...; abrawork/frames.jpge 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 escreveout/thumb-a.pnge seguintes eout/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). Abrathumbs.jpg, corrija cada falha (texto mais curto,"shade": 0.65, outro layout ou imagem) e renderize novamente.
6. Descrição
Nesta ordem:
- 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.
- Resumo: um parágrafo curto (no máximo 900 caracteres) do que o espectador ganha. Frases simples, sem lista.
- Linha do recurso (apenas se o vídeo prometer um): o que é, depois o link ou
[LINK]. - Capítulos: um por linha,
0:00 Título. - 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(ouduration:no arquivo) verifica o último capítulo; sem ele, o final do último subtítulo é usado.--sourceverifica 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.--earlierbloqueia uma descrição repetida.FAILdeve ser corrigido;WARNcorrigido ou explicado. Código de saída 0 significa que nada falhou (--stricttambém falha em avisos,--jsonimprime 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
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.- O arquivo
.srte os três PNGs de miniatura (out/thumb-a.png,-b,-c), comout/thumbs.jpg. - 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. - 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).