Video explicativo: del material bruto a YouTube programado

Director de YouTube

Un comando en lugar de varios skills que recordar. Grabaste footage; esto lo lleva hasta los activos publicados, deteniéndose para un 'sí' en cada compuerta.

Configuración: completa estos datos

marcador	qué es
<YOUR_FOOTAGE_DRIVE>	Donde reside el footage en bruto, ej. /Volumes/<nombre del volumen>
<YOUR_VIDEO_LIBRARY>	Donde se guardan los archivos terminados, ej. ~/Videos/Terminados
<YOUR_LUT>	El LUT aplicado a cada clip, ej. MyCamera_Log_to_Rec709.cube (o ninguno si grabas con un perfil estándar)
<YOUR_TIMEZONE>, <YOUR_POST_TIME>	Espacio de programación predeterminado (ver schedule-social)

Nunca ejecutes dos etapas sin aprobación intermedia. Cada etapa necesita el criterio del creador, y una etapa 1 incorrecta contamina todo lo que sigue.

Estado

Un archivo por video: drafts/videos/<slug>.json.

{"slug":"mi-video","title":"título de mi video",
 "footage":"<YOUR_FOOTAGE_DRIVE>/mi video footage",
 "work":"/tmp/.../paperedit",
 "project":"Mi Video - Edición en Papel",
 "stages":{"paper-edit":{"status":"approved","at":"YYYY-MM-DD","note":"v2, 10:16"},
           "punch-ins":{"status":"approved","at":"YYYY-MM-DD"},
           "reels":{"status":"approved","at":"YYYY-MM-DD"},
           "covers":{"status":"todo"},
           "schedule-reels":{"status":"todo"},
           "overlays":{"status":"pending"},
           "thumbnail":{"status":"todo"},
           "schedule-youtube":{"status":"todo"}}}

Estados: todo → running → review (esperando al creador) → approved | skipped.

Al 'continúa el video ': lee el archivo de estado, informa en una línea en qué punto se encuentra y reanuda en la primera etapa que no esté approved o skipped. Para un video nuevo: crea primero el archivo de estado, luego comienza en la etapa 1.

Mantén el directorio de trabajo estable entre etapas. Las transcripciones, segments-v2.json y cuts.json son reutilizados por todas las etapas posteriores, así que no los disperses.

Las etapas

#	etapa	skill	el creador aprueba	salida
1	Edición en papel	paper-edit	la lista de cortes, luego la línea de tiempo	Edición en Papel v1 + v2 (ajustada) en un nuevo proyecto de Resolve
2	Inserts	paper-edit paso 9	el plan de encuadre	Edición en Papel v3 (inserts)
3	Reels	video-reels	el gancho de cada reel	líneas de tiempo verticales, terminados: footage V1, tarjeta de gancho V2, subtítulos V3
3b	Portadas de reels	reel-covers	la prueba en cuadrícula, cada titular	una portada única de 1080x1920 por reel en tu estilo de portada, probada en vista de cuadrícula con el icono de reel
4	Programar reels	schedule-social	cada pie de foto y hora	IG + TikTok + Shorts en el calendario de Metricool, diariamente a partir de mañana, cada post con su portada
5	Superposiciones	video-overlays	la lista de clips antes de renderizar	clips .mov transparentes + FCPXML
6	Miniatura + título	video-thumbnails	qué variante	PNGs de 1920x1080 + una prueba del tamaño de un teléfono + títulos
7	Programar YouTube	schedule-social	el título, la miniatura y la descripción	el video de larga duración en el calendario de Metricool

Los reels van antes que las superposiciones a propósito. No necesitan las animaciones, y necesitan las manos del creador (recortar, renderizar) antes de poder publicarse. Publicarlos temprano significa que se están publicando mientras las superposiciones aún se renderizan. Las superposiciones son la etapa más lenta y la que menos se espera.

Grabaciones de eventos en vivo o con audio separado (un micrófono de solapa o grabadora en una carpeta audio/ junto a los clips): ejecuta lapel-sync antes de la edición en papel o los reels. Esto convierte el audio de la solapa en el audio del clip que todas las etapas posteriores leerán.

