Communitygithub.com

CutPilot — edición AI multitrack local y ship

Edición AI local-first: inspecciona footage, planes de corte alineados a narración, timeline de review embebida, captions, motion Remotion, interchange FCPXML/CapCut-JianYing, render local. Incluye cutpilot-logo.png.

¿Qué es CutPilot — edición AI multitrack local y ship?

Short-form Editing paso 3 (timeline ship): Hellotravisss/cutpilot — índice semántico + Director Agent + UI multitrack → MP4 local aprobado. Cierra la receta de la mañana tras score de claude-shorts y reframe de Easel clipify.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Hellotravisss/cutpilot/tree/HEAD/skills/cutpilot-video-editing

Preguntar en tu IA favorita

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

Documentación

Edición de video con CutPilot AI

CutPilot es un flujo de trabajo de edición local y Codex-first con una línea de tiempo de revisión manual integrada. Codex toma decisiones editoriales a partir del resumen, la narración, los metadatos y las hojas de contacto del usuario; las herramientas de CutPilot hacen que esas decisiones sean reproducibles y renderizables, mientras que el usuario puede ajustar directamente los detalles compatibles de la línea de tiempo.

Flujo de trabajo

  1. Llama a inspect_media_folder en la carpeta proporcionada por el usuario. No subas los originales.
  2. Lee el manifiesto devuelto e inspecciona las imágenes de la hoja de contacto generadas cuando la selección visual sea importante.
  3. Identifica el archivo de narración según la denominación o instrucción del usuario. Pregunta solo por opciones creativas que no se puedan inferir.
  4. Inspecciona las hojas de contacto, luego llama a annotate_assets con descripciones visuales y etiquetas basadas en hechos. No adivines contenido no visto. Construye build_semantic_index después de cambios sustanciales en los activos.
  5. Prefiere search_semantic_assets para rangos exactos de activos, subclips de escenas y transcripciones. Pasa los ID de activos ya utilizados en avoidAssetIds cuando el usuario quiera menos repetición. Usa rank_assets_for_narration solo como alternativa ligera.
  6. Redacta un plan de corte con tomas frecuentes y con coincidencia semántica. Cada clip visual necesita una ruta de origen, inicio de línea de tiempo, inicio de origen y duración. Nunca repitas una toma a menos que el usuario lo solicite o la repetición tenga un propósito editorial claro.
  7. Resume la estructura propuesta y obtén la aprobación antes de una renderización costosa, a menos que el usuario haya solicitado explícitamente ejecutar la acción de extremo a extremo.
  8. Llama a render_project después de la aprobación. Entrega el MP4 junto con el proyecto JSON.

Valores predeterminados editoriales

  • Coincide lo visual con el significado hablado: código cuando se menciona código, imágenes de bodas cuando se menciona trabajo de bodas, detalles de fábrica para narración sobre fábrica.
  • Prefiere más cortes con propósito en lugar de mantener un clip genérico demasiado tiempo.
  • Conserva la narración como audio principal y silencia el metraje B-roll a menos que el usuario solicite sonido natural.
  • Usa 9:16, 1080x1920, 30 fps para video social vertical, a menos que el usuario especifique lo contrario.
  • Mantén los archivos originales intactos.

Flujo de trabajo primero en el proyecto

