Communitygithub.com

sanky369/vibe-building-skills

제품 영상 제작을 위한 엔드투엔드 기획: 비디오 유형 선택, 애니메이션 스타일 및 속도 정의, 비트별 장면 목록 작성, 바로 실행 가능한 키프레임 프롬프트 생성까지 한 번에 처리합니다.

vibe-building-skills란 무엇인가요?

이 스킬은 제품 영상 제작을 위한 완전한 기획 스펙을 생성하는 전문 도구입니다. 제품과 목표를 입력하면 '하나의 영상은 하나의 메시지를 전달한다'는 원칙 아래, 가장 적합한 비디오 유형(리빌, 피처 쇼케이스, 인 액션, 트랜스포메이션, 360 스핀)을 선택하고, 플랫폼에 맞는 속도와 애니메이션 스타일을 결정합니다. 비트별 장면 목록과 타이밍, 전환 효과를 포함한 상세한 비트 시트를 작성하고, 각 비트에 대해 생성 준비가 완료된 키프레임 프롬프트를 제공합니다. 이 프롬프트는 fal-ai/nano-banana-pro 모델을 통해 바로 실행 가능하거나, 필요 시 스킬 내 CLI 명령어로 즉시 이미지를 생성할 수 있습니다. 특히 브랜드 일관성을 유지하기 위해 모든 키프레임에 동일한 애니메이션 스타일 문구, 조명, 배경 설명을 적용하며, 최종 출력에는 오디오 방향과 프로덕션 노트도 포함됩니다. 다른 창작 스킬들과 연동되어, 'creative-strategist'의 스타일 가이드를 따르거나 'remotion-script-writer'로 렌더링이 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sanky369/vibe-building-skills/tree/HEAD/skills/creative/product-video

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

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

문서

제품 영상

제품과 목표를 완전한 제품 영상 프로덕션 스펙으로 변환합니다 — 선택된 하나의 영상 콘셉트, 비트별 장면 목록 및 타이밍, 애니메이션 및 속도 계획, 그리고 생성 준비가 완료된 키프레임 프롬프트까지. 핵심 원칙은 하나의 영상은 하나의 메시지를 전달한다입니다. 모든 비트는 단일 메시지(리빌, 혜택, 변화)를 향해 구축되거나 삭제됩니다. 계획과 키프레임을 생성하며, 실제 모션 렌더링은 다운스트림에서 처리됩니다.

사용 시기 / 사용하지 말아야 할 시기

  • 제품 중심의 모션 콘텐츠(리빌, 피처 쇼케이스, 제품 작동 중, 변화, 360 스핀)에 사용하세요.
  • 비디오에 사람이 전면에 등장하는 경우(발표자, 사용 후기, UGC) → skills/creative/talking-head를 사용하세요.
  • 비디오를 Remotion으로 프로그래밍 방식으로 렌더링하는 경우(UI 데모, 코드 튜토리얼, 데이터 시각화) → skills/creative/remotion-script-writer를 사용하세요. 먼저 이 스킬을 실행하여 콘셉트와 비트를 정의한 후 비트 시트를 전달할 수 있습니다.
  • 사용자가 정적 에셋(게시물, 배너)이 필요한 경우 → skills/creative/social-graphics를 사용하세요.
  • 아직 브랜드 스타일 가이드가 없고 사용자가 브랜드 일관성을 중요시하는 경우 → 먼저 skills/creative/creative-strategist를 실행하세요. 해당 스타일 가이드가 이 스킬에 입력으로 제공됩니다.

입력 수집

한 번에 누락된 항목만 묻습니다:

  1. 제품 — 무엇이며, 비디오가 전달해야 할 단 한 가지는 무엇인가요? (신규 출시? 기능? 혜택? 전/후?)
  2. 게재 위치 — 틱톡/릴스/쇼츠, 제품 페이지, 유튜브 프리롤, 전시회 루프? (종횡비, 길이, 속도 결정)
  3. 시청자가 이후 해야 할 행동 — CTA.
  4. 브랜드 스타일 — skills/creative/creative-strategist 스타일 가이드나 기존 브랜드 에셋이 있나요?

컨텍스트에서 추론하여 질문을 최소화합니다: 플랫폼에서 종횡비, 제품 카테고리에서 분위기, 프로젝트 내 기존 브랜드 자료에서 스타일을 유추합니다. 멈추지 마세요: 제품과 목표가 명확하다면 나머지에 대한 가정을 명시하고("릴스, 12초, 세로, 활기찬 속도로 가정합니다. 다르면 알려주세요") 진행합니다.

워크플로우

1. 비디오 유형 선택 (메뉴가 아닌 결정 규칙)