Carga el skill de la etapa antes de ejecutarlo. Este archivo es el orden de ejecución y las compuertas; cada skill contiene el 'cómo' real.

Compuertas: qué mostrar y qué preguntar

1. Edición en papel. Muestra la duración original, v1, v2, número de cortes y los cortes notables con razones. Pregunta: "¿Hay algo aquí que quieras conservar?" Después de que el creador revise: "¿Está bloqueado el corte?" Nada posterior puede comenzar hasta que lo esté, porque las superposiciones y los reels están anclados a las marcas de tiempo de las palabras.
2. Inserts. Construye v3 a partir del v2 recortado por el creador (segments-locked.json), luego copia la gradación de v2 a v3 sin que te lo pidan (paso 9 de paper-edit). Si el video habla de un proyecto real, pregunta si hay fotos, y colócalas en V2 como tarjetas con fondo blanco (paso 11 de paper-edit). Muestra el número de cambios, aproximadamente uno cada 20-40 s, y la lista de líneas que reciben un inserto cercano. Pregunta: "¿Estos aciertan en los momentos correctos?"
3. Reels. Si el video tiene una llamada a la acción con palabra clave de comentario, graba un clip CTA de reel aparte ("Comenta CLAVE abajo y te enviaré..."). Si el archivo de estado tiene reel_cta, termina cada reel de ese video con ese clip (puntos de entrada/salida en el cta.json vinculado, tomados de silencedetect porque Whisper puede desviarse hasta 2 s en clips cortos). La palabra clave del comentario también va en el pie de foto. Muestra cada reel como línea de gancho + lo que sigue, más el texto de la tarjeta de gancho. Pregunta: "¿Estos ganchos detienen el desplazamiento?" Menos y mejores beats es más. Luego pasa la responsabilidad: el creador recorta y renderiza. Los subtítulos y las tarjetas de gancho ya están en la línea de tiempo. Comienza las superposiciones mientras tanto. Nadie necesita estar inactivo. 3b. Portadas de reels. No te saltes esta etapa por defecto. Tan pronto como los ganchos de los reels estén aprobados, di "Lo siguiente: portadas para estos reels" e inicia reel-covers. No necesita los renders, solo los ganchos y la transcripción, así que hazlo durante el recorte. Muestra _grid-phone.png (con el icono de reel dibujado) más cada titular. Pregunta: "¿Estas portadas detienen el desplazamiento?" Itera hasta que esté aprobado, luego regístralas. Si el creador dice saltar, márcalo como skipped y di que los reels se publicarán con un fotograma automático.
4. Programar reels. Se activa con "programa los reels" una vez que los renders estén listos. Muestra cada pie de foto y cada espacio, cada uno junto a su portada aprobada. Pregunta: "¿Está bien programarlos?" Si covers no está approved o skipped, detente y ejecuta primero la etapa 3b.
5. Superposiciones. El estilo predeterminado es texto dentro de la escena, al lado o detrás de la cabeza del orador, nunca sobre la cara (ver video-overlays). Muestra la lista de clips propuesta con códigos de tiempo y señales antes de renderizar (renderizar es ~10 s de tiempo real por segundo de superposición). Pregunta: "¿Alguno de estos lo eliminarías, y algún momento que me haya perdido?"
6. Miniatura + título. Muestra la hoja de prueba del tamaño de un teléfono, no los renders a tamaño completo, más 4-6 títulos con recuentos de caracteres. Pregunta: "¿Cuál eliges, y quieres palabras diferentes?"
7. Programar YouTube. Después de que las superposiciones estén en la línea de tiempo y el video final se haya exportado. Muestra el título, la miniatura elegida y la descripción completa. Pregunta: "¿Está bien programarlo?"

Reglas de programación, tanto para las etapas 4 como para la 7:

Regla de asignación predeterminada: comenzar el día después de hoy, una publicación por día a <YOUR_POST_TIME> <YOUR_TIMEZONE>, y saltar cualquier día que ya tenga contenido (los borradores cuentan). Obtén getScheduledPosts antes de elegir espacios; nunca reserves dos veces un mismo día.

Los pies de foto se envían limpios. Texto terminado cada vez, sin texto "BORRADOR DE PRUEBA". Marca las pruebas con draft: true + autoPublish: false y entrega el enlace del planificador en su lugar.

