Communitygithub.com

alyssasworld/edit-twin-mcp

Realiza un corte preliminar del proyecto en Final Cut Pro con Edit Twin MCP: retomas, muletillas, pausas, tu apariencia y sonido guardados, adaptándose a reels/cortos o vlogs apaisados.

¿Qué es edit-twin-mcp?

Esta skill para el agente Claude Code proporciona un flujo de trabajo completo para crear un corte preliminar (rough cut) de un proyecto de video dentro de Final Cut Pro, utilizando las herramientas del MCP `edit-twin`. Su propósito es ahorrar tiempo al editor eliminando automáticamente retomas, muletillas (como 'um' y 'uh'), y pausas incómodas, mientras aplica el estilo visual y de audio guardado del usuario (como un 'look' o cadena de audio). La skill adapta su comportamiento según el formato del video, distinguiendo entre reels/cortos verticales y vlogs apaisados; por ejemplo, en reels aplica ajustes de pausa más agresivos y verifica el 'hook' inicial, mientras que en vlogs es más conservador con el silencio para preservar el B-roll. El proyecto original nunca se modifica: los cambios se importan como un proyecto nuevo. El flujo incluye la obtención del proyecto y el estilo del usuario, un análisis detallado (transcripción, búsqueda de repeticiones y pausas), la presentación de un plan para aprobación, la ejecución de los cortes, la aplicación de mejoras de apariencia y sonido, y finalmente la validación y exportación del nuevo proyecto a Final Cut Pro. La skill se basa en herramientas como `get_timeline`, `transcribe`, `find_repeats`, `cut_ranges`, `apply_look` y `apply_audio_style`, siguiendo estrictamente las reglas de no modificar el proyecto original y de esperar la aprobación del usuario antes de realizar cambios.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyssasworld/edit-twin-mcp/tree/HEAD/skills/edit-twin-rough-cut

Preguntar en tu IA favorita

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

Documentación

Corte preliminar con Edit Twin

Usa las herramientas MCP edit-twin. El proyecto original del usuario nunca se modifica: el resultado se importa como un NUEVO proyecto junto al original. Los tiempos están en segundos en la línea de tiempo actual. Las referencias a clips como "4" (clip de la historia) y "4.0" (elemento conectado) cambian después de cada edición, por lo que debes volver a leer get_timeline antes de usar las referencias.

1. Obtener el proyecto y el estilo del usuario

  1. get_style: valores predeterminados guardados (configuración de pausas, cadena de audio, apariencia predeterminada, notas aprendidas de sus ediciones). Sigue las notas.
  2. fcp_export_project. Si advierte que el proyecto está vacío, pídele al usuario que seleccione el proyecto correcto en el Navegador de Final Cut (o haga clic en su línea de tiempo) y vuelve a intentarlo. Si la exportación falla, pídele que use Archivo > Exportar XML… y te proporcione la ruta, o usa find_fcpxml_files + open_timeline.
  3. get_timeline, luego decide el formato a partir de summary.format (ancho/alto) y la duración, a menos que el usuario haya especificado cuál:
    • Reel / corto: vertical (alto > ancho), o de menos de ~3 minutos.
    • Vlog / apaisado: horizontal, o piezas más largas con B-roll, escenarios, música o momentos ambientales. Indícale al usuario qué formato elegiste en una línea.

2. Analizar (no cambiar nada aún)

  1. transcribe, con vocabulary configurado con nombres y jerga probables en el video.
  2. find_repeats: tartamudeos, retomas y muletillas (um/uh). Para cada retoma, compara las tomas y elige. Conserva la que tenga una entrega más clara, sin tropiezos y con un final limpio; si son iguales, conserva la toma posterior. Al eliminar una retoma, también elimina un conector sobrante ("y", "entonces") al inicio de la toma conservada si ya no suena natural.
  3. Pausas, según el formato:
    • Reel: find_silences con los valores predeterminados guardados.
    • Vlog: find_silences con anulaciones más flexibles (min_silence 0.6, keep_after_speech 0.15, keep_before_speech 0.15), y solo propón pausas dentro de secciones habladas (entre palabras de la transcripción). Nunca cortes tramos silenciosos que sean B-roll, escenarios, música o tomas de reacción; usa get_timeline y preview_frame cuando no estés seguro.
  4. Detente y muestra un plan breve: retomas (cita ambas tomas, di cuál conservarías y por qué), cuántas muletillas, cuántas pausas y cuántos segundos suman, y la duración esperada. Espera la aprobación o los cambios del usuario.

3. Cortar (después de la aprobación)

  1. cut_ranges para las retomas y muletillas aprobadas.
  2. Reels: remove_silences con los valores predeterminados guardados. Vlogs: cut_ranges solo con los rangos de pausa aprobados.
  3. Reels: verifica que los primeros ~3 segundos funcionen como gancho, es decir, que las primeras palabras enuncien el tema o una afirmación sorprendente. Si una línea de gancho más fuerte aparece más tarde, sugierela, pero no la muevas sin preguntar. Señala si el reel supera los 90 segundos.

4. Apariencia y sonido

  1. Si hay un clip de ajuste con efectos, ejecuta fit_to_timeline. De lo contrario, si el estilo tiene una apariencia predeterminada, ejecuta apply_look.
  2. Si el estilo tiene una cadena de audio, ejecuta apply_audio_style. Si no, ejecuta measure_loudness y sugiere una ganancia (el video social suele estar alrededor de -14 LUFS), u ofrece normalize_audio.
  3. Deja la música y el audio conectado en paz a menos que te lo pidan.

5. Verificar y enviar

  1. validate_timeline, luego render_preview. Indícale al usuario dónde está la vista previa y la nueva duración.
  2. send_to_final_cut con el nombre del proyecto " (corte preliminar)".
  3. Resume en unas pocas líneas: qué se cortó (retomas, muletillas, pausas, segundos ahorrados) y la apariencia y el sonido aplicados.
  4. Finaliza sugiriendo que, si el usuario pule la edición a mano, le pida a Claude que ejecute learn_from_edit (con save=true y look_name) para que el próximo corte preliminar coincida con su estilo. Para el primer vlog después de los reels, ejecútalo con save=false y registra la configuración de pausa sugerida para vlogs con update_style add_note, para que no se sobrescriban los valores predeterminados de los reels.

Reglas

  • Nunca cambies nada antes de que el usuario apruebe el plan en el paso 2.4.
  • Nunca edites su proyecto original; envía siempre uno nuevo.
  • Los medios en un disco externo deben estar conectados.
  • Si una herramienta falla debido a permisos de macOS, indícales que vayan a Configuración del Sistema > Privacidad y Seguridad (Accesibilidad, y Automatización para la aplicación que ejecuta Claude Code).

Skills relacionados