Communitygithub.com

review-ugc-render

UGC 비디오 렌더링의 오디오를 승인된 대본과 비교하여 단어 오류, 구문 누락, 무음 등을 검사하고, 결함이 있을 경우 게시를 차단하는 필수 QC 게이트입니다.

review-ugc-render란 무엇인가요?

이 스킬은 Seedance가 생성한 UGC 비디오 렌더링의 오디오를 Whisper로 전사(transcribe)한 후, 사용자가 승인한 구어 대본(approved spoken script)과 단어 단위로 비교(diff)하여 일치 여부를 검증합니다. 'human-vetted'이 'human witted'로 발음되는 등의 음성 오류(mis-voicing), 승인된 구문 누락, 완전 무음(silent) 렌더링을 탐지하고, 결함이 있을 경우 비-제로(non-zero) 종료 코드로 레시피가 `set_final_render`를 호출하지 못하도록 차단합니다. Claude Code, Cursor, Codex 등 모든 터미널 기반 AI 에이전트에서 실행 가능하며, OpenAI API(Whisper 프록시 지원)와 로컬 whisper CLI 모두 지원합니다. 이 게이트는 콘텐츠 거위(content-goose)의 리뷰 엔진 중 오디오-대본 무결성(review-transcript-integrity)을 전담하는 단일 파일 게이팅(gating) 모듈로, 모든 `remix-ugc-*-from-sample` 및 `create-ugc-*-video-from-refs` 레시피에서 최종 게시 전 반드시 통과해야 합니다.

지원 대상~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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

review-ugc-render은(는) 무엇을 하나요?

모든 UGC 비디오 레시피가 게시 전 반드시 통과해야 하는 QC 게이트. 육안 /watch가 아닌 — 결정론적 전사-대본 차이 검사로, 결함이 있을 경우 비-제로로 종료되어 레시피가 set_final_render를 하드 스톱합니다.

왜 필요한가

Seedance는 오디오를 자체 생성합니다. 때때로 단어를 잘못 발음(mis-voice) 합니다 — 승인된 대사 human-vetted가 human witted로 발음되는 식입니다. 또 다른 사례: Hume→Hune, Alitu→al-too. 이 결함은 렌더링의 오디오에 존재하므로, 육안 /watch ("대사가 스크립트와 일치함")로는 놓치기 쉽고, 이후 캡션 생성 단계에서 잘못된 단어가 그대로 박히게 됩니다. 실제로 발화된 오디오와 사용자가 승인한 스크립트를 비교하는 과정이 없었습니다.

이 게이트는 정확히 그 작업을 결정론적으로 수행하며, 불일치 시 게시를 거부합니다.

실행 시점

  • 필수: 모든 remix-ugc-*-from-sample 및 create-ugc-*-video-from-refs 레시피의 QC 단계에서, 마스터 렌더가 존재한 후 그리고 set_final_render 전에 실행합니다.
  • 통과(PASS)할 때까지 수정/재실행 후 다시 실행합니다.

계약(Contract)

렌더링 전에, 승인된 정확한 구어 대사(비트 노트 제외, 말 그대로의 발화)를 working/approved-script.txt에 저장합니다. 그런 다음 렌더 후:

python3 <pack>/review-ugc-render/scripts/review_render.py \
  --video working/final.mp4 \
  --script-file working/approved-script.txt \
  --json working/review-verdict.json
  • exit 0 → PASS — 게시 진행 (set_final_render).
  • exit 2 → FAIL — 게시 금지. 보고서를 읽고 수정 후 재실행.
  • exit 3 → ERROR — 검사를 실행할 수 없음 (아래 참조). 환경을 수정하고, 맹목적으로 게시하지 마십시오.

전사 백엔드 (우선순위 순): OPENAI_API_KEY (설정된 경우 OPENAI_BASE_URL을 사용하여 gooseworks Whisper 프록시로 라우팅) → 로컬 whisper CLI. ffmpeg가 PATH에 있어야 합니다.

FAIL의 의미와 수정 방법

보고서 라인근본 원인수정 방법
[high] said [witted] where script has [vetted]Seedance가 생성한 오디오에서 단어를 잘못 발음함새 시드(seed)로 재생성. 브랜드/조어 토큰인 경우 SPOKEN LINE에 음성적으로 철자하세요 (예: Ali-too, 절대 (발음: …)와 같은 괄호 사용 금지 — Seedance는 괄호도 읽습니다). create-video-seedance-2-fal 실패 모드 참조.
[medium] dropped [...] / 낮은 유사도Seedance가 승인된 구문을 누락함재생성; 꼬리 단어만 누락된 경우 stitch_replacement.py 창 수정으로 복구 가능할 수 있습니다.
⚠ audio is effectively silent잘못된 렌더 / 오디오 트랙이 후처리에서 손실됨재렌더링 / 먹싱 재확인; 무음 테이크를 게시하지 마십시오.
ERROR: no transcription backendOPENAI_API_KEY도 로컬 whisper도 없음키(프록시 OPENAI_BASE_URL)를 설정하거나 whisper를 설치한 후 재실행.

--expect-music는 참고용일 뿐입니다 (음악 배경이 없으면 경고). 자체적으로 게이트를 실패시키지 않습니다.

입력

  • --video PATH (필수) — 렌더링된 마스터 mp4.
  • --script-file PATH 또는 --script "text" — 승인된 구어 대본. 둘 다 생략하면 진정한 스크립트 없는 클립으로 간주됩니다 (드리프트 검사가 건너뛰어지고 게이트는 참고용이 됩니다).
  • --min-ratio FLOAT (기본값 0.90) — 전사↔대본 토큰 유사도 통과 기준.
  • --json PATH — 앱 검토 패널을 위한 기계 판정 결과를 기록합니다.

테스트

python3 tests/test_review_render.py    # 순수 판정 로직; 오디오/네트워크 불필요

다음 경우를 다룹니다: 정규 vetted→witted 잘못 발음, 브랜드 이름 잘못 발음, 꼬리 누락, 무해한 필러 단어, 스크립트 없는 참고 경로.

content-goose 검토 엔진과의 관계

이 스킬은 더 포괄적인 coworkers/video/molecules/review/review-loop (18축 평가 기준)의 출시된 단일 파일 게이팅 조각입니다. 여기서는 게시 시점에 오디오-대본 결함을 잡는 하나의 축(review-transcript-integrity / brand_text_accuracy)을 적용합니다. 더 깊은 다축 검토는 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.

관련 스킬