skill

Vidorq skill — edición por IA (v1)

Pipeline de edición que corre desde Claude Code. Hay dos salidas y las dos funcionan: el render directo (PyAV + NVENC), que no necesita Resolve para nada, y el timeline editable dentro de Resolve a través del puente. Auditadas las dos con el mismo encargo el 19-ago-2026. Documentación interna en español (regla D).

Flujo

video crudo ──► transcribe.py ──► transcript.json + takes_packed.md
                                          │
                            (el LLM lee y razona el corte)
                                          ▼
                                     edl.json  ──► vidorq_render.py ──► final.mp4
                                    (keep-segments + zoom)   (cortes + punch zoom + captions)

Uso

# El intérprete con faster-whisper, PyAV, Pillow y onnxruntime dentro. En una
# instalación normal es el entorno de Vidorq; si usas otro, apúntalo aquí.
PY="$PWD/.venv/Scripts/python.exe"

# 1) Transcribir (word-level, local)
"$PY" skill/helpers/transcribe.py "<video>" "<out_dir>" es

# 2) Autorar edl.json a partir de takes_packed.md  (paso de razonamiento del LLM)
#    formato: {"strategy": "...", "segments": [{"start","end","zoom","note"}, ...]}

# 3) Renderizar
"$PY" skill/helpers/vidorq_render.py "<video>" "<out_dir>/edl.json" "<out_dir>/transcript.json" "<out_dir>/final.mp4"
#
#    Los que casi siempre importan:
#      --export <destino>   a dónde va el archivo, y con eso el caudal, el audio
#                           y el volumen ya puestos. Uno de: youtube, youtube4k,
#                           shorts, instagram, x, mensajeria, master.
#                           Sin esto se usa `youtube`.
#      --ratio <forma>      source | vertical | portrait | square | wide
#      --preset <estilo>    el estilo de subtítulo (pop, punch, brasa...)
#      --detras             los subtítulos POR DETRÁS del sujeto. Cuesta unos
#                           6 minutos por minuto de vídeo, así que se pide.
#                           Si el vídeo no tiene un sujeto que recortar lo dice
#                           por `MASCARA_NO:` y entrega el vídeo con los
#                           subtítulos delante, en vez de con manchas encima.
#      --curva <nombre>     CÓMO entran el texto y los rótulos: suave, rapida,
#                           muelle, atras, elastica, rebote o lineal. Sin esto,
#                           cada animación usa la suya, que ya es de calidad.
#      --no-captions        sin subtítulos
#      --no-zoom            sin punch zoom
#
#    Escribe en stdout, una línea por cosa, para poder seguirlo desde fuera:
#      PROGRESS <hechos> <total>   avance; con --detras el total es el doble,
#                                  porque cada fotograma se toca dos veces
#      EXPORT: ...                 qué tamaño y qué caudal se van a usar
#      VIDEO_OK / AUDIO_OK / MUX_OK / DONE
#      SIN_AUDIO:                  el vídeo de origen es mudo y sale mudo