CommunityRedacción y edicióngithub.com

youtube-packaging

Convierte un video finalizado, guión o transcripción en el paquete completo para subir a YouTube: 3 opciones de título, descripción con capítulos aceptados por YouTube, comentario fijado, subtítulos SRT y 3 miniaturas listas. Usar cuando el usuario diga "escribe mi título y descripción", "descripción de YouTube con capítulos", "haz capítulos", "marcas de tiempo para mi video", "haz un SRT", "subtítulos de esta transcripción", "comentario fijado", "haz mi miniatura", "miniatura para este video", "texto de miniatura", "empaqueta este video", "prepáralo para subir", o tenga un video terminado, guión largo, transcripción o tiempos de palabras para publicar.

¿Qué es youtube-packaging?

Esta habilidad de agente AI convierte un video terminado o su guión/transcripción en el paquete completo para subir a YouTube, todo verificado mediante scripts. Genera tres opciones de título, una descripción con capítulos que cumplen las reglas de YouTube (comienza en 0:00, al menos tres, ninguno menor a 10 segundos), un comentario fijado que hace una pregunta, un archivo de subtítulos SRT con líneas limpias y tres miniaturas finales (1280x720 PNGs a partir de los fotogramas del video, seis diseños, verificadas por contraste y legibilidad en tamaño de móvil, listas para la función "Probar y comparar" de YouTube). La habilidad es útil para creadores de contenido, editores y productores que quieren ahorrar tiempo y asegurar la calidad del empaque sin revisar manualmente cada elemento. Funciona en cualquier nicho y duración de video. Utiliza scripts Python en la carpeta `scripts/` (requiere Python 3.10+, Pillow, numpy, Playwright y ffmpeg para miniaturas) y verifica el paquete con `check_package.py` para garantizar que cumple todas las reglas de YouTube y las mejores prácticas de retención de audiencia.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 escriben 1: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 como work/frames/f01.png ...; abre work/frames.jpg y 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]. Escribe out/thumb-a.png y siguientes y out/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). Abre thumbs.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:

  1. 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.
  2. Resumen: un párrafo corto (máximo 900 caracteres) de lo que obtiene el espectador. Frases simples, sin lista.
  3. Línea de recurso (solo si el video promete uno): qué es, luego el enlace o [ENLACE].
  4. Capítulos: uno por línea, 0:00 Título.
  5. 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 (o duration: en el archivo) verifica el último capítulo; sin él se usa el final del último subtítulo. --source verifica 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. --earlier bloquea una descripción repetida.
  • FAIL debe corregirse; WARN corregirse o explicarse. Código de salida 0 significa que nada falló (--strict también falla en advertencias, --json imprime 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

  1. 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.
  2. El archivo .srt y los tres PNG de miniatura (out/thumb-a.png, -b, -c), con out/thumbs.jpg.
  3. 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.
  4. 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).

Skills relacionados