Communitygithub.com

multi-video-variants

Convierte UN video aprobado en múltiples variantes (diferentes relaciones de aspecto, hooks, versiones para plataformas, sin música/sin subtítulos) manteniendo control de versiones y un manifiesto que bloquea derivados obsoletos.

¿Qué es multi-video-variants?

Este skill está diseñado para flujos de trabajo de edición de video donde se necesita producir múltiples salidas a partir de un único máster aprobado, garantizando trazabilidad y consistencia. Gestiona toda la matriz de variantes: congelamiento del máster, re-diseño de layout por aspecto, mezcla de audio compartida, nomenclatura estricta, cola de renderizado (una tarea pesada a la vez) y un manifiesto que verifica la validez de cada derivado. Soporta plataformas como Meta, TikTok, YouTube, Instagram, LinkedIn y X (Twitter), y permite variantes de hook, sin música, sin subtítulos y versiones de diferente duración. El skill no diseña el máster original (eso lo hace otro skill) ni reemplaza la QA por archivo. Utiliza reglas estrictas: el máster debe pasar QA completa antes de cualquier derivado, los re-layouts son copias con su propio canvas (nunca recortes del máster renderizado), y no se permite más de un trabajo pesado simultáneo. El manifiesto (`manifest.json`) y el script `manifest_check.py` son los guardianes que aseguran que todo derivado esté actualizado y sea válido antes de declarar "listo".

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/multi-video-variants

Preguntar en tu IA favorita

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

Documentación

¿Qué hace multi-video-variants?

Convierte UN máster aprobado en N salidas sin perder el control de qué archivo proviene de qué estado fuente. Gestiona la matriz de variantes, la congelación del máster, las copias de re-diseño, la mezcla compartida, la nomenclatura, la cola de una renderización a la vez, las reglas de supervisión del agente y la puerta del manifiesto. No diseña el máster (eso lo hace el skill de tipo) y no reemplaza la QA por archivo (render-qa-deliver).

Reglas que prevalecen sobre el resto de este archivo

  1. Máster primero, luego congelado. Los derivados se crean únicamente a partir de un máster que pasó su propia QA completa y se registró con manifest_check.py freeze. Una corrección necesaria posterior se realiza en el MÁSTER, se registra con change, se traslada a cada copia en la misma ronda, y cada derivado se vuelve a renderizar y registrar. Está prohibido corregir solo una copia.
  2. Re-diseño, nunca recorte. Cada aspecto es una copia de la fuente del máster (hf_9x16/, hf_1x1/ …) con su propio canvas, zonas seguras, escala de texto, carril de subtítulos, claves de cámara y centrado de rostro. Un recorte o escala FFmpeg de un máster renderizado no es una variante.
  3. Una mezcla. Los re-diseños y las variantes de hook usan el mismo cues.js y los mismos bytes de assets/mix.wav y se multiplexan desde ese único archivo; el audio no se reconstruye por variante. Una variante que realmente necesita su propia mezcla (sin música, locución propia, duración recortada) lo declara en el manifiesto con una razón.
  4. Un trabajo pesado a la vez en toda la máquina (render, check, matte, ASR, Blender) bajo render_lock. El trabajo en paralelo se limita a tareas no pesadas (layout, especificación, lectura de QA). Máximo 4 agentes en paralelo, cada uno con máximo 2 sub-agentes.
  5. "Listo" se calcula, no se afirma. La palabra solo se permite cuando manifest_check.py check sale con 0. Un tiempo de espera, carpeta vacía, hash faltante, qa: not_run o evidencia faltante es bloqueado / EVIDENCIA_INSUFICIENTE, nunca aprobado.
  6. No hay acción paga sin paid-generation-gate; nunca mensajes a otra sesión de Claude; las restricciones de usuario y proyecto anulan este procedimiento. Las zonas seguras, -14 LUFS y los canvases son preajuste de casa v1 (decisión predeterminada Q5), no ley de plataforma.

Entradas -> salidas

Entrada: máster aprobado (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) y la matriz de variantes del intake. Salida: final/<nombre>_<plataforma>_<hook>_<aspecto>.mp4 x N, final/manifest.json (finales + manifiesto únicamente), informes de QA por archivo en _work/qa/<aspecto>/<ronda>/, _work/agents/<agente>.progress.md, _work/STATE.md (cola). Nomenclatura: <nombre>_<plataforma>_<hook>_<aspecto>.mp4, <nombre> un slug ASCII en minúsculas (se permiten guiones bajos), <plataforma> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-sinmusica | hookA-sinsubs, <aspecto> = 9x16|4x5|1x1|16x9. También se acepta la forma corta por relación <nombre>_<aspecto>.mp4 (plataforma all, hook master, como en el playbook de entrega). Un nombre que el usuario solicitó en el ledger anula la convención y se registra con su id de ledger (record --name-ledger-id).

Procedimiento

