Ozor 생성 (텍스트-비디오)
mcp__ozor__* 도구를 사용하여 Ozor.ai에서 엔드투엔드 비디오를 생성합니다. 이 스킬은 짧은 창의적 브리프를 받아 완성된, 내보내기 가능한, 공유 가능한 비디오를 반환합니다. 단순한 프롬프트가 아닙니다.
사용 시기
사용자가 짧은 텍스트 아이디어로 실제 비디오를 제작하려 할 때 이 스킬을 사용하세요. 신호:
- "~에 대한 비디오 만들어 줘 ..."
- "~을 위한 런치 비디오 생성해 줘 ..."
- "30초짜리 설명 영상 만들어 줘 ..."
- "새 기능에 대한 광고 만들어 줘 ..."
- "~라고 말하는 비디오 렌더링해 줘 ..."
다음 경우에는 이 스킬을 사용하지 마세요:
- 사용자가 문서, PDF, PPTX, DOCX, 덱 또는 파일을 제공한 경우 →
ozor-document-video사용 - 사용자가 URL/랜딩 페이지를 제공한 경우 →
ozor-url-to-video사용 - 사용자가 생성 없이 Ozor 프롬프트 작성에 대한 도움만 원하는 경우 →
ozor-video-best-practices사용 - 사용자가 기존 비디오를 관리하려는 경우 →
ozor-video-library사용
필수 MCP 도구
이 스킬은 Ozor MCP가 연결되어 있다고 가정합니다. 도구는 다음과 같습니다:
mcp__ozor__generate_video— 텍스트-비디오 작업을 시작합니다mcp__ozor__wait_for_job— 에이전트가 프로젝트 구축을 완료할 때까지 대기합니다mcp__ozor__export_video— 렌더링을 시작합니다mcp__ozor__wait_for_export— 렌더링이 완료될 때까지 대기하고 URL을 반환합니다mcp__ozor__get_embed_code—<iframe>HTML을 반환합니다mcp__ozor__list_voices— 선택 사항, 사용 가능한 음성 목록 조회mcp__ozor__send_message— 선택 사항, 비디오 에이전트에 대한 후속 편집
Ozor MCP가 연결되어 있지 않으면 사용자에게 추가하도록 알리고 중단하세요. 프롬프트만 출력하는 대체 동작을 시도하지 마세요.
워크플로우
1단계 — 브리프 구성
Ozor 프롬프트는 2000자로 제한되며 하나의 짧은 비디오를 설명해야 합니다. MCP를 호출하기 전에 브리프에 다음이 포함되어 있는지 확인하세요:
- 비디오가 무엇에 관한 것인지 한 문장으로
- 대상 (창업자, 개발자, 고객, 일반 대중, ...)
- 포맷 — 16:9 (기본값, 가로) 또는 9:16 (소셜용 세로)
- 대략적인 길이 — 일반적으로 15–90초
- 장면 수 (3–6이 최적)
- 톤 (자신감, 따뜻함, 활기참, 기술적, ...)
- 시각 스타일 (어두움/밝음, 컬러 악센트, 미니멀/대담)
- 마지막 장면에 명확한 CTA
이 중 누락된 항목이 있고 그 차이가 결과물에 의미 있는 영향을 미친다면 하나의 집중된 질문을 하세요. 그렇지 않으면 적절한 기본값을 선택하고 진행하세요 — 자동 모드 동작입니다.
문서에서 추출한 다중 장면 스크립트를 이 프롬프트에 절대 붙여넣지 마세요. 2000자 제한을 초과하고 슬라이드 시각 요소가 손실됩니다. 문서의 경우 ozor-document-video로 전환하세요.
2단계 — 생성
호출:
mcp__ozor__generate_video({
prompt: "<컴파일된 브리프, 2000자 미만>",
export: true // 권장: 자동으로 내보내기를 트리거하므로 4단계를 건너뛸 수 있습니다
})
이것은 { videoId, jobId }를 반환합니다. 사용자에게 작업이 시작되었고 대기 중임을 알리세요.
3단계 — 빌드 대기
호출:
mcp__ozor__wait_for_job({ videoId, jobId })
Ozor 에이전트가 프로젝트 구축을 완료할 때까지 차단됩니다. 실패하면 오류 메시지가 일반적으로 프롬프트에서 수정해야 할 사항을 알려줍니다. 사용자에게 전달하고 조정 후 재시도 옵션을 제공하세요.
4단계 — 내보내기 (2단계에서 export: true를 전달한 경우 건너뜁니다)
2단계에서 export: true를 전달하지 않은 경우 호출:
mcp__ozor__export_video({ videoId })
5단계 — 렌더링 대기
호출:
mcp__ozor__wait_for_export({ videoId })
최종 URL을 반환합니다:
shareUrl— 렌더링된 비디오의 공개 링크editorUrl— 추가 조정을 위한 Ozor 편집기 링크downloadUrl— 직접 MP4 다운로드
6단계 — 임베드 가져오기
호출:
mcp__ozor__get_embed_code({ videoId })
붙여넣기 준비가 된 <iframe> 스니펫을 반환합니다.
7단계 — 사용자에게 결과 제시
다음 형식으로 출력:
🎬 비디오 준비 완료
**공유:** <shareUrl>
**편집기:** <editorUrl>
**다운로드:** <downloadUrl>
**임베드:**
```html
<iframe ...></iframe>
더 수정할까요? 다음을 할 수 있습니다:
- 특정 장면 변경
- 다른 톤이나 시각 스타일 시도
- 9:16 소셜 버전 제작
## 반복
사용자가 결과를 본 후 변경을 원하면 `mcp__ozor__send_message({ videoId, message: "<변경 요청>" })`를 사용한 다음 3-6단계를 다시 실행하세요 (에이전트가 프로젝트를 다시 빌드하고 새 내보내기가 필요합니다).
더 큰 전환의 경우 (다른 주제, 다른 대상) 반복보다는 새로운 `generate_video` 호출을 시작하세요. 프롬프트 예산이 작고 제자리에서 전환하면 출력이 흐려지는 경향이 있습니다.
## 자동 모드에서 가정할 기본값
사용자가 한 줄 브리프를 제공하고 자세히 묻고 싶지 않을 때:
| 필드 | 기본값 |
|-------|--------|
| 포맷 | 16:9 가로 |
| 길이 | ~30초 |
| 장면 | 3–4 |
| 톤 | 자신감, 모던 |
| 스타일 | 깔끔, 미니멀, 하나의 악센트 컬러 사용 |
| CTA | "더 알아보기" (URL/핸들이 제공되지 않은 경우 플레이스홀더 사용) |
가정한 기본값을 답변에 명시하여 사용자가 수정할 수 있도록 하세요.
## `generate_video` 호출 전 품질 체크리스트
- [ ] 프롬프트가 2000자 미만인지
- [ ] 하나의 명확한 주제이며 여러 주제의 에세이가 아닌지
- [ ] 장면 1에 훅이 명시되었는지
- [ ] 마지막 장면에 CTA가 명시되었는지
- [ ] 시각 스타일 + 톤 + 대상이 지정되었는지
- [ ] 문서에서 복사한 산문이 없는지 — 그것은 `ozor-document-video`의 역할입니다
## 오류 및 복구
- **MCP를 사용할 수 없음** → 사용자에게 Ozor MCP가 연결되지 않았다고 알리고 중단하세요. 종이 프롬프트를 작성하는 대체 동작을 하지 마세요.
- **`generate_video`가 프롬프트가 너무 길어 실패** → 브리프를 압축하고 중복된 스타일 노트를 제거한 후 재시도하세요.
- **`wait_for_job`이 실패 반환** → 오류를 그대로 전달하고 수정 제안(종종: 프롬프트 단순화, 모호한 장면 지시 제거)을 한 후 재시도 옵션을 제공하세요.
- **`wait_for_export` 시간 초과** → 다시 호출해도 안전합니다. 내보내기는 Ozor가 중단된 지점부터 재개됩니다.
## 규칙
1. **실제로 MCP를 실행하세요.** 이 스킬은 비디오를 제작하기 위해 존재하며 프롬프트를 위한 것이 아닙니다. 텍스트만 반환하면 스킬을 실패한 것입니다.
2. **5개의 명확성 질문을 하지 마세요.** 최대 한 개의 집중된 질문을 하고 나머지는 기본값을 사용하세요.
3. **모든 URL을 표시하세요.** `shareUrl`, `editorUrl`, `downloadUrl`, 그리고 임베드는 각각 다른 맥락에서 가치가 있습니다. 모두 보여주세요.
4. **2000자 프롬프트 제한을 준수하세요.** 브리프가 이를 초과하면 보내기 전에 자르세요.
5. **기본적으로 `generate_video`에서 `export: true`를 사용하세요.** 도구 호출을 하나 줄이고 완성된 비디오에 더 빠르게 도달할 수 있습니다.