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"
#    flags: --no-captions  --no-zoom

helpers/

• transcribe.py — faster-whisper: large-v3-turbo en float16 sobre la GPU, y small int8 en CPU cuando no hay tarjeta o le faltan las librerías de CUDA. Escribe transcript.json (segmentos con timestamps por palabra) y takes_packed.md (vista compacta para que el LLM razone el corte).
• vidorq_render.py — motor de render:
  • Cortes: solo los keep-segments del EDL, en orden, con fades de audio de 30 ms en cada frontera (sin pops).
  • Punch zoom: zoom por segmento (p. ej. 1.06) = crop central estático + reescalado. Sin keyframes (respeta la filosofía del MVP).
  • Captions: chunks Hormozi de 2 palabras UPPERCASE renderizados con PIL (Arial Black, contorno + sombra) y compositados como overlay. Este build de PyAV no trae drawtext/libass.
  • Salida vídeo con h264_nvenc (GPU). Vídeo y audio se renderizan por separado y se muxean.