#EtapaHacerArtefacto
0Matriz en intakeuna fila del ledger por archivo: aspecto, plataforma, ruta (orgánico / anuncio / spark), hook, versión (completa, sin música, sin subtítulos, duración), aspecto del máster. Relaciones "quizás" tardías: escribir notas de layout ahora para que una solicitud tardía sea un agente, no una reconstrucción (references/variant-matrix-and-layout.md)matriz en PROMPT.md <inputs>; lista matrix en el manifiesto
1Puerta del mástermáster aprobado, QA de todos los fotogramas de render-qa-deliver aprobada, manifest_check.py freeze <project> --hf hf --matrix ...src_hash congelado + mix_sha256
2Copias de re-diseñoun agente por aspecto en una COPIA; mismas cues y mezcla; llenar la tabla de layout (qué cambió por elemento, references/variant-matrix-and-layout.md); preflight 0 errores; instantánea de superposición en hook, oferta, tarjeta final (--describe false, máximo 5 marcas de tiempo por llamada)hf_<aspecto>/, _work/qa/<aspecto>/layout.md
3Variantes de hook / versiónhook = sub-composición vinculada a variables en la copia del aspecto, una fila por variante; probar UNA variación primero (las variables por lote no están probadas en un proyecto); multiplexar la mezcla compartida; sin música / sin subtítulos = variantes de mezcla o capa declaradasrows.json, archivos de variante
4Colaescribir el orden de renderizado en _work/STATE.md (máster, luego cada aspecto, luego variantes); manifest_check.py stamp ANTES de cada render; renders a través de hf_deliver / render_lock run uno a la vez; un propietario de render nunca inicia un segundo trabajo pesadoregistro de bloqueo, sellos
5Registrodespués de cada render: record (hashes, correcciones del máster aplicadas, variante de mezcla, estado de QA, sonoridad medida en el archivo FINAL)manifest.json
6QA por salidaframe_qa, caption_qa --band <top>:1450 (9:16), motion_qa si el layout cambió el movimiento, face_center audit para metraje del hablante, qa delivery; ejes de revisión visual solo 1 (composición/recorte) y 4 (legibilidad); ejes 2-3 heredados a menos que el movimiento haya cambiadoinformes + rutas de evidencia
7Puerta de listomanifest_check.py check <project> --json sale con 0; mostrar al usuario la lista de archivos con hash fuente, estado de QA, LUFS/TP; enumerar las brechas honestamenteInforme LISTO
8Aprendizajelíneas del ledger de tiempos por archivo, lecciones para el Bandeja de entrada_work/timing_ledger.jsonl

Puertas

Los estados son aprobado | fallido | bloqueado | n/a con una razón. Un tiempo de espera, muestra vacía o entrada faltante es bloqueado, nunca aprobado. Una llamada a herramienta exitosa es evidencia de ejecución; un render visualizado es evidencia de apariencia.

