Communitygithub.com

product-film

제품 출시/프로모션/설명 영상을 제작하며, AI가 만든 것처럼 보이지 않고 판매에 도움이 되도록 제작합니다. 소유자가 한 번에 하나씩 승인하는 리뷰 게이트를 통과합니다.

product-film란 무엇인가요?

이 스킬은 제품 출시, 프로모션, 설명 영상 등 'AI가 만든 냄새'가 나지 않는 고품질 영상을 제작하기 위한 파이프라인입니다. 영상 제작은 단순히 결과물을 한 번에 내는 것이 아니라, 소유자가 각 단계(브리핑, 참고 영상 분석, 스토리보드, 영상 제작, 사운드, 보이스오버, 포맷 변환, 전달)를 승인하는 게이트를 통과하며 점진적으로 완성됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용할 수 있으며, film-reference-study, film-storyboard, film-build, film-sound, film-voiceover 스킬을 순차적으로 호출합니다. 각 단계마다 소유자가 구체적인 선택지를 제시하고(예: 움직임, 전환, 음악 스타일 등), 승인 후에만 다음 단계로 넘어가도록 설계되어 있습니다. 영상은 실제 제품 기능만을 보여주며, 모든 주장은 검증 가능한 출처를 가져야 합니다. 최종 결과물은 16:9와 9:16 두 가지 포맷으로 제공되며, 자막, 크레딧, 미검증 사항 목록 등이 포함됩니다. 이 프로젝트는 소유자의 교정을 최소화하는 데 목표를 두고 있으며, 모든 교정 사항은 references/lessons.md에 기록되어 다음 영상 제작에 활용됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/product-film

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

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

문서

제품 영상

제품 영상은 한 사람, 바로 소유자가 먼저 평가합니다. 소유자가 잘못된 부분을 지적하면 수정하고, 영상은 한 라운드씩 개선됩니다. 이 스킬은 소유자의 교정을 불필요하게 만드는 것을 목표로 합니다. 여기에 있는 모든 규칙은 누군가가 직접 수정해야 했던 교정에서 비롯되었습니다. 시작하기 전에 references/lessons.md를 읽고, 각 리뷰를 보내기 전에 다시 읽으십시오. 이 파일은 소유자가 거부한 사항과 그 이유에 대한 기록입니다.

파이프라인 및 게이트

소유자가 현재 단계를 승인할 때까지 다음 단계로 넘어가지 않습니다. 승인은 채팅에서 명확한 '예'이며, 침묵이나 '좋아 보이는데...'가 아닙니다. 소유자가 요청한 변경 후에는 다시 리뷰를 위해 보내십시오.

단계스킬리뷰 대상게이트
0 · 브리핑현재 스킬브리핑: 제품, 구매자, 확신시킬 한 가지, 길이, 포맷, 재생 위치소유자가 브리핑 승인
1 · 참고film-reference-study참고 영상이 하는 일과 차용할 점(숫자와 프레임으로)소유자가 차용할 점과 차용하지 않을 점에 동의
2 · 스토리보드film-storyboard스토리보드 페이지: 비트당 한 프레임, 화면상 텍스트, 각 비트의 존재 이유; 스토리가 열려 있으면 2~4가지 방향소유자가 방향을 선택하고 비트 승인
3 · 영상film-build먼저 스틸 이미지, 다음 30fps 드래프트, 절대 최종 렌더링 먼저 금지소유자가 영상 승인("render final")
4 · 사운드film-sound효과음이 포함된 최종본 및 음악 결정소유자가 사운드 승인
5 · 보이스오버film-voiceover실제 프레임이 있는 스토리보드에 스크립트, 다음 이름 테스트, 다음 보이스 컷소유자가 스크립트, 발음, 컷 순으로 승인
6 · 포맷film-build (포맷)9:16 스틸 이미지, 다음 9:16 렌더링소유자 승인; 16:9가 변경되지 않았음을 증명
7 · 전달현재 스킬파일, 자막, 크레딧, 미검증 사항완료

