Communitygithub.com

shorts-pipeline

Crear, renderizar, verificar, mezclar y empaquetar un video vertical 1080×1920 de formato corto (YouTube Shorts, Reels, TikTok) a partir de material de archivo y una locución, usando el pipeline basado en clips (edl.json, build.py, check.py, sound/mix.py). Úsalo siempre que la tarea sea producir, corregir o revisar dicho video, instruir a un subagente editor, o explicar por qué falla check.py.

¿Qué es shorts-pipeline?

Este skill implementa un pipeline completo y reutilizable para la producción de videos verticales en formato corto (1080×1920) como YouTube Shorts, Reels de Instagram o TikTok. Está diseñado para funcionar con un archivo de lista de edición (edl.json) y una locución pregrabada, automatizando la composición de clips en una ventana temática, la generación de subtítulos, la inserción de elementos gráficos (placas de gancho, círculos destacados, portadas) y la mezcla de audio a -14 LUFS. El skill soporta múltiples temas visuales (case-file, panel-heist, vice-dusk, classic) y es neutral en cuanto a temática; toda la personalización por canal (idioma, audiencia, reglas de contenido, estilo, voz, créditos y calendario) se define en un archivo CHANNEL.md que debe leerse antes de cualquier producción. El flujo de trabajo consta de nueve pasos secuenciales, cada uno con su propia verificación: desde la creación del guion y la locución, pasando por la selección de material, la edición, el renderizado, la generación de portada, la comprobación automática (check.py), la mezcla de audio y finalmente el empaquetado. Está pensado para plataformas como Claude Code, Cursor y Codex, y requiere que el proyecto tenga una estructura de carpetas específica (_pipeline/, _tools/, _fonts/) y que se ejecute un script de diagnóstico (doctor.sh) al menos una vez por máquina para asegurar que todas las dependencias están instaladas.

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

Preguntar en tu IA favorita

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

Documentación

Pipeline de Shorts (neutral en temática)

Una lista de edición (<short>/edl.json) más una locución dan como resultado un video terminado: clips en movimiento dentro de una "ventana" temática con foto, subtítulos palabra por palabra, una placa de gancho, un círculo destacado, una portada, una lista de efectos de sonido y una mezcla de audio a -14 LUFS. Todo lo específico de un canal (temática, idiomas, audiencia, reglas de contenido, estilo visual, voz, créditos, calendario) reside en el archivo CHANNEL.md del proyecto. Léelo primero y sigue sus instrucciones por encima de los valores por defecto indicados a continuación. Si falta o tiene secciones vacías, pregunta al propietario (o copia engine/templates/CHANNEL.md y rellénalo con él) antes de producir nada. Skills relacionados: shorts-script-voice (temática, guion, voz) y shorts-packaging (archivos finales, textos de subida).

Antes de todo

  1. Los scripts del kit (setup.sh, shorts-init.sh, doctor.sh, install-codex.sh) están en la carpeta scripts/ del kit: la carpeta del plugin, o $SHORTS_HOME/kit/scripts/ (setup.sh e install-codex.sh mantienen una copia allí).
  2. Trabaja desde una carpeta de proyecto que contenga _pipeline/, _tools/, _fonts/, CHANNEL.md (crea una con scripts/shorts-init.sh <dir>). Todos los comandos siguientes se ejecutan desde la raíz de esa carpeta.
  3. Ejecuta scripts/doctor.sh <project-dir> una vez por máquina. Revisa todas las dependencias (programas del sistema, paquetes de Python, modelos, espacio en disco) y debe terminar con "All good.". Si no: scripts/install-system-deps.sh para ffmpeg/Python/curl, scripts/setup.sh para el resto. La lista completa está en DEPENDENCIES.md del kit.
  4. SHORTS_HOME (por defecto ~/.shorts-studio) contiene el entorno virtual de Python y los modelos de voz. Expórtalo si lo pones en otro lugar.
  5. Lee _pipeline/README.md (referencia del motor) y references/edl-notes.md antes de escribir una lista de edición.

El flujo de trabajo (cada paso tiene su propia verificación)

