---
name: veo-video
description: This skill should be used when the user wants to "generate video", "create animation", "animate image", "make mascot video", "마스코트 영상", "영상 생성", "비디오 만들기", "이미지 애니메이션", or needs to create video content from text prompts or images. Provides Google Veo API integration for high-quality video generation.
version: 1.0.0
allowed-tools: Bash, Read, Write, Glob
---

# Veo Video Generation Skill

Google Veo API를 사용한 고품질 영상 생성 스킬입니다.

## Quick Start

### 슬래시 커맨드
```
/veo-video "프롬프트 내용"
/veo-video -i image.png "애니메이션 설명"
```

### Python 스크립트 직접 실행
```bash
python3 .claude/plugins/mas-agents/scripts/generate_video.py "prompt" -o output.mp4
```

## 사용 가능한 모델

| 모델 | ID | 특징 |
|------|------|------|
| **veo2** (기본) | veo-2.0-generate-001 | 안정적, 범용 |
| **veo3** | veo-3.0-generate-001 | 최고 품질 |
| **veo3-fast** | veo-3.0-fast-generate-001 | 빠른 생성 |

## 기본 사용법

### 1. 텍스트 → 영상 (Text-to-Video)

```bash
python3 .claude/plugins/mas-agents/scripts/generate_video.py \
  "A steaming cup of artisan coffee with swirling cream, warm lighting, cozy cafe atmosphere" \
  -o output.mp4 \
  -m veo2 \
  -a landscape
```

### 2. 이미지 → 영상 (Image-to-Video)

```bash
python3 .claude/plugins/mas-agents/scripts/generate_video.py \
  "The cute mascot is waving and smiling, gentle bouncing motion" \
  -i frontend/public/images/mascot/mascot.png \
  -o frontend/public/videos/mascot_wave.mp4 \
  -a portrait \
  -m veo2
```

## 옵션 상세

| 옵션 | 설명 | 기본값 |
|------|------|--------|
| `-m, --model` | 모델 선택 (veo2, veo3, veo3-fast) | veo2 |
| `-a, --aspect` | 화면 비율 (landscape, portrait) | portrait |
| `-i, --input` | 입력 이미지 경로 (image-to-video) | - |
| `-o, --output` | 출력 파일 경로 | generated_video.mp4 |

### 화면 비율

| 이름 | 비율 | 용도 |
|------|------|------|
| `landscape` | 16:9 | 배경 영상, 유튜브 |
| `portrait` | 9:16 | 마스코트, 틱톡, 릴스 |

## 프롬프트 작성 가이드

### 기본 구조
```
[주체] + [동작] + [스타일/분위기] + [기술적 요소]
```

### 예시: 간단한 요청 → 향상된 프롬프트

**사용자 요청**: "허둥지둥 마스코트"

**향상된 프롬프트**:
```
The cute cream-colored latte cup mascot with heart latte art and beige scarf
is flustered and panicking, running around frantically with arms waving,
sweat drops flying, wide worried eyes, comedic fast movement,
smooth animation, loop-friendly ending
```

### 프롬프트 향상 체크리스트

1. **캐릭터 디테일**: 색상, 특징, 의상 (cream-colored, heart latte art, beige scarf)
2. **동작 설명**: 구체적인 움직임 (running, waving, bouncing)
3. **감정 표현**: 표정, 이펙트 (worried eyes, sweat drops)
4. **스타일 키워드**: 애니메이션 품질 (smooth, comedic, gentle)
5. **기술 요소**: 루프, 전환 (loop-friendly, seamless)

## TheMoon 프로젝트 컨텍스트

### 마스코트 특징
- **캐릭터**: 라떼컵 마스코트 (크림색)
- **특징**: 하트 라떼아트, 베이지색 스카프
- **성격**: 친근하고 귀여운, 때로는 허둥지둥

### 출력 경로

| 유형 | 경로 |
|------|------|
| 마스코트 애니메이션 | `frontend/public/videos/` |
| 배경 영상 | `frontend/public/videos/` |
| 임시/테스트 | `./generated_video.mp4` |

## 통합 워크플로우

### Agent 11 (아티스트)와 연계

```mermaid
graph LR
    A[매니저 요청] --> B{유형 판별}
    B -->|이미지| C[Nano Banana]
    B -->|영상| D[Veo Video]
    C --> E[Agent 11 실행]
    D --> E
    E --> F[결과 전달]
```

### 호출 예시

**매니저 → 아티스트 위임**:
```
@아티스트 마스코트가 춤추는 영상 만들어줘
```

**직접 슬래시 커맨드**:
```
/veo-video -i frontend/public/images/mascot/mascot.png "The mascot is dancing happily with bouncing motion"
```

## API 정보

- **Base URL**: `https://generativelanguage.googleapis.com/v1beta`
- **인증**: `GOOGLE_API_KEY` 또는 `GEMINI_API_KEY` 환경변수
- **생성 시간**: 약 30-60초 (모델/복잡도에 따라 다름)

## 트러블슈팅

### API 키 오류
```bash
# .env 파일에 키 설정
echo "GOOGLE_API_KEY=your_key_here" >> .env
```

### 지원되지 않는 비율
- `1:1` (정사각형)은 Veo에서 미지원
- `landscape` (16:9) 또는 `portrait` (9:16) 사용

### 긴 생성 시간
- veo3 대신 veo2 또는 veo3-fast 사용
- 복잡한 프롬프트 간소화

## 참조 파일

- **스크립트**: `.claude/plugins/mas-agents/scripts/generate_video.py`
- **Agent 11**: `.claude/plugins/mas-agents/agents/agent-11-illustrator.md`
- **Nano Banana (이미지)**: `~/.claude/plugins/cache/claude-skills/nano-banana-illustrator/`