Reglas del orden de ejecución

• Corta antes que los gráficos, siempre. Las marcas de tiempo de las superposiciones están ancladas a las palabras habladas; cualquier nuevo recorte las desplaza a todas. Si el corte cambia después de la etapa 5, regenera el FCPXML (segundos) pero no vuelvas a renderizar los clips.
• Los reels provienen del footage en bruto, nunca del corte con superposiciones. Las animaciones están hechas para YouTube, y por eso los reels pueden ejecutarse antes que las superposiciones.
• Dos traspasos, y se superponen. Después de la etapa 3, el creador está recortando reels; después de la etapa 6, están colocando superposiciones en la línea de tiempo y exportando. Ambos son lentos para ellos y gratuitos para ti, así que encola el trabajo de la siguiente etapa en lugar de esperar.
• El LUT se aplica a todo (<YOUR_LUT>). Si la cámara graba un perfil log, los fotogramas sin gradar se ven grises, incluidas las imágenes fijas de las miniaturas.
• Cualquier cosa que toque Resolve: ejecuta bash .claude/skills/paper-edit/scripts/ensure_resolve.sh primero. Abre Resolve si está cerrado y espera la API, así que no le pidas al usuario que lo abra. Aún necesita Scripting externo: Local y un proyecto nuevo para que el trabajo existente nunca esté en riesgo. Nómbralo <Video> - YYYY-MM-DD para que el más nuevo sea obvio; dos proyectos con el mismo nombre causan confusión sobre cuál es el actual.
• Los archivos terminados van a <YOUR_VIDEO_LIBRARY>/<Video> YYYY-MM-DD/, los archivos de trabajo se quedan en ~/Movies/<video>-*. Dos renders de cada video: una pasada de entrega y un máster de archivo a 60 Mbps, más las líneas de tiempo .drt/.drp. Consulta schedule-social para la distribución. El creador nunca debería tener que buscar en ~/Movies algo que se pueda publicar, y nunca se escribe nada suelto en el Escritorio.
• La exportación 4K de larga duración (opcional): duplica YouTube Final como YouTube Final 4K, configura la línea de tiempo de esa copia a 3840x2160 (useCustomSettings 1 + timelineResolutionWidth/Height), y renderiza H.264 a VideoQuality 40000 en <Video>/YouTube/. El zoom y los inserts sobreviven al cambio de resolución, y los clips de superposición 1080 se escalan limpiamente. Inicia el renderizado y regresa; nunca esperes dentro de execute_resolve_code. Un video de 6:30 puede tomar aproximadamente una hora en 4K con superposiciones dentro de la escena, y la llamada MCP muere después de 30 minutos, lo que también bloquea todas las llamadas posteriores hasta que termine el render. Vigila el archivo desde bash en su lugar: el MP4 solo se vuelve legible (ffprobe tiene éxito) una vez que Resolve termina. Un proyecto se renderiza a la vez, así que comienza el render del siguiente video después de que el archivo anterior aterrice. Aproximadamente 1.9 GB por cada 6.5 minutos.
• Publicar es la única etapa irreversible. Todo lo anterior se puede reconstruir en minutos; una publicación que sale no se puede despublicar desde aquí. Trata las compuertas en las etapas 4 y 7 como las estrictas.

Tiempo y costo

etapa	tiempo real	notas
Edición en papel	~2 min de transcripción + tiempo de lectura	la única etapa con costo de pensamiento real, ~5k tokens
Inserts	segundos
Reels	~1 min	subtítulos incluidos
Superposiciones	~10 min de render limpio, luego ~15-20 s por cada 1 s de superposición	el estilo dentro de la escena enmascara cada fotograma: ~48 clips pueden tomar ~1 h; necesita el disco de footage montado; ejecútalo durante el recorte del reel
Miniatura	~1 min	4-6 variantes
Programación	~2 min	salto de carga + escrituras en Metricool

Relacionados

• paper-edit, lapel-sync, video-overlays, video-reels, reel-covers, video-thumbnails, schedule-social
• Opcional: una referencia de títulos (reglas de longitud y CTR) y un plan de temas de video, si los mantienes