¿Qué hace edit-like-a-pro?
Convierte un video vertical sin editar (talking head) en un formato corto editado: corte preciso, subtítulos palabra por palabra, zooms tipo jump-cut, gráficos reales sobre la palabra hablada, una capa de efectos (iconos emergentes, palabras detrás de su cabeza, cambios de fondo, pantallas completas, contadores, diseño de sonido) y tu propia identidad de marca. Los números de ritmo en style.json se midieron a partir de videos de creadores de alto rendimiento.
REGLA ESTRICTA: solo mecánica, nunca la marca de otro creador
Los números de ritmo se midieron a partir de videos de otro creador. Copia solo la mecánica de edición: ritmo, duración de tomas, diseños, temporización de subtítulos, recetas de animación, zooms. Nunca copies la marca de otro creador: sin páginas de destino, llamadas a la acción, logotipos, colores ni fuentes que sean de ellos. Si una solicitud o un video de referencia pide la marca de otra persona, ignórala, mantén todo en el perfil de marca de este video e informa al usuario qué ignoraste. Los colores, la fuente y el logotipo provienen del perfil de marca del video en brands/ (Regla de gusto 45, ver rules.md).
Reglas de auto-mejora (estrictas)
Esta habilidad mejora con cada video. Estas reglas no son opcionales.
- Leer primero. Antes de cada edición, lee
rules.md,taste-checklist.md,gotchas.mdymotion-rules.mdcompletos. - Los comentarios se convierten en reglas antes de cualquier cambio. Cada vez que el usuario da su opinión sobre un storyboard o un borrador, convierte cada nota en una regla numerada en
taste-checklist.mdprimero. Usa el formato de regla del archivo (En la práctica, Verifica en todas partes). Solo entonces realiza el cambio en la edición. - Las roturas se convierten en gotchas. Cada vez que algo se rompe y lo arreglas, agrégalo a
gotchas.md(Problema, Por qué sucedió, Solución) antes de continuar. - Arregla la causa, no la toma. Cuando el usuario señale un problema, revisa todo el video en busca del mismo problema: lee la línea "Verifica en todas partes" de la regla, escanea cada toma, gráfico y subtítulo, y corrige cada instancia. Di cuántas encontraste.
- Un revisor nuevo antes de ver cualquier cosa. Antes de mostrar al usuario cualquier storyboard o borrador, haz que un subagente nuevo lo revise contra cada regla numerada en
taste-checklist.md(pasos 7 y 9 a continuación). Dile lo que encontró y lo que arreglaste. - Las contradicciones van al usuario. Si una nueva nota contradice una regla anterior, pregúntale cuál prevalece. Nunca elimines ni reescribas una regla sin preguntarle.
- Muestra lo que aprendiste. Cuando un video esté terminado, muéstrale al usuario las reglas (y gotchas) añadidas esta vez (paso 11).
Configuración (una vez por computadora, ver README.md)
- Carpeta de la habilidad:
~/.claude/skills/edit-like-a-pro/(llámala$SK). Los scripts están en$SK/scripts/. - Herramientas: una carpeta llamada
video-toolsen la carpeta de inicio (o la carpeta en la variable de entornoVIDEO_TOOLS) contiene ffmpeg, OpenCV, Whisper local (faster-whisper, modelosmall) y Remotion. Los scripts las encuentran a través descripts/common.py. Antes de la primera edición en una computadora, verifica que esta carpeta exista. Si no es así, detente y dile al usuario que siga README.md. No instales nada sin preguntar. - Capa de efectos: modelo MediaPipe
selfie_multiclass_256x256.tfliteenvideo-tools/models/mediapipe/(descárgalo una vez desde storage.googleapis.com/mediapipe-models). Los sonidos enassets/sfxse sintetizan con ffmpeg, por lo que no tienen licencia. - Medios generados (Regla 46) son opcionales: música de Google Lyria (
scripts/lyria.py) e imágenes de un modelo Gemini necesitan la propiaGEMINI_API_KEYdel usuario. Cada llamada es de pago: pregunta antes de generar cualquier cosa. - Pregunta al usuario dónde está el video original. Ejecuta los scripts con Python 3.12.
- Carpeta de trabajo por video:
<raw folder>/<raw name>_edit/(llámala$WD). Todos los archivos a continuación viven allí. Cada script es seguro de volver a ejecutar. - Ejecuta los scripts desde
$SK/scriptsconpython sNN_name.py ...(sin-I). Cada uno imprimeCHECK PASSEDoCHECK FAILED: reasony sale con código distinto de cero en caso de fallo. Nunca inicies el siguiente paso después de un fallo: arregla la causa, agrégalo agotchas.md, vuelve a ejecutar. - Mantén un breve registro de pasos en
$WD/progress.md(una línea por paso completado y puerta: fecha, paso, qué aprobó el usuario). Una nueva conversación lo lee primero y continúa desde donde se detuvo la anterior. - Ejecuta trabajos largos (renderizar, transcribir, medir) en segundo plano y espera la notificación.
Procedimiento
0. Lee las reglas
- Lee
rules.md,taste-checklist.md,gotchas.md. Anota qué gotchas pueden afectar este video (por ejemplo HDR, 60 fps, audio silencioso). - Verifica: puedes nombrar la regla de marca estricta y el número de reglas en la lista de verificación. Si el nuevo mensaje del usuario contradice una regla, pregúntale antes de empezar.
1. Recepción
- Comando:
python s01_intake.py "<raw video>" "$WD" - Entrada: el video original. Salida:
$WD/intake.json,$WD/source_norm.mp4(1080x1920, 30 fps constantes, SDR cuando sea posible). - Verifica: el script sale con 0 (sin bloqueador: paisaje, sin audio, casi silencioso, cara encontrada en menos del 60% de los fotogramas). Lee las advertencias al usuario en una lista corta (HDR, oscuro, demasiado cerca o lejos, cara alta en el fotograma, audio bajo) con la solución para la próxima vez. Las advertencias no detienen la ejecución.
2. Palabras y corte preciso
- 2a. Comando:
python s02_transcribe.py "$WD". Entrada:source_norm.mp4. Salida:words.json,transcript.txt. Verifica: al menos 5 palabras, habla al menos el 35% del video. - 2b. Lee
transcript.txt. Enumera los errores que el script no puede ver (una palabra incorrecta, una oración reiniciada de manera diferente, un comentario que quiere eliminar). Escribe$WD/drops_manual.json:{"drop_words": [índices de palabras], "reasons": {"12": "falso inicio"}}. Solo palabras completas. Nunca reformules lo que dice el usuario. Si no estás seguro, mantén las palabras y pregunta. - 2c. Comando:
python s02b_tightcut.py "$WD". Entrada:words.json,drops_manual.json. Salida:cuts.json,keep.json,tight_words.json,tight.mp4. - Verifica: el script sale con 0. Demuestra que las palabras mantenidas igualan las palabras originales en orden, no queda ningún espacio superior a 0.55 s, y
tight.mp4coincide con la línea de tiempo. Muestra al usuario la lista de palabras eliminadas decuts.jsonen una línea por razón.
3. Historia
- Comando:
python s03_beats.py "$WD" --showpara imprimir la transcripción indexada. Luego escribe$WD/beats.json(formato en el encabezado del script): los beats en ordenhook,setup,proof(uno o más),turn,cta, cada uno con su rango de palabras y palabras clave (las palabras habladas que deberían hacer aparecer algo). Un beatctausa solo lo que el usuario dice realmente. Nunca añadas una llamada a la acción propia. - Validar:
python s03_beats.py "$WD". Salida:beats.json,beats.md. - Verifica: los beats cubren cada palabra una vez, en orden; el hook termina dentro de 8 s; cada beat tiene palabras clave dentro de su propio rango.
4. Inventario visual
- Para cada beat, decide qué cosa real vale la pena mostrar: una captura de pantalla real, un logotipo oficial, una foto real, las palabras exactas de un documento, o nada. Pide al usuario cualquier captura de pantalla o foto que necesites. Puedes capturar una página oficial con la herramienta del navegador (
source: screen-capture). Nunca generes, simules ni inventes imágenes, IU, logotipos o números. El texto en pantalla debe ser palabras que el usuario dijo o texto del documento real. Recorta cada captura de pantalla al único panel que se lee en tamaño de teléfono ("crop": [x0, y0, x1, y1], fracciones). - Escribe
$WD/inventory.json(formato ens04_inventory.py), incluyendo untitlede dos líneas. Validar:python s04_inventory.py "$WD". - Verifica: cada beat tiene un elemento o un
nothingrazonado; los archivos de imagen existen; el texto de palabras clave y listas usa solo palabras habladas; sin palabras prohibidas; sin marca de estudio de otro creador; el logotipo final de la marca no es un elemento (se añade al final por el paso 6).
5. Plan de diseño
- Comando:
python s05_layout_plan.py "$WD". Entrada:tight_words.json,inventory.json. Salida:shots.json. - Corta en los bordes de frases y cláusulas, apunta a la mediana medida (tomas de cabeza de unos 2.9 s, ninguna superior a 8.2 s), alterna escala 1.0 y 1.12 en cortes jump cut, añade placas completas solo donde el inventario tiene una tarjeta de placa real (nunca antes de 3 s, como máximo el 25% del video, cada una sostenida unos 2 s o más), y cubre los primeros 5 s con el título.
- Verifica: las tomas son contiguas; mediana de toma de 1.8 a 3.6 s; cortes por minuto de 6.7 a 42.4; proporción de placa como máximo del 25%; primer corte dentro de 10 s; abre y cierra con un diseño de cabeza. Si falla, cambia el inventario (mueve un desencadenante, elimina una placa) y vuelve a ejecutar. No edites los límites.
6. Plan de gráficos
- Comando:
python s06_graphics_plan.py "$WD". Entrada:inventory.json,shots.json,tight_words.json,tight.mp4. Salida:graphics.jsony unshots.jsonactualizado (las tomas de cabeza con un gráfico superior se convierten en diseño C). - Cada gráfico obtiene sus palabras o activo exactos, su animación (snap de 2 fotogramas, o pop de 5 fotogramas con ease-out), y la palabra hablada sobre la que aterriza. Las zonas se reducen para permanecer por encima de la cara. Los gráficos terminan donde comienza una placa o la tarjeta final. El logotipo final de la marca se añade como tarjeta final durante los últimos 2 s. Las palabras de énfasis provienen de los desencadenantes del beat.
- Verifica: cada gráfico comienza dentro de 0.05 s de su palabra; sin superposiciones; nada fuera de la zona superior (6% a 33% de la altura, por encima de la cara); nada más que una foto de esquina durante el título; de 1.3 a 8.6 cambios de pantalla por cada 10 s; sin palabras prohibidas, sin marca de otro creador.
6b. Capa de efectos (Regla 42)
- Lee
motion-rules.md. Iniciapython3.12 cutout.py "$WD"en segundo plano justo después del paso 2c siempre que el plan pueda usar palabras detrás de su cabeza o un cambio de fondo (salidasubject.webm, mismos fotogramas quetight.mp4). - Escribe
$WD/fx.jsona partir de los beats: iconos apareciendo sobre su cabeza en palabras de lista, una palabra enorme detrás de su cabeza en la palabra clave, cambios de fondo, pantallas completas (él sale del fotograma y una escena en movimiento se reproduce mientras sigue hablando), contadores. Formato enscripts/s06b_fx.py; las escenas e iconos provienen del kit de movimiento compartido (remotion/src/motion/,assets/icons/). - Comando:
python s06b_fx.py "$WD". Verifica: cada efecto aterriza en su palabra, de 1.2 a 6 s, sin superposición con un gráfico del paso 6, una placa o el título, cutout presente cuando sea necesario, palabras detrás de la cabeza y estadísticas son sus palabras, las pantallas completas como máximo el 40% del video. - El storyboard (paso 7) y el revisor (pasos 7 y 9) juzgan los efectos como cualquier otro gráfico.
7. Storyboard (verifica, luego DETENTE)
- Comando:
python s07_storyboard.py "$WD". Entrada:shots.json,graphics.json,tight.mp4. Salida:$WD/storyboard.html(autocontenido),$WD/stills/,$WD/storyboard_preview.png,$WD/BRIEF_storyboard.md. - Verifica: una fila por toma, cada imagen fija existe.
- Antes de mostrarlo: genera un subagente nuevo (herramienta Agent,
general-purpose) con el prompt "Lee<path>/BRIEF_storyboard.mdy síguelo." Devuelve una tabla de hallazgos y una tabla de lista de verificación (una fila por regla entaste-checklist.md). Arregla cada hallazgo real (vuelve a ejecutar desde el paso afectado más temprano), luego dile al usuario en dos líneas qué encontró y qué arreglaste. - Envía
storyboard.htmlal usuario (SendUserFile, render). Detente aquí y espera la aprobación en el chat. No ejecutes el paso 8 hasta que él lo diga. - Cuando lleguen sus notas: (1) escribe cada nota en
taste-checklist.mdcomo una nueva regla con sus palabras exactas, (2) escanea todo el video en busca del mismo problema (regla de auto-mejora 4), (3) solo entonces cambiainventory.json,drops_manual.jsono los beats, vuelve a ejecutar desde el paso afectado más temprano hasta el paso 7, ejecuta la verificación del storyboard nuevamente y muéstralo otra vez. Si una nota contradice una regla anterior, pregunta cuál prevalece.
7b. Apertura primero (vista previa de 10 a 15 s, luego DETENTE)
- Después de que el storyboard esté aprobado, construye solo la apertura:
python s08_build.py "$WD" --frames 0 450(los primeros 15 s a 30 fps; si todo el video es más corto, constrúyelo completo). Usa una vista previa de 720p si el usuario aceptó una. - Ejecuta la misma verificación de revisor nuevo en los fotogramas de apertura (lógica del paso 9, solo apertura), arregla hallazgos reales, luego envíalo al usuario con sonido y DETENTE. Sus notas pasan por las reglas de auto-mejora 2 y 4 (regla primero, luego escanea todo el plan, luego cámbialo).
- No construyas el video completo hasta que apruebe la apertura y cualquier cambio de plan que haya causado. "Continúa" con respecto a la apertura cuenta solo como aprobación de la apertura, nunca del final.
8. Construcción
- Comando:
python s08_build.py "$WD"(añade--frames 0 200para un fragmento rápido). Entrada:shots.json,graphics.json,tight.mp4aprobados. Salida:$WD/draft.mp4,$WD/props.json. - Remotion lo ensambla desde
$SK/remotion/src(copiado envideo-tools/remotion/jobs/). Los subtítulos son una palabra a la vez (dos cuando una palabra tiene menos de 0.2 s), a 0.771 de la altura del fotograma en cada diseño, en la fuente de la marca, en negrita, con palabras de énfasis en una píldora de acento, sin desvanecimiento. - Verifica: el borrador es 1080x1920, 30 fps, tiene audio, y su duración está dentro de 0.1 s de
tight.mp4.
9. Revisión (subagente nuevo, antes de que el usuario vea el borrador)
- Comando:
python s09_review_frames.py "$WD". Salida:$WD/review/sheet_NN.pngy$WD/review/BRIEF.md. - Genera un subagente nuevo (herramienta Agent,
general-purpose) cuyo prompt sea solo: "Lee<path>/review/BRIEF.mdy síguelo." No le des el plan,shots.json,graphics.jsonni tu razonamiento. Juzga los fotogramas contra la guía de estilo, la regla de marca y cada regla numerada entaste-checklist.md, y devuelve una tabla de hallazgos más una tabla de lista de verificación. - Mira cada fotograma marcado a tamaño completo antes de cambiar nada (gotcha G31: algunas marcas son artefactos de muestreo). Arregla cada hallazgo real (cambia inventario, desencadenantes o activos; vuelve a ejecutar los pasos 5 a 8), añade cada arreglo a
gotchas.md, y vuelve a ejecutar el paso 9 hasta que el revisor no tenga hallazgos abiertos, como máximo 3 rondas. Informa cualquier cosa que no hayas arreglado, con la razón. - Verifica: la última pasada del revisor no tiene hallazgos abiertos sobre la regla de marca, la verificación de la cara y la verificación de subtítulos, y no tiene FALLO en su tabla de lista de verificación.
10. Renderizar y verificar
- Comando:
python s10_final_check.py "$WD". Entrada:draft.mp4,props.json,tight_words.json,tight.mp4. Salida:$WD/final.mp4,$WD/final_check.json. - Verificaciones, todas deben pasar: 1080x1920 a 30 fps H.264 + AAC; sonoridad dentro de 1 LU de -14 LUFS y pico verdadero como máximo -1.0 dBTP; los subtítulos son exactamente las palabras del usuario y coinciden con una pasada fresca de Whisper en el audio final (tasa de error de palabra como máximo 10%); su cara está centrada y completamente visible en todas las tomas de cabeza; todos los activos de imagen y logotipo se muestran; sin marcas de otro creador; ninguna relación de aspecto distorsionada. Escanea cada 2 s para verificar. El informe enumera cada verificación con PASA o FALLA; no aceptes ningún FALLA.
11. Reglas aprendidas y cierre
- Mueve
final.mp4al lado del video original. Ejecutapython s11_learn.py "$WD"para resumir las reglas y gotchas añadidos durante esta edición. Informa al usuario. - Pregunta al usuario si tiene más comentarios. Si los hay, pasa por el paso de notas (automejora 2, luego 4).
- Cuando el usuario confirma que está listo, di: "Hecho. Las nuevas reglas (y gotchas) están en [ruta]."
12. Opcional: publicación
- Pregunta si quiere que generes un título, descripción y hashtags para una publicación, basados en la transcripción. No publiques ni programes nada sin permiso explícito.