#PasoComando / salidaVerificar
1Temática + guionskill shorts-script-voiceuna afirmación, fuentes atribuidas, propietario OK cuando el perfil lo pide
2Voz$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, luego _tools/words.py <short>/volee vo/words.json: cada palabra correcta
3Material de archivo_tools/grab.py <topic> '<url>' <start> <end> --tag NOMBRE (registra en _footage/SOURCES.md), o tus propias grabacioneshoja de contacto de cada clip; política de CHANNEL.md
4Lista de edicióncopia references/edl-template.json, cambia el contenidobuild.py <edl> --words muestra los tokens de subtítulos
5Renderizadopython3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 min; 4K60 es lento)sin errores; el archivo es más reciente que el edl
6Portada... build.py <edl> --cover"safe-zone violations: none", legible a 180 px de ancho
7Verificaciónpython3 _pipeline/check.py <short>/<nombre>-<tema>-silent.mp4 <short>/edl.jsonimprime ALL CHECKS PASS; has mirado cada hoja de contacto
8Sonido$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <nombre> --strict-14.0 +/-0.5 LUFS, pico real <= -1.0 dBTP, errores de palabra cerca de 0
9Empaquetadoskill shorts-packagingarchivo + portada + bloque de subida en ready/

Hoja de contacto de un clip fuente: ffmpeg -ss <t> -i <archivo> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (escribe PNG: la salida JPEG de algunas fuentes falla con "non full-range YUV"). Límites de toma: ffmpeg -i <archivo> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*". Temas: case-file (papel de expediente), panel-heist (página de cómic), vice-dusk (atardecer neón), classic; el perfil elige uno.

Cómo es un buen Short (valores por defecto; el perfil los sobreescribe)

  • 18-45 s, un argumento desde el gancho hasta la conclusión, un corte cada 1.5-3 s, cada plano se mueve, la placa de gancho está visible desde el fotograma 0 (hook.y 1170 la mantiene alejada de la etiqueta de exposición), un momento destacado con un círculo rojo sobre algo que realmente se vea en el fotograma.
  • La imagen sigue las palabras. Los subtítulos son frases de 2-3 palabras (break_before); los nombres permanecen en un solo grupo.
  • El último plano vuelve al primer fotograma (el video hace un bucle).
  • Todo el texto legible permanece dentro de la zona segura del teléfono: y 300-1580, x 130-950 (x <= 860 para y 1000-1600). check.py lo exige.
  • Ventana de foto alta "aspect": "3:4" (900x1200) en clips de 1080p o más; las fuentes de 720p o con letterbox no pueden llenarla.

Lecciones aprendidas con esfuerzo (detalles en references/lessons.md)

  • ¿El edl es más reciente que el renderizado? El renderizado está obsoleto. Reconstruye antes de juzgar a check.py.
  • Fotogramas congelados (fotogramas consecutivos que apenas difieren durante > 0.3 s) hacen fallar check.py. Las pantallas estáticas, los colores planos y los sujetos inmóviles necesitan movimiento a velocidad constante: "move_ease": "linear", un rango de zoom de 0.15-0.4 y un paneo de 150+ píxeles de la fuente. float solo no es suficiente (el seno se ralentiza hasta cero en sus giros).
  • Límites de zoom: fuentes 4K <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py imprime el límite por clip).
  • Superposiciones de creador (marca de agua, cámara facial, tercio inferior, subtítulos, banners estilizados) nunca llegan a la imagen: recorta con la anulación de imagen de sources de nivel superior, mueve el recorte o elige otros fotogramas. Mira cada fotograma de corte.
  • Honestidad: las etiquetas, los círculos y los subtítulos dicen solo lo que muestra el fotograma; atribuye los hechos a su fuente en la locución.
  • Portada: un recorte a sangre de un fotograma fuente; la placa se coloca en tab_y (330) y oculta la parte superior de la imagen. Para un sujeto cerca de la parte superior, establece tab_y en aproximadamente 1090 y stamp_y en aproximadamente 410.
  • Un renderizado a la vez (un renderizado 4K60 usa todos los núcleos); nunca inicies un segundo renderizado de la misma carpeta.

Delegar una edición a un subagente

Dale al agente BRIEF.md (creado por shorts-init a partir de references/editor-brief.md) junto con el guion, los archivos de voz y la lista de clips. La sesión principal escribe el guion y la voz, revisa cada fotograma por sí misma y realiza la mezcla de sonido: el informe de un agente es una afirmación, no una prueba. Verifica las marcas de tiempo de los archivos (mp4 silencioso más reciente que el edl, registro de verificación más reciente que el mp4) antes de aceptar.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados