alexey1312/Vibe-Editing-Agent-Skill

Vibe editing: el montaje

Convierte tomas brutas en un montaje que conserva el significado, luego entrégaselo al motor para los gráficos. El agente propone y escribe; el renderizador calcula fotogramas; el autor decide y acepta. Aprueba la historia antes del diseño: cada cambio de significado después de los gráficos obliga a una reconstrucción.

• Rutas y herramientas según el material: references/routes.md
• La EDL y los dos relojes: references/edl-format.md
• Transcripciones y reconocedores: references/transcripts.md
• Cortar el discurso: references/cutting.md
• Subtítulos: references/captions.md
• Sonido: references/audio.md
• Inserciones, diseños, 9:16, otros idiomas: references/inserts-and-layouts.md
• Grabaciones de pantalla: references/screen-recordings.md
• Carpeta, brief y project.md: references/project-memory.md
• Notas que da el autor: references/edit-requests.md
• Datos, licencias y dinero: references/data-and-licences.md
• Formato del plan: references/plan-format.md
• Lo que este repositorio midió: references/measured-behavior.md
• Versiones y fechas: references/versions.md
• Citas: references/sources.md

Contrato

• La Fase 1 es de solo lectura. El informe de la cadena de herramientas, el inventario de medios, la lectura de transcripciones existentes y la escritura del plan no cambian nada ni envían nada a ningún lado.
• No se corta, renderiza, sube, instala ni se realiza una llamada de pago sin la aprobación de los ID de los elementos (references/plan-format.md). "Hazlo más corto" antes de que exista un plan es una solicitud del plan.
• Los originales nunca se modifican. Las copias de trabajo van a work/, los renders a renders/, las entregas a exports/. edl.py render se niega a sobrescribir una fuente o un archivo existente sin --force.
• Dos relojes. Tiempo de origen para las tomas, tiempo de salida para todo lo que ve un espectador; convierte con edl.py map y edl.py retime, nunca a mano.
• Cita o etiqueta. Una afirmación sobre una herramienta cita references/sources.md o una sección Medido; las versiones y los precios provienen de references/versions.md con su fecha; un juicio de gusto o significado se etiqueta como tal.
• Informa la verificación con honestidad. Una verificación de fotogramas pierde el ritmo; un script pierde el significado. Di lo que se vio, se escuchó, se escaneó — y lo que no.

1. Vuelo previo

python3 scripts/toolchain_report.py --format markdown
python3 scripts/media_probe.py originals/ --format markdown

• El informe de la cadena de herramientas dice lo que esta máquina puede hacer: renders precisos por fotograma, quema de subtítulos (muchas compilaciones de FFmpeg no pueden, Medido M7), medición de sonoridad, reconocimiento de voz local, HyperFrames, Remotion; y qué nombres de claves de API están configurados (nunca sus valores).
• El inventario señala lo que cambia el montaje: frecuencia de imagen variable (MED001), rotación (MED002), HDR (MED010), frecuencias de imagen o formatos de audio mixtos (MED004, MED005); reglas en CHECKS.md en el repositorio de esta habilidad.
• Lee las instrucciones propias del proyecto y project.md si existen.
• Escribe el brief, o pregunta por lo que le falta: visor y mensaje, entrega, debe-quedarse, no-debe, nube (references/project-memory.md).

2. Ruta

Elige la ruta a partir del material y el entregable (references/routes.md). Esta habilidad controla el montaje: tomas, uniones, la EDL, el render, los subtítulos y el sonido en la nueva línea de tiempo. Los gráficos pertenecen a las habilidades del motor: HyperFrames (hyperframes, general-video, hyperframes-core) o Remotion (remotion-best-practices). Los subtítulos o superposiciones sobre metraje que no debe cambiar pertenecen a embedded-captions o talking-head-recut.

3. Transcripciones

• Marcas de tiempo por palabra por fuente, creadas una vez, guardadas en transcripts/ (references/transcripts.md).
• El reconocimiento en la nube envía audio y cuesta dinero; el reconocimiento local necesita una instalación. Ambos esperan la aprobación, con el proveedor, el costo y los datos nombrados en el plan.
• Corrige nombres y números contra un glosario antes de planificar cualquier corte.

4. Planificar la historia

1. Tabla del material: fuente, entrada–salida, frase textual, sonido, lo que es visible, posible función.
2. Tres aperturas, cada una con lo que el visor entiende en los primeros segundos.
3. Candidatos: python3 scripts/edl.py candidates --words transcripts/<toma>.json — pausas, repeticiones y muletillas a considerar, nunca para cortar automáticamente (references/cutting.md).
4. La historia en latidos, luego edit/edl.json: cada clip con una razón (references/edl-format.md).
5. python3 scripts/edl.py check edit/edl.json --probe, table y cuts --probe: los clips con ambos relojes, y cada intervalo eliminado para que el autor lo lea.
6. Los cortes dudosos van a edit/edl_b.json, no a la versión A.

5. Renderizar el borrador

python3 scripts/edl.py render edit/edl.json -o renders/borrador_v1.mp4 --size 640x360 --preset veryfast

• Cada clip se recodifica en los límites de fotograma, con fundidos de audio de 10 ms, escalado a un tamaño (Medido M1, M3, M4). Un corte con copia de flujo nunca es exacto por fotograma (Medido M2).
• El primer borrador no tiene música, subtítulos ni efectos: solo habla e imagen.
• Escucha cada unión con auriculares; mira los fotogramas a cada lado. Corrige con notas estrechas (references/edit-requests.md) y una nueva versión de la EDL.

6. Subtítulos, sonido, inserciones

• Subtítulos: edl.py retime mueve los tiempos de palabra a la línea de tiempo de salida; captions.py build los agrupa; captions.py check aplica los límites (references/captions.md).
• Sonido: primero el habla, luego la música con silenciamiento, luego los efectos; mide la sonoridad contra el objetivo del brief y establece los objetivos de loudnorm explícitamente (references/audio.md).
• Inserciones: márcalas en la línea de tiempo de salida (edl.py map), aprueba un fotograma fijo, luego constrúyelas en el motor; edl.py hyperframes y edl.py remotion entregan el montaje (references/inserts-and-layouts.md).
• Otros formatos: una versión 9:16 es un nuevo diseño, no un recorte centrado.

7. Entrega

• Ejecuta la revisión antes de dar el video por terminado: la habilidad vibe-editing-review, o al menos python3 scripts/qa_scan.py con el brief, la EDL y los subtítulos.
• Actualiza project.md: versión de EDL aprobada, último render bueno, comandos, activos y licencias, defectos abiertos.

Flujo de trabajo

Fase 1 — Recomendar

1. Vuelo previo: informe de la cadena de herramientas, inventario, brief, instrucciones del proyecto.
2. Plan con references/plan-format.md: fuentes y conversiones; la historia y EDL v1; intervalos eliminados; cortes dudosos; subtítulos, sonido e inserciones; datos, dinero y licencias; lo que no se puede verificar aquí.
3. Pregunta qué ID de elementos aplicar.

Fase 2 — Aplicar y verificar

1. Aplica solo los elementos aprobados, un nivel a la vez: historia, ritmo, texto, imagen, sonido.
2. Después de cada cambio, renderiza o previsualiza el mismo rango con un segundo de contexto, y escucha.
3. Vuelve a ejecutar edl.py check y captions.py check; ejecuta qa_scan.py en cada borrador que vaya al autor.
4. Actualiza los estados de los elementos y project.md; informa lo que no se verificó.

Barreras de seguridad

• No cortes, renderices, subas, transcribas en la nube ni instales nada en la Fase 1.
• No modifiques ni recodifiques archivos en originals/.
• No copies flujo en un corte que deba ser exacto por fotograma.
• No coloques subtítulos o inserciones por tiempo de origen.
• No elimines todas las pausas con un solo umbral, ni sintetices una palabra faltante sin la decisión del autor.
• No imprimas una clave o un token en el chat, un registro o un archivo.
• No agregues música, fuentes o metraje sin una fuente y licencia registradas.
• No invadas el terreno del motor: el código de composición pertenece a las habilidades de HyperFrames o Remotion.