Para una edición duradera, prefiere las herramientas del proyecto v0.2:

  1. create_project
  2. import_assets
  3. inspect_media_folder
  4. edit_timeline
  5. validate_project
  6. read_project
  7. transcribe_asset cuando se necesiten tiempos de transcripción. Usa download_transcription_model una vez si no hay modelo disponible.
  8. set_captions y export_subtitles cuando se soliciten subtítulos.
  9. render_project después de que el usuario apruebe el corte.
  10. Usa edit_item_effects y set_transition para estilos de clip no destructivos.
  11. Usa create_motion_graphic / update_motion_graphic para títulos editables, tercios inferiores y tarjetas de información.
  12. Usa generate_voiceover para TTS privado de macOS, o register_generated_asset para preservar la procedencia de medios creados por generadores externos.
  13. Llama a create_project_snapshot antes de una revisión autónoma sustancial. Usa list_project_snapshots y restore_project_snapshot cuando el usuario quiera comparar o deshacer una dirección.
  14. Para proyectos Vlog, llama a get_vlog_workflow_status para encontrar la primera etapa incompleta basada en evidencia y su siguiente herramienta recomendada.
  15. Usa submit_vlog_release_export para el MP4 final. Siempre vuelve a ejecutar la verificación de requisitos estricta y se niega a exportar mientras haya bloqueadores.
  16. Después de renderizar, llama a inspect_rendered_video e inspecciona visualmente su hoja de contacto. Trata las advertencias de segmentos negros/congelados como pistas, no como fallos editoriales automáticos.
  17. Usa export_interchange con fcpxml para Resolve/Final Cut o edl para una transferencia simple de video principal.
  18. Usa submit_generation una vez por imagen/video/música/SFX solicitados. Usa track_generation para el estado y la materialización; no coloques un resultado generado antes de que el usuario lo haya revisado cuando la generación cueste dinero.
  19. Usa edit_item_transform para posición, tamaño, rotación, ajuste y animación de entrada/salida/flotación explícitos. Inspecciona varios fotogramas para que el movimiento transitorio no se confunda con un diseño roto.
  20. Usa create_motion_graphic_from_svg para gráficos basados en propiedades creados directamente. Declara cada {{property}}, mantén los recursos externos fuera del SVG y usa update_svg_motion_graphic para cambios posteriores de texto/color/origen.
  21. Usa fotogramas clave de transformación ordenados para coreografía intencional x/y/rotación. Usa cross-dissolve solo en un límite contiguo de clips adyacentes e inspecciona fotogramas de antes, durante y después de la transición.
  22. Cuando el usuario quiera inspeccionar o ajustar manualmente la edición de IA, llama a open_review_session con el proyecto real y la vista previa más reciente, luego abre su URL de localhost en Codex. Ciérrala con close_review_session cuando la página en vivo ya no sea necesaria.
  23. Las escrituras en la interfaz de revisión son ediciones reales del proyecto. Crean instantáneas automáticamente y rechazan tiempos, opacidad, superposiciones, tokens caducados y rangos de medios mal formados no válidos.
  24. Usa split_item o razor_all_tracks para cortes continuos de origen. Usa trim_item para cambios de límite, ripple_delete_item para eliminar tiempo y insert_timeline_gap para abrir tiempo mientras se conservan los medios que se cruzan mediante divisiones automáticas.
  25. En la interfaz de revisión, los usuarios pueden arrastrar cuerpos de clip, arrastrar manijas de recorte, dividir en el cabezal de reproducción, aplicar eliminación de ondulación, insertar espacios globales, establecer transiciones de salida e inspeccionar formas de onda generadas reales.
  26. Las opciones de transición incluyen fundido, fundido a negro, encadenado, cuatro barridos direccionales, revelado radial y cuatro diapositivas direccionales. Usa transiciones avanzadas solo en límites de clips adyacentes contiguos y verifica un fotograma intermedio.
  27. Los puentes de generación con nombre usan MYCUT_SEEDANCE_ENDPOINT, MYCUT_KLING_ENDPOINT, MYCUT_MUREKA_ENDPOINT o MYCUT_SFX_ENDPOINT, con variables _TOKEN opcionales coincidentes. Preservan la semántica de enviar/estado/materializar; no reclames que un proveedor pago fue probado en vivo a menos que ese endpoint estuviera realmente configurado y llamado.
  28. Usa edit_item_keyframes para animación x/y/escala/rotación/opacidad. La suavización se almacena en el fotograma clave izquierdo y puede ser lineal, suave al inicio, suave al final, suave al inicio y al final, mantener o controles Y Bezier personalizados. Verifica varias veces renderizadas.
  29. Usa list_glsl_presets y apply_glsl_preset para efectos WebGL integrados, o edit_item_effects con tipo glsl para código de fragmento escrito directamente. Mantén las declaraciones u_texture, u_time, u_progress y u_resolution compatibles con WebGL1 y verifica el renderizado compilado.
  30. Usa create_jsx_motion_graphic para componentes React basados en fotogramas y update_jsx_motion_graphic para cambios posteriores en el origen/Props. Define MotionGraphic; se proporcionan React y fotograma/fps/progreso/dimensiones. Verifica transparencia y múltiples fotogramas.
  31. Usa export_interchange con premiere-xml para Premiere Pro, fcpxml para Final Cut/Resolve o edl para una lista de cortes simple. Usa import_fcpxml o import_premiere_xml para crear un nuevo proyecto de CutPilot a partir de XML local de NLE, luego valida y verifica la renderización de la línea de tiempo importada.
  32. Usa export_jianying_draft solo cuando el usuario acepte la compatibilidad experimental de texto plano heredada. Siempre informa que los borradores modernos de Jianying están encriptados/dependen de la versión y llama a validate_jianying_draft; nunca reclames compatibilidad de apertura de aplicación sin haber lanzado la aplicación de destino con éxito.
  33. Usa list_caption_templates y update_caption_style para subtítulos enriquecidos. Habilita karaoke solo cuando existan marcas de tiempo de palabras, luego verifica varios intervalos de palabras en el renderizado horneado.
  34. Usa edit_item_playback para velocidad constante 0.1x-16x, curvas de velocidad editables, inversión o fotogramas congelados de video. Los puntos de la curva usan tiempo de línea de tiempo local del clip más velocidad y suavización; la duración de la línea de tiempo permanece fija mientras la curva integrada determina el rango de origen. El audio sigue la misma curva con estiramiento de tiempo segmentado que preserva el tono.
  35. Usa edit_item_effects para pilas visuales no destructivas ordenadas. chroma-key elimina un color RGB seleccionado con controles de similitud/mezcla; mask admite geometría de rectángulo/elipse, desvanecimiento e inversión; color-grade, curves y vignette proporcionan acabado local. Verifica la transparencia contra una pista de video inferior e inspecciona píxeles centrales/bordes/esquinas.
  36. Usa edit_item_audio_effects para procesamiento de audio por clip ordenado. La limpieza de voz generalmente comienza con paso alto, puerta, ecualizador, compresión y de-essing; estéreo y tono son herramientas creativas. El tono preserva la duración de la línea de tiempo. Mide el espectro real del renderizado, la dinámica RMS/pico y la energía izquierda/derecha antes de informar éxito.
  37. Usa render_audio cuando el usuario quiera una narración procesada, mezcla de música, podcast o entrega de audio sin video. Elige WAV o FLAC de 24 bits para continuación sin pérdida, MP3 para entrega amplia y M4A para entrega AAC compacta; verifica que el archivo exportado no contenga flujo de video.
  38. Usa list_timelines, create_timeline, duplicate_timeline, activate_timeline, rename_timeline y delete_timeline para secuencias separadas de larga, corta, vertical o cuadrada que compartan una biblioteca de activos. Nunca elimines la última línea de tiempo.
  39. Usa set_timeline_in_out y rango: zona en render_project o render_audio para un rango de exportación seleccionado exacto. El corte por rango preserva el mapeo de origen, las curvas de velocidad, los subtítulos, los marcadores y la sincronización de audio sin modificar la secuencia de origen.
  40. Usa export_motion_graphic para transferir un SVG o Motion Graphic JSX/React como un MOV ProRes 4444 transparente independiente. Verifica tanto el perfil 4444 como un formato de píxeles alfa yuva.
  41. Usa read_transcript_edit para inspeccionar segmentos de transcripción temporizados, luego apply_transcript_sequence para reordenar u omitir segmentos de origen. Esto reconstruye video/audio de persona hablando vinculado y subtítulos de palabras a partir de rangos de origen exactos; no inventes tiempos de segmento aproximados.
  42. Usa create_asset_bin, move_asset_bin, assign_assets_to_bin y list_asset_library para organizar y buscar medios locales sin mover archivos de origen. Usa scan_missing_assets antes de renderizar proyectos importados o movidos.
  43. Usa relink_asset para un reemplazo explícito o relink_missing_from_folder para recuperación masiva de nombres de archivo exactos. Nunca adivines entre coincidencias ambiguas; preserva los ID de activos para que cada referencia de línea de tiempo, transcripción, anotación, etiqueta, contenedor y registro de generación permanezcan intactos.
  44. Los guardados normales del proyecto ingresan automáticamente en un diario de editor persistente de 100 pasos. Usa editor_history_status, undo_project y redo_project para reversiones inmediatas de edición; una edición nueva después de Deshacer borra intencionalmente la rama Rehacer. Mantén instantáneas con nombre para hitos duraderos.
  45. Usa set_timeline_format con 16:9, 9:16, 1:1, 4:3 o 3:4 para cambiar el lienzo editable. Prefiere layoutMode: scale cuando las transformaciones, fotogramas clave, máscaras y subtítulos existentes posicionados por píxeles deban adaptarse al nuevo lienzo.
  46. render_project acepta resolution (original, 1080p, 720p, 480p) y frameRate (24-60) no destructivos. Verifica las dimensiones reales de FFprobe y la velocidad de fotogramas; estas anulaciones de salida no deben mutar la secuencia de origen editable.
  47. Usa create_track, rename_track, reorder_track, edit_track y delete_track para el ciclo de vida explícito de pistas. El orden de las pistas determina el orden de composición de video; el video silenciado está oculto, el audio silenciado está en silencio y las pistas bloqueadas rechazan ediciones.
  48. Configura set_timeline_snapping en fotogramas. Usa snap_timeline_time para vista previa de una guía o move_item/trim_item ajustado para alinear con bordes de clip, marcadores, Entrada/Salida, cabezal de reproducción o inicio de línea de tiempo. Nunca fuerces un ajuste más allá de la tolerancia o en una superposición.
  49. Usa set_edit_context para referencias exactas al estilo ChatCut a activos, elementos de línea de tiempo, tiempos de línea de tiempo, regiones de lienzo o rangos de transcripción de origen. Llama a resolve_edit_context antes de actuar para que las decisiones de IA se vinculen a ID reales y objetos temporizados. Los cambios de selección persisten localmente pero intencionalmente no entran en Deshacer/Rehacer.
  50. Comienza un nuevo trabajo con list_project_starters y create_project_from_starter cuando un escenario conocido se ajuste. Los iniciadores crean pistas con nombre reales, roles de enrutamiento, contenedores, subtítulos, ajuste, un resumen creativo guardado y un flujo de trabajo recomendado. Usa configure_project_starter solo mientras cada línea de tiempo esté vacía; nunca sobrescribas una secuencia editada con un iniciador.
  51. Usa place_asset_on_timeline para el montaje del monitor de origen. Establece la Entrada/Salida de origen exacta y una pista de destino compatible. append usa el final de la pista de destino; insert abre tiempo en todas las pistas desbloqueadas y desplaza subtítulos/marcadores; overwrite cambia solo el rango de destino mientras preserva los restos izquierdo/derecho continuos de origen.
  52. Usa place_linked_av cuando el audio original de un activo de cámara/video deba permanecer sincronizado. Los miembros vinculados comparten linkGroupId; usa move_linked_group y trim_linked_group para ediciones atómicas seguras de sincronización, o unlink_timeline_items antes de un ajuste independiente intencional. Rechaza colisiones y miembros bloqueados en lugar de desincronizarlos.
  53. Prefiere submit_export_job para exportaciones largas o visibles para el usuario para que Codex siga respondiendo. Sondea read_export_job o list_export_jobs; informa la fase exacta y la ruta de salida, y usa cancel_export_job solo cuando se solicite. Los trabajos se renderizan a partir de una instantánea de proyecto inmutable, por lo que las ediciones posteriores de la línea de tiempo no pueden cambiar silenciosamente una exportación en curso.
  54. Usa analyze_asset_silence antes de proponer la eliminación de pausas. Muestra los rangos de silencio detectados, el umbral, la duración mínima, el relleno de borde de respiración y el tiempo total eliminado. Llama a apply_silence_cut solo después de que se acepten los rangos; reconstruye AV vinculado continuo de origen y reasigna subtítulos de transcripción. Nunca trates cada pasaje tranquilo como desechable editorialmente.
  55. Usa analyze_asset_scenes en archivos de B-roll o cámara largos cuando los límites de las tomas sean importantes. Revisa sus tiempos de corte y la hoja de contacto antes de save_scene_subclips; luego anota/etiqueta subclips o búscalos con list_asset_subclips. Usa place_asset_subclip para preservar la Entrada/Salida de origen exacta detectada en lugar de aproximar un rango de toma.
  56. Usa analyze_asset_beats para inspeccionar música local antes de editar al ritmo del corte. Revisa BPM, posiciones de ritmo, sensibilidad e intervalo mínimo antes de save_beat_markers. Construye

…

[truncado para traducción]

Skills relacionados