"렌더링 전에 리뷰하게 해주세요": 소유자는 30분 동안 렌더링하는 데 시간을 낭비하기 전에 계획과 스틸 이미지를 보고 싶어 합니다. 승인되지 않은 초안으로 최종 렌더링을 하면 시간 낭비이며 신뢰를 잃습니다.

질문하는 방법 (모든 게이트)

각 게이트에서, 개방형 질문보다 구체적인 선택지를 제시하고, 각 옵션은 실제 편집자가 선택할 만한 것이어야 합니다. "현대적인", "깔끔한", "다이나믹한"과 같은 일반적인 옵션은 영상이 AI 쓰레기가 되는 지름길입니다. references/question-bank.md에는 각 단계에 대한 질문과 옵션이 있습니다: 모양, 움직임, 속도, 전환, 타이핑, 캐릭터, 사운드, 음악, 음성, 전달. 규칙:

  • 질문당 2~4개의 옵션, 각 옵션은 어떻게 보이는지 또는 들리는지, 비용 또는 위험을 포함. 먼저 자신의 선택을 제시하고 한 줄로 이유를 설명.
  • 작업을 변경하는 것만 질문. 나머지는 브랜드와 참고 영상으로 결정하고, 결정한 내용을 말할 것.
  • 소유자가 아이디어를 큰 소리로 이야기할 때, 각 문장을 구현하지 마십시오. 조사한 후, 2~4가지 방향과 그 장단점을 제시하고 선택하게 하십시오("제가 결정할 수 있도록 장단점이 있는 방향들을 알려주세요").
  • 소유자가 "잠깐, 더 알려줄게요"라고 말하면, 멈추고 기다리십시오. 계속 편집하지 마십시오.
  • 교정이 들어오면, 그 뒤에 있는 규칙을 찾고 그들이 지적한 한 곳뿐만 아니라 전체 영상에서 같은 실수를 확인하십시오.

모든 단계에서 적용되는 규칙

  1. 실제만. 영상에 나오는 모든 기능, 위젯, 화면, 숫자 출처 및 주장은 오늘날 제품에서 실제로 작동합니다. 영상에 제품이 할 수 없는 것이 필요하면, 제품에 구축(그리고 결정을 기록)하거나 삭제하십시오. 말로 하거나 보여주는 모든 주장은 가리킬 수 있는 출처(파일, 문서, 테스트)가 있습니다.
  2. 구체적, 일반적이지 않게. 브랜드 자체 사이트의 실제 로고. 해당 OS에 실제로 존재하는 앱이 있는 실제 OS 크롬. 실제 기기 크기. 실제 배경화면(라이선스 획득). 풍부하고 상세한 제품 UI: "너무 단순함"은 "내가 왜 이걸 위해 돈을 내야 하지?"로 읽힙니다. film-build/references/realism.md 참조.
  3. 시청자의 관점. 영상은 제품에 대해 들어본 적 없는 낯선 사람을 위한 것입니다. 모든 비트를 테스트하십시오: 이해할 수 있습니까? 오해할 수 있습니까(예: 제품이 AI라고 생각)? 우리 기능에 관한 것인가요, 그들의 삶에 관한 것인가요?
  4. AI로 만든 것이 아님. 합성 삐 소리, 미니멀 목업, 실제 브랜드의 아이콘 폰트 흉내, 삼위일체와 "당신의 X, 당신의 Y" 카피, 장면 설명 보이스오버가 없습니다. 소유자는 이러한 특징을 알고 있으며, 구매자도 마찬가지입니다. 한 경쟁업체는 "Claude로 만든" 것처럼 보이는 출시 영상으로 공개적으로 비난을 받았습니다.
  5. 읽기 쉽고 부드럽게. 모든 줄은 끝까지 읽을 수 있을 만큼 충분히 오래 유지됩니다. 타이핑은 키보드처럼 보입니다. 아무것도 잘리거나, 겹치거나, 빈 화면이 깜빡이지 않습니다. 인간을 위한 속도: 첫 번째 컷은 거의 항상 너무 빠릅니다.
  6. 결정론. 영상은 시간에 대한 순수 함수입니다. 보내는 모든 렌더링 전에 render.mjs --verify가 통과해야 합니다.
  7. 작고 정직한 보고서. 리뷰를 보낼 때, 변경된 사항, 아직 열려 있는 사항, 확인할 수 없었던 사항을 말하십시오(오디오를 들을 수 없습니다: 그렇게 말하고 물어보십시오). 확인하지 않은 것을 확인되었다고 말하지 마십시오.
  8. 자주 커밋하십시오(코드, 스크립트, 스토리보드, VO 스크립트). 렌더링, 오디오 및 스틸 이미지는 git에서 제외됩니다.

프로젝트 구조

<film>/
  brief.md                 단계 0
  reference/               참고 영상 연구 결과(프레임, 시트, summary.md, NOTES.md)
  storyboard.json          단계 2 소스 → review/storyboard.html
  film/                    영상 페이지(core.js, film.js, mock.js, index.html)
  scripts/ tools/          렌더, 동기화, 사운드, 음성, 믹스, 프로브(film-build 키트에서)
  timeline.json vo.json    영상 타이밍 및 사운드 큐; 보이스오버 구문
  VO-SCRIPT.md             각 주장의 출처가 포함된 승인된 보이스오버
  assets/                  폰트, 로고, 배경화면, sfx, 캐릭터, CREDITS.md
  renders/ audio/ review/  (git 제외)

sh ~/.claude/skills/film-build/kit/init.sh <film>으로 시작하십시오.

단계 0 · 브리핑

다른 모든 것보다 먼저 brief.md를 작성하고 승인을 받으십시오:

  • 제품, 낯선 사람이 이해할 수 있는 한 문장. 태그라인이 아닙니다.
  • 구매자, 그들의 언어로. 제품이 여러 유형의 사람들에게 서비스를 제공하는 경우 여러 유형(페르소나): 각각 매일 확인하거나 필요한 것.
  • 영상이 반드시 확신시켜야 할 한 가지, 그리고 반드시 방지해야 할 한 가지 오해.
  • 사용 가능한 증거: 오늘날 실제로 존재하는 것, 구축되어 기록된 것, 보여줄 수 있는 것.
  • 길이 및 포맷: 다양한 범위를 보여주는 출시 영상은 약 45~65초가 필요합니다. 20초는 여러 사람과 사용 사례를 보여주기에는 너무 짧습니다. 포맷: 16:9 먼저, 그 다음 9:16, 소유자가 달리 말하지 않는 한.
  • 재생 위치(사이트 히어로, X, Reels, YouTube) 및 브랜드 규칙(색상, 서체, 절대 사용하지 말아야 할 단어, 로고).
  • 제품이 절대 보여져서는 안 되는 모습(예: "절대 독") 및 피해야 할 경쟁사.

단계 7 · 전달

  • renders/16x9.mp4 및 renders/9x16.mp4(60fps, 모션 블러, 음성 및 사운드 믹스).
  • assets/CREDITS.md: 모든 배경화면, 로고, 폰트, 사운드 및 캐릭터와 라이선스.
  • 브랜드가 나타나는 경우: 브랜드가 표시되는 동안 화면에 고유명 사용 문구를 표시("제품 이름 및 로고는 해당 소유자의 자산입니다...").
  • 검증되지 않은 사항의 일반 목록(예: "네 가지 요청이 아직 실제 앱에 구축되지 않았습니다").
  • 요청 시 자막 및 썸네일(소유자의 소셜 및 카피라이팅 기술 사용, AI 흔적 없음).

영상 제작 후

소유자가 한 모든 새로운 교정을 references/lessons.md에, 해당 단계 아래에 추가하십시오. 무엇이 잘못되었고 어떤 규칙이 이를 방지하는지 포함하십시오. 이 파일은 다음 영상이 이번 영상보다 더 앞서 시작할 수 있게 해줍니다.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

관련 스킬