메시지가…유형길이비트 구조
"이것이 존재합니다 / 새로 나왔습니다"리빌5–15초숨김/가림 → 리빌 애니메이션(페이드, 슬라이드, 회전) → 히어로 샷
"2~4가지 기능을 합니다"피처 쇼케이스15–30초기능 1 하이라이트 → 기능 2 → 기능 3 → 전체 제품
"사용 시 이점을 보여드립니다"인 액션10–20초제품이 있는 환경 → 제품 사용 모습 → 결과 표시
"변화를 보세요"트랜스포메이션10–15초이전 상태 → 변형 → 이후 상태
"그냥 물체를 보여주세요" (이커머스, 리스팅)360 스핀5–10초연속적인 부드러운 회전, 깔끔한 배경

한 유형을 한 줄의 이유와 함께 선택합니다. 진정으로 두 가지가 모두 적합한 경우에만 단일 백업을 제안합니다. 4개 이상의 기능을 보여주지 마세요 — 가장 강력한 기능만 선택하세요.

2. 플랫폼에 따른 속도 설정

  • 빠름 (5–10초, 빠르고 날카로운 컷): 소셜 피드, 광고, 건너뛸 수 있는 모든 콘텐츠. 처음 2초 안에 후크를 넣으세요.
  • 중간 (10–20초, 부드러운 전환): 제품 페이지, 마케팅 사이트, 이메일 임베드.
  • 느림 (20–30초, 의도적인 고급스러운 움직임): 프리미엄/럭셔리 제품, 스토리텔링. 제품의 가격대가 인내심을 정당화할 때만 느린 속도를 선택하세요.

위치별 종횡비: 9:16 세로(틱톡/릴스/쇼츠/스토리), 16:9(유튜브, 웹 히어로), 1:1 또는 4:5(피드 게시물). 이는 CLI의 --aspect-ratio 값에 직접 매핑됩니다.

3. 하나의 애니메이션 스타일 선택

브랜드 성격에 맞게 — 정확히 하나를 선택하고 모든 키프레임 프롬프트에 해당 문구를 그대로 사용하여 프레임 간 일관성을 유지하세요:

브랜드 느낌스타일프롬프트 문구
우아함, 차분함부드러운 페이드"smooth fade transitions, gentle pacing, elegant"
모던함, 에너제틱다이내믹 슬라이드"dynamic slide transitions, elements slide in, energetic pacing"
시네마틱, 대담함줌 & 로테이트"zoom and rotate moves, dynamic pacing, cinematic"
세련됨, 유려함모핑"smooth morphing transitions, fluid animation, sophisticated"
하이테크파티클 이펙트"particle effects, product materializes/dissolves, high-tech"

4. 비트 시트 작성

길이를 3~6개의 비트로 나눕니다. 각 비트에 대해: 시간 범위, 화면에 보이는 것, 카메라/모션, 그리고 전환 방식. 모든 비트는 단일 메시지를 발전시켜야 하며, 마지막 비트는 항상 제품 + CTA를 2초 이상 유지합니다.

5. 키프레임 프롬프트 작성

비트당 하나의 키프레임(트랜스포메이션의 전/후는 두 개). 각 프롬프트 = 해당 비트의 주제 + 상태 + 애니메이션 스타일 문구 + 조명 + 모든 프레임에 걸쳐 동일한 스타일/조명 설명자(일관성이 프레임을 하나의 비디오로 읽히게 합니다). 모든 키프레임은 비트가 명시적으로 장소를 변경하지 않는 한 동일한 배경 및 조명 설명을 사용합니다.

FAL_API_KEY(또는 FAL_KEY)가 설정된 경우, 지금 리포지토리 CLI로 키프레임을 생성하세요 — 모델 fal-ai/nano-banana-pro 및 docs/fal_api.py 사용:

python docs/creative_cli.py custom \
  --category "video-keyframes" --name "beat-1-hero" \
  --prompt "<키프레임 프롬프트>" --aspect-ratio 9:16 --resolution 2K

키가 설정되지 않은 경우, 프롬프트를 바로 실행 가능한 명령어로 제공하세요. 참고: nano-banana-pro는 정지 키프레임만 생성합니다 — 프레임 간 모션은 다운스트림에서 제작됩니다(Remotion, 비디오 생성 도구 또는 편집기).

6. 품질 기준에 따라 자체 점검 후 스펙 전달

필수 출력 형식

항상 이 구조를 사용하여 전달하세요:

# 제품 영상 프로덕션 스펙 — [제품]

## 개요
- **메시지 (한 문장):** ...
- **유형:** 리빌 | 피처 쇼케이스 | 인 액션 | 트랜스포메이션 | 360 스핀 — [한 줄 이유]
- **플랫폼/위치:** ... · **종횡비:** ... · **길이:** ...초 · **속도:** 빠름/중간/느림
- **애니메이션 스타일:** [스타일 + 그대로 사용할 프롬프트 문구]
- **CTA:** ...

