비디오 숏폼 스킬
숏폼(≤ 10초)은 현재 텍스트-투-비디오 모델이 가장 잘하는 영역입니다 — 하나의 샷과 하나의 아이디어에 탁월하며, 다중 컷 내러티브에는 약합니다. 호출당 하나의 샷을 계획하세요.
특별한 경우: hyperframes-html은 포토리얼 텍스트-투-비디오
모델이 아닙니다. 로컬 HTML-to-MP4 렌더러입니다. 이 모델의 경우
영화 촬영 기법이나 "현실 세계"의 카메라 물리를 흉내내지 마세요.
브리프를 모션 디자인 카드 / 타이틀 프레임 / 제품 인터스티셜로
취급하고, 질문은 최대 한 번만 한 후 즉시 디스패치하세요.
리소스 맵
video-shortform/
├── SKILL.md
└── example.html
워크플로우
0단계 — 프로젝트 메타데이터 읽기
videoModel, videoLength (초), videoAspect. 이 값들은
하드 락입니다 — 선택한 모델이 지원하는 범위 내로 프롬프트를
조정하세요 (Seedance 2는 최대 10초; Kling 4는 최대 10초 + 이미지-투-비디오 지원;
Veo 3는 오디오와 함께 8초 지원).
1단계 — 샷 계획
모델을 호출하기 전에 샷 리스트를 작성하세요:
| 항목 | 내용 |
|---|---|
| 피사체 | 프레임 안에 무엇이 있나요? |
| 카메라 | 고정 / 팬 / 푸시인 / 궤도? |
| 조명 | 키 방향 + 색온도 |
| 모션 | 무엇이, 어떤 속도로 움직이나요? 피사체 움직임 vs 카메라 움직임. |
| 사운드 | 앰비언트 배경음? (모델이 오디오를 지원하는 경우에만) |
일반적으로는 디스패치하기 전에 사용자에게 한 문장 계획으로 보여주세요 — 사용자가 저렴하게 방향을 수정할 수 있습니다.
hyperframes-html의 경우, 사용자가 발견 양식에 답변한 후에는
디스패치 전 추가 설명을 건너뛰세요. 계획을 실제 생성 프롬프트로
압축하고 즉시 디스패치하세요.
2단계 — 프롬프트 구성
업스트림 모델이 선호하는 형식을 사용하세요 (Seedance: 모션 + 카메라 +
분위기; Kling: 피사체 + 카메라 + 스타일; Veo: 피사체 + 영화 촬영법 +
사운드). 프로젝트의 videoAspect와 videoLength는 API 파라미터에
직접 바인딩하고, 절대 프롬프트 본문에 넣지 마세요.
hyperframes-html의 경우, 카메라 현실감 프롬프트 대신 간결한
모션 디자인 브리프를 작성하세요. 피사체, 레이아웃, 팔레트, 모션
특성, 전체적인 톤에 집중하세요. 환경 확인, 누락된 사이드 파일,
"지금 디스패치하려고 합니다"와 같은 상태 업데이트를 설명하는
턴을 소모하지 마세요.
3단계 — 미디어 계약을 통해 디스패치
통합 디스패처를 사용하세요 — 공급자 API를 수동으로 호출하지 마세요:
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<메타데이터의 videoModel>" \
--aspect "<메타데이터의 videoAspect>" \
--length <videoLength 초> \
--output "<짧은-슬러그>-<초>s.mp4" \
--prompt "<2단계에서 조립한 샷 프롬프트>"
명령어는 한 줄의 JSON을 출력합니다: {"file": {"name": "...", ...}}.
바이트는 프로젝트에 저장되고; FileViewer가 자동으로 재생합니다.
4단계 — 전달
다음 내용으로 응답하세요: 샷 요약, 디스패처가 반환한 파일 이름, 그리고 사용자가 변형을 원할 경우 시도해볼 것에 대한 한 문장.
hyperframes-html의 경우, 응답을 특히 짧게 유지하세요: 무엇이
렌더링되었는지, 파일 이름, 한 가지 구체적인 변형 아이디어.
하드 규칙
- 한 번에 하나의 샷. 여러 샷의 타임라인은 하이퍼프레임 / 인터랙티브 비디오 스킬에 속합니다.
videoAspect를 정확히 매칭하세요 — 재렌더링은 느립니다.- 파일을 저장하지 않고 비디오를 전송하지 마세요 — 사용자는 파일 뷰어에서 재생할 무언가를 기대합니다.
- 기본 모델이 실패할 경우(NSFW 필터, 콘텐츠 정책, 타임아웃), 오류를 그대로 보고하세요. 조용히 재시도하지 마세요.
- 이미
"$OD_NODE_BIN" "$OD_BIN" media generate를 호출하지 않은 상태에서 렌더가 "전송되었습니다", "시작되었습니다", "실행 중입니다"라고 주장하지 마세요.