Communitygithub.com

편집 납품 QA

최종 비디오 편집본을 납품 전에 검증합니다. 에이전트가 렌더링된 MP4/MOV/WebM 파일을 검사하고, 재생 시간/해상도/프레임 속도/오디오를 확인하며, 연락처 시트를 생성하거나 검토하고, 타임라인 CSV를 분석하며, 컷 밀도/소스 혼합, FX 통합 및 응집력, 텍스트-비트 동기화를 확인하고, 약한 프레임이나 우발적인 자리 표시자를 발견하여 비트 동기화된 소셜 편집본을 공개할 준비가 되었는지 결정할 때 사용합니다.

편집 납품 QA란 무엇인가요?

이 스킬은 비디오 편집본이 최종 납품되기 전에 포괄적인 품질 보증(QA)을 수행하는 전문 도구입니다. 주로 비트에 맞춰진 소셜 미디어 편집본(예: 30-40초 분량의 고에너지 몽타주)을 대상으로 하며, 최종 렌더링된 동영상 파일(MP4/MOV/WebM)의 기술적 사양(재생 시간, 해상도, 프레임 속도, 코덱, 오디오 유무)을 확인하고, 타임라인 CSV 파일을 분석하여 세그먼트 수, 평균/최소/최대 세그먼트 길이, 소스 혼합 등을 검토합니다. 또한 콘택트 시트를 생성/검토하여 의도치 않은 빈 프레임, 워터마크, 스톡 프리뷰 오버레이 등을 찾아내고, 텍스트와 비트의 동기화 오프셋(100ms 이상이면 재렌더링 필요), 합성 요소의 응집력(스티커처럼 보이는지 여부), 루프 편집의 자연스러움, 휴대폰 화면에서의 확인 등 고급 검사항목을 지원합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 스크립트(`scripts/qa_video_edit.py`)를 통해 자동화된 QA를 수행하고 그 결과를 JSON과 마크다운 형식으로 출력합니다. 자동화된 검사만으로는 부족하므로, 항상 사람의 육안 검토(콘택트 시트 리뷰 및 최종 렌더 영상 시청)를 병행할 것을 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/edit-delivery-qa

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

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

문서

편집 납품 QA은(는) 무엇을 하나요?

개요

비디오 편집본을 완성본으로 제시하기 전에 이 스킬을 사용하세요. 예상 출력은 기술 사양, 타임라인 상태, 시각적 검토 노트 및 납품 전 필요한 수정 사항을 포함하는 간결한 QA 보고서입니다.

필수 확인 항목

  1. 최종 렌더링 확인:
    • 재생 시간
    • 해상도
    • 프레임 속도
    • 비디오 코덱
    • 오디오 스트림 존재 여부
    • 납품 컨테이너
  2. 콘택트 시트가 아직 없으면 생성합니다.
  3. 콘택트 시트 검토:
    • 활성화되고 의도적인 프레임으로 구성
    • 의도적인 경우가 아니라면 타이틀 카드/인터뷰/빈 프레임 없음
    • 워터마크 또는 스톡 프리뷰 오버레이 없음
    • 크롭 후에도 피사체/액션을 식별 가능
    • 의도적으로 보이는 악센트가 무작위 채우기가 아닐 것
  4. 사용 가능한 경우 타임라인 CSV 검사:
    • 세그먼트 수
    • 평균/최소/최대 세그먼트 길이
    • 소스 혼합
    • 종류/카테고리 혼합
    • 중요 히트(priority-hit) 사용
  5. 결과를 대상 형식 및 크리에이티브 브리프와 비교합니다.
  6. 편집본이 준비되었는지, 약간의 수정이 필요한지, 아니면 재렌더링이 필요한지 결정합니다.

비트 동기화 몽타주 대상

밀도 높은 소셜 몽타주 컷의 경우:

  • 재생 시간: 일반적으로 30-40초.
  • 세로: 1080x1920; 가로: 1920x1080.
  • 프레임 속도: 최소 30fps.
  • 35초 고에너지 몽타주의 경우, 푸티지가 지원한다면 70-90개 세그먼트가 적절합니다.
  • 평균 세그먼트 길이: 약 0.35-0.50초.
  • 오디오가 존재하고 깨끗해야 합니다.
  • 콘택트 시트는 대부분 활성/의도된 푸티지를 보여주어야 합니다.

통합 FX 및 제작 품질 확인 (2026-07 추가 사항)

효과 또는 텍스트 레이어가 있는 편집의 경우 필수 확인 항목에 다음을 추가합니다:

  • 응집력/스티커 확인: 합성된 요소가 장면 속 객체가 아닌 추적되지 않은 스티커로 읽히는 부분이 있습니까? 어떤 세그먼트가 다른 비디오로의 컷어웨이로 읽힙니까? 하나의 샷이 공유된 그레이드를 깨는 경우(자연스러운 샷 중 하나만 다른 룩)가 있습니까? 예라고 답변이 나오면 수정이 필요합니다 — 이것들은 가장 빈번한 거절 사유입니다.
  • 텍스트 동기화 확인: 훅 라인이 비트에 맞춰 떠오르기로 되어 있다면, 텍스트 등장 프레임과 오디오 강세 사이의 실제 오프셋을 측정하세요. |오프셋| > 100ms이면 재렌더링입니다.
  • 루프 확인: 끝을 시작 부분으로 재생해 보세요. 루프 이음매 편집은 눈에 보이지 않아야 합니다.
  • 휴대폰 화면 확인: 전체 크기와 휴대폰 화면 크기 모두에서 검사합니다. 지정된 타임스탬프(예: 15초 분량의 경우 1/4/8/12/14초)에서 리뷰 프레임을 저장하고, QA 보고서와 함께 후반 프레임에 대한 스팟 확인을 추가합니다.
  • 저렴한 검증 단계(전체 빌드 전, 후 아님): 처음 3-5초의 저해상도 스켈레톤을 렌더링하고 풀/VFX 렌더링에 투자하기 전에 스크롤 속도로 시청하세요 — 이 게이트에서 탈락 기준은 저렴하지만 VFX 후에는 비용이 많이 듭니다.
  • QuickTime 납품: Apple 플레이어에서 검토가 이루어질 경우 QuickTime 호환 .mov 파일도 함께 생성하고 별도로 QA를 수행합니다.
  • 공개용으로 나가는 모든 항목에 대해 5가지 독립적인 게이트(기술, 시각, 내러티브, 독창성/권리, 플랫폼 패키지)를 실행합니다. 자동화된 QA는 지원하지만, 정상 속도로 렌더링을 시청하는 것을 대체하지는 않습니다. 그레인은 괜찮습니다(시청자가 선호함). 블록 현상, 밴딩, 업스케일 블러, 워터마크 및 테두리가 실제 페널티입니다.

실패 패턴

다음 상황이 보이면 편집본을 수정으로 보내세요:

  • 오디오 스트림 없음 또는 잘못된 오디오 발췌
  • 잘못된 화면 비율 또는 의도치 않은 크롭
  • 빈 프레임, 타이틀 카드, 인터뷰, 스톡 워터마크 또는 가격 오버레이
  • 세로 크롭으로 인해 액션이 가려짐
  • 주요 전제를 대체하는 약한 군중/레이저/자연 삽입물이 너무 많음
  • 움직임이 적은 푸티지가 중요한 음악적 히트와 함께 사용됨
  • 타임라인 CSV와 최종 렌더링이 실질적으로 일치하지 않음

스크립트

최종 비디오에 대해 scripts/qa_video_edit.py를 실행하세요. 사용 가능한 경우 --timeline 및 --contact-sheet 옵션을 추가합니다:

python3 scripts/qa_video_edit.py final.mp4 --timeline final_timeline.csv --contact-sheet final_contact_sheet.jpg --out final_qa

스크립트는 JSON과 마크다운을 작성합니다. --make-contact-sheet가 설정되면 FFmpeg를 사용하여 콘택트 시트를 생성할 수도 있습니다.

사람의 검토

스크립트는 사양과 타임라인 문제를 잡아내지만, 영상을 시청하거나 프레임을 검사하는 것을 대체하지는 않습니다. 항상 자동화된 QA와 함께 최소한 콘택트 시트 검토를 병행하고, 편집본의 중요도가 높거나 시각적으로 복잡한 경우 최종 렌더링을 시청하세요.

Conteto Machino 표준에 대해서는 references/edit-qa-standard.md를 읽으세요.

선택적 참고 자료:

  • references/qa-thresholds.md: 편집 유형별 조정 가능한 임계값.
  • references/example-prompts.md: 재사용 가능한 최종 QA 프롬프트.
  • references/gui-vision.md: 시각적 QA 및 납품 패널에 대한 제품 비전.

Individual skills in this repo

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

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

viral-video-edits

End-to-end system for making S-tier beat-synced short-form music video edits — song analysis, viral window selection, footage sourcing with shot-level QA, hook writing, onset-locked cutting, integrated audio-reactive FX (person mattes, procedural GLSL renderers, cinematic grade), and delivery QA. Use this whenever the user asks to make a video edit, music video, reel, TikTok/Shorts/vertical video, beat-synced montage, lyric/hook video, audio-reactive visual, tunnel/portal/kaleidoscope render, or to promote a song with video content — even if they don

관련 스킬