## 비트 시트
| # | 시간 | 화면 | 카메라/모션 | 전환 |
|---|------|-----------|-----------------|----------------|
| 1 | 0–3초 | ... | ... | ... |
| 2 | 3–7초 | ... | ... | ... |
(마지막 비트: 제품 + CTA, 2초 이상 유지)

## 키프레임
### KF-1 (비트 1) — [레이블]
> [전체 nano-banana-pro 프롬프트]
`python docs/creative_cli.py custom --category "video-keyframes" --name "kf-1" --prompt "..." --aspect-ratio [비율] --resolution 2K`
(비트별 반복; 모든 프레임에 걸쳐 동일한 스타일/조명 설명자 사용)

## 오디오 방향
- 음악: [속도에 맞는 장르/에너지] · 사운드 디자인: [주요 순간] · VO: [없음, 또는 비트당 한 줄]

## 프로덕션 노트
- [렌더링 경로: skills/creative/remotion-script-writer를 통한 Remotion / 비디오 생성 도구 / 편집기]
- [비트별 특이사항: 로고 타이밍, 텍스트 오버레이, 전시회/스핀 비디오용 루프 포인트]

품질 기준 (전달 전 확인)

  • 하나의 메시지; 한 문장으로 표현할 수 없으면 1단계에서 다시 시작하세요.
  • 후크가 빠른 속도의 경우 처음 2초 이내, 중간 속도의 경우 4초 이내에 배치되어야 합니다.
  • 비트 수 3~6개; 1.5초 미만의 비트 없음; 타이밍 합계가 명시된 길이와 정확히 일치해야 합니다.
  • 모든 키프레임 프롬프트에 동일한 애니메이션 스타일 문구와 동일한 조명/배경 설명자가 포함되어야 합니다(비트가 장소를 변경하지 않는 한) — 일관되지 않은 프레임은 가장 흔한 실패 원인입니다.
  • 프롬프트에 "smooth", "fluid" 모션 언어를 명시하세요 — 모션 품질을 암시적으로 남겨두지 마세요.
  • CTA가 마지막 비트에 존재하며 2초 이상 유지되어야 합니다.
  • 허구의 성능 주장("이 형식은 3배 더 많은 참여를 얻습니다")을 하지 마세요 — 위의 속도/길이 지침은 경험적이며, 질문을 받으면 그렇게 표시하세요.

통합

  • skills/creative/creative-strategist → 입력 제공: 모든 키프레임 프롬프트가 따라야 하는 스타일 가이드(색상, 분위기, 조명 언어).
  • skills/creative/product-photography → 입력 제공: 기존 히어로 샷 프롬프트/조명 설정을 비디오의 히어로 프레임으로 재사용하여 일관성 유지.
  • skills/creative/image-generation → 소비: 키프레임 프롬프트, 사용자가 CLI 한 줄 명령어보다 더 깊은 생성 제어를 원하는 경우.
  • skills/creative/remotion-script-writer → 소비: 비트 시트 + 키프레임, 비디오가 Remotion 컴포지션으로 렌더링될 때.
  • skills/creative/social-graphics → 소비: 지원 정적 게시물의 소스 이미지로 히어로 키프레임 사용.

Individual skills in this repo

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

sanky369/original-design

Facilitates an interactive session that turns a product or subject into an original, internally consistent visual design language for any artifact — infographics, video storyboards, websites, or mobile app UI/UX. Use when the user wants an original design language, identity, or art direction, or when a design feels generic, derivative, 'AI-default,' or inconsistent and needs one unifying idea. Triggers on 'design language', 'art direction', 'make it original', 'visual identity', 'looks generic', 'design a world'. Produces a completed Design Language Brief (core metaphor, visual vocabulary, design DNA, signature constraint, Originality Test verdicts) saved to the project and handed off to the production skill for the chosen medium.

sanky369/product-photography

Produces professional AI product photography — clean e-commerce shots, lifestyle scenes, hero images, macro detail shots, and flat lays — as generation-ready prompt specs, and generates the files via FAL.ai fal-ai/nano-banana-pro when the automation is configured. Use when the user says 'product photos', 'shots of my product', 'images for my store / listing / landing page', 'hero image for my product', 'lifestyle photos', or shares a product needing marketing imagery. Produces one prompt-spec block per shot (shot type, lighting, background, composition, aspect ratio, negative constraints) with a shot list, variant plan, and file-naming conventions; runs docs/creative_cli.py product when FAL_API_KEY is set.

관련 스킬