Communitygithub.com

revisión-render-ugc

Puerta de revisión previa a la publicación obligatoria para renders de video UGC. Transcibe el audio del render final con Whisper y compara palabra por palabra con el guion aprobado, bloqueando renders con errores de voz, frases omitidas o silencio.

¿Qué es revisión-render-ugc?

La skill `revisión-render-ugc` es una puerta de control de calidad (QC) determinista para videos generados por usuarios (UGC). Su propósito principal es evitar que se publiquen renders cuyo audio contenga errores de voz (como decir 'humano ingenioso' en lugar de 'humano verificado'), frases omitidas o silencio total. Funciona extrayendo el audio del render final con `ffmpeg`, transcribiéndolo con Whisper (usando `OPENAI_API_KEY` o la CLI local de Whisper) y comparando palabra por palabra con el guion aprobado (`approved-script.txt`). Si la similitud cae por debajo de un umbral (por defecto 0.90), la skill sale con código 2 (FALLO) y bloquea `set_final_render`. Soporta plataformas de línea de comandos, es parte integral de recetas `remix-ugc-*-from-sample` y `create-ugc-*-video-from-refs`, y se ejecuta después del render maestro pero antes de la publicación. Es la versión empaquetada y operativa del átomo `review-transcript-integrity` del motor de revisión content-goose.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/gooseworks-ai/goose-skills/tree/HEAD/skills/ads/packs/ugc-video-formats/review-ugc-render

Preguntar en tu IA favorita

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

Documentación

¿Qué hace revisión-render-ugc?

Puerta de control de calidad que TODA receta de video UGC DEBE superar antes de publicar. No es una revisión visual /watch — es una comparación determinista de transcripción versus guion que sale con código distinto de cero ante un defecto, permitiendo que la receta detenga set_final_render.

Por qué existe

Seedance genera el audio de forma nativa. A veces pronuncia mal una palabra — la línea aprobada verificado-por-humanos se escucha como verificado por humanos; ejemplos documentados: Hume→Hune, Alitu→al-too. El defecto reside en el audio del render, por lo que una revisión visual /watch ("el diálogo coincide con el guion") lo pasa por alto, y un paso posterior de subtítulos incorpora la palabra incorrecta. Nadie comparaba el audio realmente hablado contra el guion que el usuario aprobó.

Esta puerta hace exactamente eso, de forma determinista, y rechaza publicar si hay discrepancia.

Cuándo ejecutar

  • OBLIGATORIO en todas las recetas remix-ugc-*-from-sample y create-ugc-*-video-from-refs, en la fase de QC, después de que exista el render maestro y antes de set_final_render.
  • Vuelva a ejecutar tras cada corrección / reintento hasta que PASE.

Contrato

Antes de renderizar, guarde las líneas exactas aprobadas (la expresión textual, sin anotaciones de entonación) en working/approved-script.txt. Luego, tras el render:

python3 <paquete>/revisión-render-ugc/scripts/review_render.py \
  --video working/final.mp4 \
  --script-file working/approved-script.txt \
  --json working/review-verdict.json
  • exit 0 → ÉXITO — proceda a publicar (set_final_render).
  • exit 2 → FALLO — NO publique. Lea el informe, corrija, vuelva a ejecutar.
  • exit 3 → ERROR — la comprobación no pudo ejecutarse (ver más abajo); corrija el entorno, no publique a ciegas.

Backend de transcripción (por orden de prioridad): OPENAI_API_KEY (respeta OPENAI_BASE_URL, por lo que se enruta a través del proxy Whisper de gooseworks cuando está configurado) → CLI local whisper. ffmpeg debe estar en PATH.

Qué significa FALLO y cómo corregirlo

Línea del informeCausa raízCorrección
[alto] dijo [ingenioso] donde el guion tiene [verificado]Seedance pronunció mal la palabra en el audio generadoRe-intente con una nueva semilla. Si es una marca o token acuñado, deletréelo fonéticamente en la LÍNEA HABLADA (ej. Ali-too, nunca un paréntesis (pronunciado …) — Seedance lee los paréntesis en voz alta). Consulte Modos de Fallo de create-video-seedance-2-fal.
[medio] omitió [...] / baja similitudSeedance omitió una frase aprobadaRe-intente; si solo es una palabra al final, una corrección quirúrgica con stitch_replacement.py puede recuperarla.
⚠ el audio está efectivamente en silencioRender incorrecto / pista de audio perdida en postproducciónVuelva a renderizar / verifique el multiplexado; nunca publique una toma en silencio.
ERROR: no hay backend de transcripciónSin OPENAI_API_KEY ni whisper localConfigure la clave (proxy OPENAI_BASE_URL) o instale whisper, luego vuelva a ejecutar.

--expect-music es solo informativo (advierte si falta un fondo musical); por sí mismo no hace fallar la puerta.

Entradas

  • --video RUTA (obligatorio) — el mp4 maestro renderizado.
  • --script-file RUTA o --script "texto" — el guion hablado aprobado. Omita ambos solo para un clip genuinamente sin guion (la verificación de deriva se omite y la puerta es informativa).
  • --min-ratio FLOTANTE (por defecto 0.90) — similitud de tokens transcripción↔guion para aprobar.
  • --json RUTA — escribe el veredicto de máquina para el panel de revisión de la aplicación.

