Paquete de YouTube
Convierte el guión o la transcripción de un video terminado en todo lo necesario para subirlo: títulos, descripción con capítulos, comentario fijado, subtítulos y tres miniaturas. Cualquier nicho, cualquier duración (diseñado para videos largos, funciona también para videos cortos).
Los scripts están en la carpeta scripts/ junto a este SKILL.md. Ejecútalos con python (3.10 o más reciente) usando la ruta absoluta de esa carpeta. check_package.py y make_srt.py no necesitan nada más; las miniaturas (thumbs.py) necesitan Pillow, numpy y Playwright con Chromium (python -m pip install pillow numpy playwright y luego python -m playwright install chromium), y ffmpeg cuando los fotogramas provienen de un archivo de video.
1. Recopila las entradas
- Las palabras del video, mejor si son lo primero: tiempos de palabras como JSON (desde una herramienta de transcripción con marcas de tiempo por palabra), una transcripción con marcas de tiempo (líneas
0:12 texto, una transcripción copiada de YouTube, un SRT o VTT), o solo el guión (entonces cada tiempo es una estimación; indícalo). - La duración final del video (para el último capítulo y los subtítulos).
- Un recurso o enlace que promete el video, si lo hay. Sin el enlace real, escribe
[ENLACE]para que el usuario lo complete. - Opcional: descripciones anteriores del canal (para que la nueva no las repita), el título o idea de miniatura provisional, la audiencia.
2. Lee primero el video
Lee todo el guión o la transcripción y anota: la promesa hecha en los primeros 30 segundos, la recompensa principal, las secciones y dónde empieza cada una, los números concretos que dice el video, el momento más sorprendente. Cada título, texto de miniatura y línea de descripción debe coincidir con lo que el video realmente ofrece.
3. Capítulos
- Un capítulo por sección; su tiempo es la primera palabra hablada de esa sección. Con tiempos de palabras o una transcripción con marcas de tiempo, encuentra las primeras palabras de cada sección. Con solo un guión, estima (palabras antes de la sección / palabras por minuto) y marca los tiempos como estimaciones a corregir después del montaje.
- Reglas de YouTube: la lista comienza en
0:00(el gancho pertenece a ese capítulo), tiene al menos tres capítulos, ninguno de menos de 10 segundos, en orden de tiempo, los tiempos a partir de una hora se escriben1:05:00. Un capítulo de menos de 10 segundos se fusiona con su vecino. - Un título de capítulo dice lo que cubre o pregunta la sección, no lo que concluye ("El error de riego", no "Deja de regar a diario"); de 2 a 6 palabras; sin guión largo.
4. Títulos (3 opciones)
- Cada opción toma un ángulo diferente: el resultado, el problema o error, la brecha de curiosidad o el contraste. Pon las palabras que un espectador buscaría al principio.
- Máximo 60 caracteres (YouTube admite 100, pero los títulos más largos se cortan en móviles y en los resultados de búsqueda).
- Los primeros 30 segundos del video deben confirmar la promesa del título; un título que la introducción no respalda pierde espectadores en los primeros segundos.
- Números solo si el video los dice. Sin hashtags, enlaces, palabras de hype o más de dos palabras en mayúsculas.
5. Miniaturas (3 imágenes finales)
- Los textos: máximo 5 palabras, legibles en tamaño de móvil. La miniatura complementa al título en lugar de repetirlo: juntos cuentan la historia (título: la promesa; miniatura: lo que está en juego, el resultado, el giro). Números solo del video.
- Las imágenes:
python <carpeta-del-skill>/scripts/thumbs.py frames VIDEO_O_CARPETA_DE_IMAGENES work/conserva los fotogramas más nítidos y diferentes comowork/frames/f01.png ...; abrework/frames.jpgy elige el fotograma que muestre la recompensa (un rostro reaccionando, el resultado, el antes y el después). ¿Sin video? Usa las propias imágenes o capturas de pantalla del usuario en una carpeta; nunca la foto de un desconocido. - Escribe
work/thumbs.json: tres variantes que difieren en UNA cosa (el texto, la imagen o el diseño), para que "Probar y comparar" de YouTube diga cuál funciona. Seis diseños:simple,shock(zoom y aro),big-number,header,comparison(dos imágenes),blur(un revelado). Formato, diseños y opciones (enfoque, palabra destacada, lado del texto, colores de la marca): references/thumbnails.md. - Renderiza:
python <carpeta-del-skill>/scripts/thumbs.py render work/thumbs.json out/ [--brand brand.json]. Escribeout/thumb-a.pngy siguientes yout/thumbs.jpg: cada variante grande, como un mosaico de la página de inicio de YouTube con el título, y en tamaño de móvil, con sus comprobaciones (1280x720 menos de 2 MB, máximo 5 palabras, letras de al menos 54 px de altura y aún legibles en tamaño de móvil, el texto dentro del marco, contraste 4.5:1 contra el fondo). Abrethumbs.jpg, corrige cada error (texto más corto,"shade": 0.65, otro diseño o imagen) y renderiza de nuevo.
6. Descripción
En este orden:
- Apertura: 2 líneas, cada una de máximo 160 caracteres, que se muestran antes de "...más". Dicen la promesa de nuevo con palabras frescas para una persona que aún decide si hacer clic: no el título repetido, sin enlace.
- Resumen: un párrafo corto (máximo 900 caracteres) de lo que obtiene el espectador. Frases simples, sin lista.
- Línea de recurso (solo si el video promete uno): qué es, luego el enlace o
[ENLACE]. - Capítulos: uno por línea,
0:00 Título. - Opcional: créditos o enlaces que el creador agrega siempre.
Máximo 5.000 caracteres en total. Sin hashtags por defecto (los temas van en las etiquetas), sin palabras de hype, sin guión largo y no más del 30 por ciento de sus secuencias de tres palabras compartidas con una descripción anterior.
7. Comentario fijado y etiquetas
- Comentario fijado: una pregunta vinculada al problema central del video o al siguiente paso del espectador, fácil de responder en una palabra o una línea. Máximo 200 caracteres, sin enlace.
- Etiquetas (opcional): 3 o más, máximo 500 caracteres en total, sin
#y sin coma dentro de una etiqueta.
8. Subtítulos
python <carpeta-del-skill>/scripts/make_srt.py words.json -o video.srt # tiempos de palabras
python <carpeta-del-skill>/scripts/make_srt.py transcript.txt --end 18:42 -o video.srt # líneas con marcas de tiempo
python <carpeta-del-skill>/scripts/make_srt.py --validate video.srt # verifica un archivo existente
Señales: hasta dos líneas de 42 caracteres, en pantalla de 1 a 7 segundos, cortadas primero al final de las oraciones, luego en comas; un número se queda con su unidad y un nombre nunca se divide; sin superposición, al menos 80 ms entre señales. Todo ajustable (--max-chars, --max-lines, --min-dur, --max-dur, --gap-ms). El informe va a stderr; código de salida 0 significa que el archivo está limpio. Las líneas con marcas de tiempo sin puntuación (subtítulos automáticos sin procesar) se cortan solo por longitud y pausas: primero puntúa la transcripción para mejores señales.
9. Verifica el paquete
Escribe el paquete en este formato Markdown (JSON con las mismas claves también funciona: titles, description, pinned_comment, thumbnail_texts, tags, duration):
---
duration: 18:42
---
## Títulos
1. ...
2. ...
3. ...
## Descripción
```
Línea de apertura uno.
Línea de apertura dos.
Párrafo de resumen.
0:00 Primer capítulo
...
```
## Comentario fijado
...?
## Texto de miniatura
1. ...
2. ...
3. ...
## Etiquetas
etiqueta uno, etiqueta dos, etiqueta tres
Luego ejecuta:
python <carpeta-del-skill>/scripts/check_package.py package.md --srt video.srt --source transcript.txt
python <carpeta-del-skill>/scripts/check_package.py package.md --duration 18:42 --earlier old-desc-1.txt old-desc-2.txt
--duration(oduration:en el archivo) verifica el último capítulo; sin él se usa el final del último subtítulo.--sourceverifica que cada número en un título o texto de miniatura aparezca en el video y que la apertura comparta palabras con cada título.--earlierbloquea una descripción repetida.FAILdebe corregirse;WARNcorregirse o explicarse. Código de salida 0 significa que nada falló (--stricttambién falla en advertencias,--jsonimprime resultados legibles por máquina).- Los límites y la lista de palabras de hype están en
scripts/package-rules.json; cópialo, conserva las claves para cambiar, pasa--rules my-rules.json(por ejemplo"allow_hashtags": true,"title_max": 70).
Corrige cada error, ejecútalo de nuevo y luego entrega.
10. Entrega
package.md: los tres títulos (marca tu elección y di por qué en una línea), la descripción lista para pegar, el comentario fijado, los tres textos de miniatura, las etiquetas.- El archivo
.srty los tres PNG de miniatura (out/thumb-a.png,-b,-c), conout/thumbs.jpg. - Pasos para subir: pega la descripción (YouTube construye los capítulos desde sus líneas de tiempo), sube el SRT como subtítulos en el idioma del video, agrega las tres miniaturas a "Probar y comparar", reemplaza cualquier
[ENLACE], fija el comentario después de publicar, mantén libres los últimos 20 segundos para la pantalla final. - La línea de resultado del verificador y cualquier advertencia aceptada con su motivo.
Más detalles sobre cada regla y por qué existe: references/packaging-rules.md.
Ejemplo trabajado
examples/transcript.txt es la transcripción con marcas de tiempo de un video de 10:06 sobre cómo cultivar alimentos en un balcón pequeño; examples/words.json contiene los tiempos de palabras de sus primeros 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
El primero imprime made 149 cues from 1497 words, 0:00.4 to 10:03.0 y srt: ok; el segundo termina con Result: 0 failed, 0 warnings, 11 passed. Sus títulos toman tres ángulos (resultado: "Cultiva Comida Real en un Balcón Pequeño (Incluso Si Las Plantas Te Odian)"; método: "La Prueba Del Sol de Un Día Que Decide Qué Crece en Tu Balcón"; problema: "Por Qué Mueren Las Plantas del Balcón y el Truco del Cubo Que Lo Soluciona"), y sus textos de miniatura ("6 HORAS O NADA", "SE RIEGA SOLO", "DEJA DE MATAR PLANTAS") añaden algo que los títulos no dicen. examples/package-weak.json muestra los fallos: un título largo con hashtag, capítulos que empiezan en 0:05, un capítulo de 6 segundos, un comentario fijado con enlace y sin pregunta, un texto de miniatura de 8 palabras (9 fallos).