PuertaPredicadoEvidenciaSi es falsoPropietarioRevisar cuando
G1 matrizcada salida tiene una fila del ledger (aspecto, plataforma, ruta, hook, versión) antes de cualquier compilaciónmatrix en PROMPT.md y manifiestopreguntar el eje faltante ahora; no compilareste skill + video-intakecualquier nueva solicitud de relación/variante
G2 máster congeladomáster pasó QA completa; freeze registrado; ningún derivado iniciado antesmaster.src_hash, frozen_utc más antiguo que cualquier sellodetener derivados; congelareste skillcualquier cambio en la fuente del máster
G3 re-diseñocada derivado tiene su propio canvas raíz, fila de layout por elemento, zonas seguras de su aspecto; sin render recortado del másterfilas de layout.md + instantáneas de superposición + preflight 0 Ere-diseñar el elemento fallido; no escalar todo el fotogramael agente del aspectocambio de layout del máster, nueva copia
G4 activos compartidoscues.* y assets/mix.wav idénticos al máster en cada copia de re-diseño/hook; las variantes de hook multiplexan, no remezclanmanifest_check.py check: sin M035/M041copiar las cues/mezcla del máster; re-renderizareste skillcambio de cues o mezcla del máster
G5 QA por salidacada archivo qa: pass con un archivo de evidencia y LUFS -14 +/- 0.5, TP <= -1 en el archivo final (puerta de casa)ruta qa_evidence, números lufs, tp en el manifiestocorregir y re-renderizar SOLO ese archivorender-qa-delivercualquier re-render
G6 disciplina de trabajo pesadoexactamente un trabajo pesado a la vez; <= 4 agentes, cada uno <= 2 sub-agentes, cada uno con lista de archivos, archivo de salida, fecha límite, archivo de progresoregistro render_lock; mtimos de _work/agents/*.progress.mdponer en cola, detener el trabajo extra (solo su propio árbol de procesos)este skillcada lanzamiento de agente
G7 manifiesto listoobsoletos / huérfanos / faltantes / cambiados-después-del-render todos ausentesmanifest_check.py check sale con 0enumerar los archivos fallidos al usuario; re-renderizar los obsoletosmanifest_check.pyantes de decir "listo", después de cualquier cambio

Números (preajuste de casa v1, con fecha 2026-10-02, detalles en references/house-presets.md)

  • Canvases: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps predeterminado.
  • Zonas seguras, texto clave/CTA/logo/precio: 9:16 superior 300 / inferior 672 (y <= 1248) / izquierda 140 / derecha 192, carril de subtítulos inferior <= y 1450; 16:9 x <= 1824, superior 54, inferior 162; 4:5 y 1:1 54 px cada lado. No verificado en dispositivos: ejecutar el ejercicio de superposición.
  • Sonoridad: -14 LUFS integrado +/- 0.5, pico verdadero <= -1 dBTP, medido en el archivo final; TP intermedio de mezcla <= -1.5.
  • Supervisión: verificación de latido cada 15 min aproximadamente; silencioso o pasado su plazo por 20 min = revisar, reemplazar o detener; línea de estado al usuario cada 10 min de silencio aproximadamente; tiempo de espera de render 3 x el ETA medido. (fuente: flujo de trabajo destilado 02 §13.6, 2026-10-01)

Reglas de decisión

SiEntonces
se necesita una corrección del máster después de que existan derivadoscorregir el MÁSTER, change, llevar el parche a cada copia, re-renderizar y registrar todos
una copia necesita sincronización o cues diferenteseso es un cambio del máster; o una nueva edición (recut) con sus propias líneas de ledger, nunca una bifurcación silenciosa
un hook necesita una línea hablada diferentedeclarar own-vo con una razón; cada otra variante permanece en la mezcla compartida
se solicita una relación tardeescribir la tabla de layout, lanzar UN agente en una copia del máster congelado; no tocar el máster
se solicitan dos renders a la vezponerlos en cola; el bloqueo decide; escribir el orden en STATE.md
un agente está silencioso pasado su plazorevisar su archivo de progreso, luego reemplazarlo o detenerlo (solo su propio árbol de procesos), luego render_lock status
la carpeta de finales contiene un render antiguomoverlo a _work/delivered/v<N>/; "listo" está bloqueado hasta que la carpeta coincida con el manifiesto
el usuario nombra los archivossu nombre gana; registrarlo con --name-ledger-id y mantener los campos plataforma/hook/aspecto explícitos

Estados bloqueados (reportarlos, no sortearlos)

manifest_check.py BLOQUEADO o EVIDENCIA_INSUFICIENTE; un derivado con un from_master obsoleto o una corrección del máster faltante; una fuente cambiada-después-del-render; desviación de cues o mezcla compartida; qa no aprobado; una variante prometida faltante; un archivo no planificado presente. Decir qué archivo, qué código y la corrección.

Errores comunes que cuestan tiempo real

Solicitud tardía de 16:9 en la entrega (un re-diseño completo, descartado); una corrección del máster de 3.7 s no trasladada al 1:1; un render antiguo dejado junto a los nuevos y nadie lo señaló; un agente derivado que encontró un error del máster y corrigió solo su copia; tres agentes renderizando a la vez (un trabajo paralelo de Blender duplicó un render, de 11.5 a 21.5 min, portátil del propietario); colisiones de nomenclatura entre cortes de Meta y TikTok; una variante de hook que llevaba silenciosamente una mezcla diferente. Una hoja de contactos visualizada de cada aspecto sigue siendo necesaria: los hashes no pueden ver un subtítulo sobre un rostro.

Referencias (cargar cuando)

  • references/variant-matrix-and-layout.md - escribir la matriz, re-diseñar un aspecto, variantes de hook/sin música/sin subtítulos/duración.
  • references/manifest-schema.md - registrar archivos, leer los hallazgos de manifest_check.py, el ciclo de vida de derivados obsoletos.
  • references/parallel-and-agents.md - lanzar agentes, cola, bloqueo, latidos, detención, presupuesto de tokens.
  • references/house-presets.md - antes de citar cualquier canvas, zona segura, sonoridad o número de plataforma (módulo con fecha).
  • agent-content/references/platform-specs.md (hechos canónicos de plataforma, propiedad de otro) y agent-content/playbooks/wf-08-deliver.md (playbook de entrega: nomenclatura, reglas del manifiesto) - preajustes de exportación y el playbook; si un número difiere, el archivo canónico gana y references/house-presets.md se actualiza.
  • Otros skills: render-qa-deliver (QA por archivo), hebrew-captions-asr (carril de subtítulos), edit-ad-promo (ranking de hooks), revision-round (notas entre aspectos), paid-generation-gate.
  • Scripts: scripts/manifest_check.py (--self-check 29 casos, salida 0 LISTO / 1 BLOQUEADO / 2 EVIDENCIA_INSUFICIENTE) y scripts/test_manifest_check.py (prueba unitaria).

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

Skills relacionados