Communitygithub.com

edit-like-a-pro

Convierte un video vertical sin editar (iPhone o cualquier clip) en un formato corto rápido: corte preciso, subtítulos palabra por palabra, zooms, gráficos sobre la palabra hablada, una capa de efectos y diseño de sonido, con tu propia marca. Se utiliza para editar este video, hacer un corto, cortar este video de talking head. Muestra un storyboard para aprobación antes de renderizar y aprende de tus comentarios.

¿Qué es edit-like-a-pro?

Esta habilidad para agentes de IA como Claude Code transforma un video de talking head sin editar (formato vertical, como un clip de iPhone) en un video corto y dinámico para redes sociales. Realiza un corte preciso, añade subtítulos palabra por palabra, zooms tipo jump-cut, gráficos que aparecen sobre las palabras habladas, una capa de efectos (como iconos emergentes, palabras detrás de la cabeza del hablante, cambios de fondo, pantallas completas, contadores y diseño de sonido) y aplica la identidad de marca del usuario. Los ritmos de edición se basan en análisis de videos de alto rendimiento, pero explícitamente prohíbe copiar la marca de otros creadores. La habilidad es altamente auto-mejorable: cada interacción del usuario se convierte en una regla en una lista de verificación personalizada, y cada error corregido se documenta como un 'gotcha'. El proceso incluye la creación de un storyboard que se muestra al usuario para aprobación antes de cualquier renderizado, y el agente aprende de los comentarios para mejorar iterativamente. Está diseñada para el ecosistema de Claude Code, utilizando herramientas como ffmpeg, OpenCV, Whisper y Remotion.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/arisouss/edit-like-a-pro/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿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.

  1. Leer primero. Antes de cada edición, lee rules.md, taste-checklist.md, gotchas.md y motion-rules.md completos.
  2. 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.md primero. Usa el formato de regla del archivo (En la práctica, Verifica en todas partes). Solo entonces realiza el cambio en la edición.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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-tools en la carpeta de inicio (o la carpeta en la variable de entorno VIDEO_TOOLS) contiene ffmpeg, OpenCV, Whisper local (faster-whisper, modelo small) y Remotion. Los scripts las encuentran a través de scripts/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.tflite en video-tools/models/mediapipe/ (descárgalo una vez desde storage.googleapis.com/mediapipe-models). Los sonidos en assets/sfx se 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 propia GEMINI_API_KEY del 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/scripts con python sNN_name.py ... (sin -I). Cada uno imprime CHECK PASSED o CHECK FAILED: reason y 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 a gotchas.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.mp4 coincide con la línea de tiempo. Muestra al usuario la lista de palabras eliminadas de cuts.json en una línea por razón.

3. Historia

  • Comando: python s03_beats.py "$WD" --show para imprimir la transcripción indexada. Luego escribe $WD/beats.json (formato en el encabezado del script): los beats en orden hook, 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 beat cta usa 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 en s04_inventory.py), incluyendo un title de dos líneas. Validar: python s04_inventory.py "$WD".
  • Verifica: cada beat tiene un elemento o un nothing razonado; 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.json y un shots.json actualizado (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. Inicia python3.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 (salida subject.webm, mismos fotogramas que tight.mp4).
  • Escribe $WD/fx.json a 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 en scripts/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.md y síguelo." Devuelve una tabla de hallazgos y una tabla de lista de verificación (una fila por regla en taste-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.html al 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.md como 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 cambia inventory.json, drops_manual.json o 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 200 para un fragmento rápido). Entrada: shots.json, graphics.json, tight.mp4 aprobados. Salida: $WD/draft.mp4, $WD/props.json.
  • Remotion lo ensambla desde $SK/remotion/src (copiado en video-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.png y $WD/review/BRIEF.md.
  • Genera un subagente nuevo (herramienta Agent, general-purpose) cuyo prompt sea solo: "Lee <path>/review/BRIEF.md y síguelo." No le des el plan, shots.json, graphics.json ni tu razonamiento. Juzga los fotogramas contra la guía de estilo, la regla de marca y cada regla numerada en taste-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.mp4 al lado del video original. Ejecuta python 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.

Skills relacionados