Pruebas

python3 tests/test_review_render.py    # lógica pura de veredicto; sin audio/red

Cubre el error canónico verificado→ingenioso, errores de marcas, omisiones al final, relleno benigno y la ruta informativa sin guion.

Relación con el motor de revisión content-goose

Esta es la parte empaquetada, de un solo archivo y puerta de control de la rúbrica más completa coworkers/video/molecules/review/review-loop (18 ejes). Aquí imponemos el único eje que detecta defectos de audio versus guion en el momento de la publicación (review-transcript-integrity / brand_text_accuracy). La revisión multi-eje más profunda permanece en el laboratorio de content-goose.

Individual skills in this repo

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

gooseworks-ai/goose-skills

Burned-in captions for a finished vertical video, three kinds. transcribe.py gets word timings from the video's own audio through the GooseWorks proxy (fal Whisper, bills the Ads agent, cents); captions.py burns one to three words at a time with Pillow + ffmpeg (no libass needed), either pinned to a split-screen seam (plate 25% above / 75% below) or at a fixed height, in a plate, outline or one-word serif style, with an optional red hook card; plates.py burns per-beat caption blocks (black, one union silhouette, placed in the emptiest band) for formats with no voice. The last caption (the CTA) holds to the final frame. Use as the last step of any video ad.

gooseworks-ai/goose-skills

Assemble a cartoon / animated / hand-crafted music-video ad from a config — a sung song carries the whole narrative while N per-bar i2v clips (one recurring animated character, one look pack) are each cut to their BAR window from librosa beat-tracking and hard-concatenated on the bar, VEED-whisper white bold-sans captions in the BOTTOM third (Alignment 2, above the logo bug, no pill) burned from the song's word timings re-spelled against the locked lyrics, a persistent brand logo bug held over the body (suppressed on the end card), and closed on a solid-brand-color PIL end card with the song still playing under it — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-bar + hard concat + logo bug + captions + end card + song mux); the song, character, keyframes, and clips come from create-music-elevenlabs / create-image-fal / create-video-fal. Use for the cartoon-music-video format.

gooseworks-ai/goose-skills

Assemble a cinematic live-action-style music-video ad from a config — an original sung anthem carries the whole narrative while N 35mm-film-look i2v clips are each cut to their lyric window and hard-concatenated on the beat as a 3-act arc, the anthem muxed at loudnorm I=-14, cinematic lower-third serif captions built from the song's OWN word timings (never Whisper) with the hook line landing on the chorus drop, and closed on a brand end card composited from the real asset — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-window + hard concat + anthem mux + captions + end card); the anthem, keyframes, and clips come from create-music-elevenlabs / create-image-gpt-image-fal / create-video-fal. Use for the cinematic-music-video format.

gooseworks-ai/goose-skills

Assemble an editorial-motion podcast-clip ad from a config — a real clipped podcast MP3 carries the narrative while N flat limited-palette editorial-illustration keyframes (one look pack) are animated NOT by generative i2v but by DETERMINISTIC ffmpeg ken-burns (zoompan) + hard cuts (no crossfades, which expose geometric drift), each beat snapped to its spoken line, the real audio muxed, Whisper-driven captions burned only mid-sentence, and closed on a PIL brand end card — never AI-rendered text. This is the FREE deterministic assembly stage (ffmpeg ken-burns + hard concat + audio mux + captions + end card); the real audio is clipped from source and the keyframes come from create-image-fal. Use for the editorial-motion-podcast format.

gooseworks-ai/goose-skills

Analyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.

gooseworks-ai/goose-skills

Generate a single 4-15s vertical video clip with ByteDance Seedance 2.0 reference-to-video via fal.ai. Multi-image reference (avatar + product + setting), native lip-synced VO + ambient audio (generate-audio on by default), internal multi-cut handling within one render. Routes through the GooseWorks FAL proxy (bills the Ads agent). The default clip atom for AI-creator UGC ads built on the NB2 + Seedance architecture. Validated on beauty-by-earth/video-01.

gooseworks-ai/goose-skills

Render pixel-accurate Apple Notes (iPhone, light mode) screenshot mockups from a JSON note spec. Outputs HTML + PNG at the iPhone 16/15 Pro native 1180×2556. Supports paragraphs, images, checklists, dividers, autocorrect underline, smart quotes, and an optional iOS keyboard chrome overlay used by the parent video-ad molecule.

gooseworks-ai/goose-skills

Extract competitor and customer intelligence from any company's landing page HTML. Discovers tech stack, analytics tools, ad pixels, customer logos, SEO metadata, CTAs, hidden elements, and more. No API keys required.

gooseworks-ai/goose-skills

Find speakers, hosts, and guest profiles at conferences and events on Luma. Two modes - free direct scrape for hosts, or Apify-powered search for full guest profiles with LinkedIn/Twitter/bio.

gooseworks-ai/goose-skills

Find Twitter/X influencers to promote a product or brand. Use when asked to find influencers, discover Twitter accounts for partnerships, identify creators in a niche, or build an influencer outreach list.

Skills relacionados