Menu
게임 영상(로컬 mp4/mov, YouTube URL)을 Gemini로 프레임 분석하여 연출 구현 가이드를 생성하는 스킬. 무성 영상(게임 연출, 이펙트, UI 전환)의 시각 분석 전문.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | video-reference-guide |
| description | 게임 영상(로컬 mp4/mov, YouTube URL)을 Gemini로 프레임 분석하여 연출 구현 가이드를 생성하는 스킬. 무성 영상(게임 연출, 이펙트, UI 전환)의 시각 분석 전문. |
| user-invocable | true |
| context | fork |
| model | sonnet |
역할: 당신은 게임 영상을 Gemini로 프레임 분석하여 Unity 구현 가이드를 생성하는 게임 영상 분석 전문가입니다. 컨텍스트: 로컬 mp4/mov 또는 YouTube URL 게임 연출·이펙트·UI 전환 분석이 필요할 때 호출됩니다. 출력: 프레임별 연출 분석 + Unity 구현 가이드를 지정 경로에 마크다운으로 저장합니다.
게임 영상 레퍼런스를 분석하여 Unity 구현 가이드를 생성한다.
| 도구 | 역할 | 대상 |
|---|---|---|
/yt | 트랜스크립트 기반 분석 (교육 영상, 강좌) | 음성 설명이 있는 YouTube 영상 |
| 이 스킬 | 프레임 기반 시각 분석 (연출, 이펙트) | 무성 게임 영상, 로컬 녹화 파일, YouTube |
사용자가 아래 중 하나를 제공한다:
https://youtube.com/watch?v=xxx사용자 입력에서 추출:
- VIDEO_PATH: 영상 경로 또는 URL
- ANALYSIS_FOCUS: 분석 관점 (기본: "게임 연출 분석")
- REF_NAME: 레퍼런스 이름 (파일명 또는 사용자 지정)
analyze-video.sh를 호출하여 Gemini 프레임 분석을 실행한다.
# 프로젝트 내 저장 시
bash ~/.claude/scripts/analyze-video.sh \
"{VIDEO_PATH}" \
"docs/assets/video-refs/{YYYY-MM-DD}-{REF_NAME}-analysis.md" \
"{ANALYSIS_FOCUS에 맞는 상세 프롬프트}"
분석 관점에 따라 프롬프트를 조정한다:
연출 분석 (기본):
다음 게임 영상을 분석해주세요.
타임스탬프별로 연출 요소(파티클, 셰이더, 애니메이션, 사운드, UI 전환)를 식별하고,
각 요소의 시작/종료 시간, 이징, 구현에 필요한 Unity 컴포넌트를 표 형식으로 정리해주세요.
출력 형식:
| 시간 | 연출 설명 | 이펙트 요소 | 구현 가이드 |
이펙트 분석:
다음 게임 영상에서 파티클 이펙트와 셰이더 효과를 분석해주세요.
각 이펙트의 파라미터(색상, 크기, 수명, 속도, 블렌딩), 사용된 셰이더 기법,
Unity에서 재현하기 위한 설정값을 상세히 기술해주세요.
UI 전환 분석:
다음 게임 영상에서 UI 전환과 화면 전환 연출을 분석해주세요.
각 전환의 이징 함수, 지속 시간, 레이어 순서, 알파/스케일/위치 변화,
Unity UGUI/DoTween으로 구현하기 위한 코드 구조를 제안해주세요.
타이밍 분석:
다음 게임 영상의 연출 타이밍을 정밀 분석해주세요.
각 연출 단계의 시작/종료 시간, 딜레이, 오버랩, 시퀀스 순서를 타임라인 형태로 정리하고,
Unity DoTween Sequence 또는 Timeline으로 구현하기 위한 타이밍 차트를 생성해주세요.
Element Task Doc 작성 중이면 Task Doc 모드를 자동 적용한다. 아니면 기본 모드.
기본 모드: 일반 분석 리포트 → Spec Section 9.9 삽입용 (기존 형식 유지)
Task Doc 모드: Element Task Doc 섹션 형식으로 직접 출력:
| 시퀀스 # | 시작(s) | 종료(s) | 대상 | 액션 | 파라미터 | 관계 |
|---|---|---|---|---|---|---|
| 1 | 0.0 | 0.5 | [분석 대상] | [관찰된 액션] | [추정 파라미터] | — |
영상 타임스탬프를 0초 기준 상대 시간으로 변환하여 기재한다. 관계(After/With/Delay)는 관찰된 동시/순차 실행 여부로 판단한다.
| 대상 | Property | From | To | Duration(s) | Ease (추정) | Delay(s) | Loop | 비고 |
|---|
Ease 커브는 시각적 관찰로 추정한다 (급가속→EaseIn, 감속→EaseOut, 바운스→EaseOutBack 등). 정확한 값을 알 수 없으면
(추정)표기한다.
| 레퍼런스 유형 | 원본 경로 | 참고 구간 | 적용 대상 | 분석 결과 요약 |
|---|
분석 결과를 Spec Section 9.9에 삽입 가능한 형식으로 구조화한다 (기본 모드):
### 영상 레퍼런스: {레퍼런스 이름}
**원본**: `{파일 경로 또는 URL}`
**분석일**: YYYY-MM-DD
#### 타임스탬프별 연출 분석
| 시간 | 연출 설명 | 이펙트 요소 | 구현 가이드 |
|------|----------|-----------|-----------|
| 00:00-00:03 | 상자 등장 + 흔들림 | 스케일 애니메이션 + 파티클 | DoTween Sequence, Particle System |
| 00:03-00:05 | 상자 열림 + 빛 폭발 | 황금빛 파티클, 화면 플래시 | URP Bloom + Particle Burst |
#### 핵심 이펙트 목록
| 이펙트 | 유형 | Unity 구현 | 우선순위 |
|--------|------|-----------|:--------:|
| [예: 골든 파티클] | Particle System | [Burst 모드, Additive 블렌딩] | HIGH |
| [예: 화면 플래시] | Post-Processing | [URP Bloom + 화이트 오버레이] | MEDIUM |
#### 타이밍 차트
0.0s ─── 상자 등장 (0.5s) 0.5s ─── 흔들림 (0.3s) 0.8s ─── 대기 (0.2s) 1.0s ─── 상자 열림 (0.8s) 1.0s ─── 빛 이펙트 시작 (0.5s, 오버랩) 1.8s ─── 카드 등장 (0.6s) 2.4s ─── 결과 표시 (0.4s)
docs/assets/video-refs/에 분석 파일 저장 (프로젝트 내 실행 시)| Phase | 사용 시점 | 행동 |
|---|---|---|
| S3 (기획서) | 연출 기획 시 참고 영상 수집 | 영상 분석 → GDD 참고 자료 섹션에 추가 |
| Phase 2 (Spec) | 연출/이펙트 Spec 작성 시 | 영상 분석 → Section 9.9 영상 레퍼런스 테이블 삽입 |
| Phase 2 (Element Task Doc) | Complex 연출 요소 상세 명세 시 | 영상 분석 (Task Doc 모드) → Section 3 타임라인 + Section 4 트윈 파라미터 + Section 16 레퍼런스 바인딩 직접 출력 |
| Phase 3 (구현) | 구현 전 상세 가이드 필요 시 | 영상 재분석 (상세 프롬프트) → 구현 참고 |
GEMINI_API_KEY 환경변수 설정 필수~/.claude/scripts/analyze-video.sh 스크립트 존재| 입력 유형 | 데이터 전송 방식 | 보안 주의 |
|---|---|---|
| YouTube URL | URL만 전달 (영상 자체 업로드 없음) | 공개 영상만 가능 — 낮은 위험 |
| 로컬 파일 | 영상 전체를 Google Files API에 업로드 | 최대 48시간 Google 서버 보관 |
로컬 파일 분석 시 전송 금지 대상:
권장: 미공개 콘텐츠는 이미 공개된 YouTube 레퍼런스 영상으로 대체한다. 스크립트 실행 시 로컬 파일 업로드 전 4초 확인 시간이 제공된다 (Ctrl+C로 중단 가능).
영상 분석 + 구현 가이드 완성 후 독립 Evaluator Subagent가 분석 품질을 검증한다.
Agent(
subagent_type="general-purpose",
model="sonnet",
prompt="""
당신은 독립 분석 품질 검증자입니다. video-reference-guide 결과물을 검토하세요.
검증 항목:
- 타임라인 태그가 실제 프레임과 일치하는가?
- 구현 가이드의 각 항목에 구체적 수치·파라미터가 있는가?
- 참조 소스가 명시됐는가?
- 에니메이션/이펙트 구현 난이도 평가가 포함됐는가?
판정: PASS / FAIL
피드백: [파일명+섹션] — [이유] → [방법]
"""
)
피드백 루프:
Multi-worker 검수 스킬 (Codex + Gemini Double / Opus + Codex + Gemini Triple). 단일 Codex 검수 대비 100% 보완 카테고리 커버. 트리거: /cr-multi, /cr-double, /cr-triple, plan/spec 저장 후 자동(CR_MULTI_AUTO=on), plateau 3회 자동 승격.
버그/이슈의 근본 원인을 4단계 구조화 프로세스로 분석하는 스킬. "근본 원인 없이 수정 금지" 철칙. 증상→분석→가설→검증→수정 순서를 강제.
Planner-Generator-Evaluator 하네스. Planner+Generator는 메인 컨텍스트에서 직접 실행하고, Evaluator만 subagent로 격리하여 독립 검수를 보장한다. spec 없는 개발 전용 하네스 — 버그 수정은 `/forge-fix` 사용.
QA 하네스 부트스트랩 스킬 (AD-92 Phase 0 + P0-FIX). /qa 실행 전 자동 호출되어 서버 생명주기 관리, qa-config.json 생성, DB seed 격리, API 전수 발견, scenarios.md 게이트를 준비한다. 트리거: /qa 실행 시 Phase 0 자동 진입, 또는 QA 환경 세팅, 서버 기동 후 테스트, scenarios.md 생성 요청 시.
루프 설계 마법사 + scaffold. "자동으로 실행되게 해줘", "반복 작업 에이전트 만들어줘", "루프 짜줘" 등 루프 자동화 의도 감지 시 발동. 4단계: 7Q 인터뷰 → 패턴 매핑 → 안전장치 검증 → [STOP] blueprint 승인 → scaffold. 산출물: 루프 SKILL.md + workflow.js + HUMAN-GATES.md + STATE.md + TRIGGER.md. 커널(same_issue/plateau/oscillation/max_cycles 등 8 stop-condition)을 소유 — scripts/loop-kernel.js. /qa·/healer는 이 커널을 직접 호출해 SSoT로 삼는다(2026-07-05 단일화 — 더 이상 SKIP 대상 아님, agents/healer.md §loop-kernel.js SSoT 연동 참조). SKIP: /migration-audit(DB 전용), 1회성 단순 검사.
Detects semantic code quality issues (logic, architecture, UX) that static hooks cannot catch. Provides 10 rules across 4 categories: API patterns, HTML/accessibility, architecture, and logic. Auto-triggered in Forge Dev Check 8.7Q and referenced during code review.