Communitygithub.com

프로덕트 필름

실제 제품 화면에서 시작하는 런치 비디오: 5막(문제, 약속, 제품 작동 모습, 결과, 요청)으로 구성된 34초 분량. 큰 커서, 움직이는 카메라, 자막, 사운드를 포함하며 가로, 정사각형, 세로 비율을 지원합니다. 사용자가 앱이나 웹사이트의 런치 비디오, 제품 영상, 프로모션, 데모 영상, 티저, 모션 그래픽을 요청할 때 사용하세요.

프로덕트 필름란 무엇인가요?

이 스킬은 실제 제품 화면을 기반으로 한 34초 분량의 런치 필름을 자동 생성합니다. 문제 → 약속 → 작동 모습 → 결과 → 요청의 5막 구조를 따르며, 큰 커서, 움직이는 카메라, 자막, 사운드를 포함한 가로/정사각형/세로 세 가지 비율의 동영상을 동시에 렌더링합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자가 제공한 URL에서 브랜드 정보와 UI 상태를 캡처하여 실제 제품 화면만을 활용합니다. 스킬은 Puppeteer 기반으로 동작하며 Node.js 20 이상, ffmpeg, Chrome 계열 브라우저가 필요합니다. 영화의 문법(타이포그래피, 컬러, 리듬)은 참조 템플릿을 따르되 단어와 화면은 사용자의 제품으로 대체됩니다. 자체 점검 시스템을 통해 커서 위치, 타이밍, 화면 변경 영역(PATCH)의 정확성을 검증하며, 8점 미만의 품질은 배포하지 않습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/product-film

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

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

문서

프로덕트 필름은(는) 무엇을 하나요?

명시적인 사용자 지시사항은 이 워크플로우보다 우선합니다. 승인된 제품과 샘플 데이터에 대해서만 작업하세요. 비밀번호, API 키, 결제 데이터, 정부 식별자, 건강 기록 또는 기타 민감한 데이터를 요청하지 마세요. 필요한 로컬 종속성을 작업 프로젝트에 설치하기 전에 설명하세요. 네트워크 액세스는 승인된 제품과 그 라이선스 자산, 그리고 선언된 npm 종속성에 대해서만 허용됩니다. 액세스 제어를 준수하세요. 한 번에 하나의 작업을 렌더링하고 완료될 때까지 기다리세요. 게시, 전송, 배포는 이 작업 외부에서 처리하세요.

여러 스킬이 비슷한 작업을 할 수 있는 경우: 사용자의 요청에 이 스킬 이름이 명시되지 않았고, 에이전트에 동일한 종류의 결과물(다른 런치 필름, 샷, 데크, 목업)을 만드는 다른 옴니가미 스킬이 있다면, 해당 스킬들을 이름별로 나열하고 사용자에게 어떤 것을 원하는지 시작 전에 물어보세요. 만약 스킬 이름이 명시되었거나, 설치된 유일한 스킬이라면 바로 진행하세요.

일본어, 한국어 또는 중국어 제품 페이지의 경우, 카피를 해당 언어로 유지하고 필름의 lang을 페이지의 <html lang>으로 설정하세요. 번들된 Noto 서체와 구문 분할이 텍스트를 처리합니다.

하나의 제품을 판매하는 런치 필름을 만드세요: 거대한 글씨의 문제, 한 줄의 약속, 실제 제품 화면에서의 네 가지 증명 단계, 결과, 그리고 마지막 프레임까지 유지되는 요청. reference/ (옴니가미의 예제를 위해 만들어진 가상 개발자 도구 Lamplit; 스토리는 reference/STORY.md에 있음)의 완성된 필름에서 시작하세요. 그 도구 키트(타이포그래피, 커서, 페이지 카메라, 컬러 필드, 캡션 컬럼, 드로잉, 음악)는 유지되고, 단어, 화면, 단계는 사용자의 것으로 대체됩니다.

빌드 전에 style.md를 읽고, 평가 전에 critique.md를 읽으세요.

시작 또는 재개

  • Node 20+, ffmpeg 및 로컬 Chrome 계열 브라우저를 확인하세요 (scripts/chrome.mjs가 찾습니다. CHROME_PATH로 재정의 가능). 누락된 것이 있으면 설명하세요.
  • 사용자가 제공한 것: 제품의 URL, 보여주거나 피해야 할 것, 요청(가입, 설치, URL)을 사용하세요. 묻기 전에 사이트를 읽으세요. 사이트가 답할 수 없는 것에 대해 한 번만 물어보세요. 사용자가 질문을 원하지 않거나 무인 실행을 원한다면 사이트에서 결정하세요.
  • product-film/ 폴더가 이미 존재하고 film/STORY.md가 있다면, 이는 수정 작업입니다: 해당 필름에 대해 작업하세요. 다른 필름인 경우 새 폴더를 사용하고 PRODUCT.md의 브랜드 노트를 재사용하세요.

첫 번째 필름 설정:

mkdir product-film && cd product-film
cp -R "$SKILL_DIR/reference" reference && cp -R "$SKILL_DIR/scripts" scripts && cp -R "$SKILL_DIR/music" music
mkdir film && tar -C "$SKILL_DIR/reference" --exclude='./assets/screens' --exclude='./assets/brand' --exclude='./plans' -cf - . | tar -C film -xf -
npm init -y >/dev/null && npm i -D 'puppeteer-core@^24'

film/은 화면, 브랜드, 계획을 제외한 참조본입니다. puppeteer-core@^24는 Node 20에서 실행됩니다. 더 새로운 메이저 버전은 더 새로운 Node를 필요로 할 수 있습니다.

SKILL_DIR은 이 파일이 있는 폴더입니다. reference/는 비교를 위해 그대로 둡니다.

제품 파악 후 스토리 작성

  1. node scripts/capture.mjs <url> capture 실행: 모든 스크린샷을 보고 capture/brand.json을 읽으세요. 제품이 무엇을 하는지, 제품의 자체 용어, 브랜드 컬러와 마크, 제품이 하는 주장과 각 주장의 출처, 그리고 실제 UI에 접근할 수 있는 위치(페이지 자체, 라이브 데모, 샌드박스)를 찾으세요.
  2. reference/STORY.md의 형태로 film/STORY.md를 작성하세요. 하나의 스토리여야 하며, 기능을 소개하는 투어가 아니어야 합니다:
    • 시청자와 그들의 목표: 제품이 누구를 위한 것인지, 그리고 그들이 제품을 사용하는 한 가지 작업을 사이트의 자체 용어로;
    • 그들을 가로막는 문제: 사이트 자체가 명명하는 (훅): 기존 방식과 그것이 그들에게 초래하는 비용, 모든 줄이 취소선으로 표시됨;
    • 전환점: 훅에 대한 답을 자체 용어로 (문제의 반대를 최소한의 단어로), 제품 이름이 비트 내에 명명됨;
    • 실제 제품에서 목표를 향한 세 가지 또는 네 가지 단계: 각 단계는 캡션(시청자가 하거나 배우는 것, 몇 단어), 실제 화면과 캡처할 상태, 액션, 그리고 캡션에 답하는 화면상의 결과;
    • 보상: 목표 달성; 요청: 하나의 액션;
    • 120 BPM 그리드의 시간, 그리고 각 주장의 출처. 숫자는 인용한 출처에서만 가져옵니다. 낯선 사람의 입장에서 다시 읽으세요: 단계의 결과가 캡션에 답하지 않거나, 단계가 목표를 향해 나아가지 않는다면 수정하세요.
  3. 사용자에게 스토리를 몇 줄(다섯 막, 두 가지 액션)로 보여주고 한 번의 리뷰를 요청하세요. 단, 무인 실행을 요청한 경우는 제외합니다. 침묵을 승낙으로 간주하지 마세요.

실제 화면 캡처

  1. reference/plans/lamplit.json의 형태로 film/plans/app.json을 작성하세요 (형식은 scripts/screens.mjs 상단에 있음):
    • 스토리가 보여주는 모든 상태: click, type, drag (앱의 자체 눌린 상태를 위한 길게 누름) 및 capture 단계;
    • 각 화면은 전체, 스케일 3으로 캡처하여 카메라가 가까이 이동할 수 있게 함;
    • 입력 필드는 type과 그 패널 주변 around로 지정 (한 글자당 한 번 캡처);
    • rects: 카메라, 컬러 필드 또는 커서가 사용하는 모든 요소를 이름별로. 하나의 캡처 세트가 모든 형태를 제공합니다: 각 형태는 자체적으로 프레임을 구성합니다. 쿠키 배너는 click 단계로 해제하세요. 필름이 자체적으로 그리는 것은 hide를 사용하세요.
  2. 실행:
    node scripts/screens.mjs film/plans/app.json film/assets/screens
    
  3. 모든 캡처를 확인하세요. 각 상태가 올바를 때까지 계획을 수정하세요. UI에 로그인이 필요한 경우, 공개 데모, 사용자가 제공한 스크린샷, 또는 사용자가 명시적으로 승인한 이미 로그인된 로컬 브라우저를 사용하세요. 절대 자격 증명을 요청하지 마세요. 고객 데이터를 캡처하지 말고, 상상된 UI를 그리지 마세요.

필름 빌드

film/index.html을 편집하세요. 섹션은 KEEP, ADAPT, REPLACE로 레이블되어 있습니다.

  • ADAPT 단어: DEFAULTS 및 FIELDS를 STORY.md에서 가져오되, 단계 캡션(step1 … step4)과 그 시간을 STEPS에 포함하세요.
  • ADAPT 색상: 배경(INK, NIGHT, INK2), 텍스트, 그리고 제품의 하나의 악센트 색상 (참조본은 기본적으로 어두움; 밝은 제품은 자체 종이와 잉크 색상을 사용). 제품의 마크를 film/assets/brand/mark.svg에 넣으세요. 마크는 전환점 아래에서 커지고, 한 줄로 열리며, 락업을 이끕니다.
  • ADAPT 증명: P (각 클릭과 변경이 발생할 때), screenAt (어떤 캡처가 화면에 표시되는지), proofScene의 프레임 설정 (카메라가 전체를 보여주는 페이지 rect, 세로용 좁은 세트 포함), floats (어두운 필드 위에 단독으로 표시되는 요소), PATCH (상태가 제자리에서 진행될 때 변경되는 유일한 영역: 캡처를 비교하여 측정), SETTLED (각 단계의 결과가 화면에 안정될 때), 그리고 커서의 cursorSets. 앱이 여는 페이지는 컷으로 도착함; 제자리에서 변경되는 상태는 PATCH 내에서만 변경됨.
  • 모든 클릭은 커서와 동기화: 각 커서 세트를 clickKeys와 함께 작성 (주석은 Lamplit의 세 가지를 그렇게 보여줌). 커서는 미끄러져 들어와 도착하고 0.3–0.5초 동안 대상 위에 정지하며, 앱의 자체 눌린 상태가 정확히 보일 때 누름 (동일한 P 시간이 둘 다를 구동), 누르는 동안 정지, 그런 다음 떠남. 필드도 같은 방식으로 클릭됨; 누르기가 끝나면 단어 타이핑이 시작되고, 커서는 옆으로 물러나 타이핑하는 동안 정지함. 커서의 도착과 출구를 클릭의 양쪽에 배치하지 마세요: 버튼을 누르는 동안 미끄러져 나가는 꼴이 됨. APPROVED_CURSOR와 Lamplit의 자체 세트를 삭제 (승인된 컷은 이 규칙 이전의 것). 필름의 검사는 커서가 대상 rect 위에 정지하지 않거나, 누르기 0.25초 전에 움직인 경우 실패함.
  • ADAPT 보상과 요청: TILES (실제 화면 중 세 개)와 당신의 이름, 주소, 입력할 줄, 태그라인. 액트 시간을 마디선에 유지하고, 큐를 액트와 보조를 맞추세요.
  • KEEP 도구 키트, 카메라, 필드, 드로잉, 120 BPM 그리드, 그리고 시청자에게 필요한 여유 (style.md, "Pauses"): 각 단계의 캡션은 첫 번째 액션 전에 읽힘; 각 결과가 안정된 후, 다음 카메라 또는 커서 이동 전 약 1초 동안 읽을 시간; 페이지 변경 또는 긴 슬라이드 후, 클릭 전 화면 유지. 생동감 유지: 증명 부분에서 어떤 것도 약 1.8초 이상 정지하지 않음. 단어가 더 길거나 짧으면, 제품의 자체 작동이 아닌 유지 시간(TU, ST, P)을 이동. 단계에 34초보다 더 많은 시간이 필요하면, 필름을 한 번에 한 마디(2초)씩 늘려 최대 약 40초까지: ST와 DURATION을 함께 이동하고, 액트의 비율 유지 (style.md, "The five acts"), STORY.md의 시간 업데이트. 노래는 새 길이에 맞춰짐 (마지막 마디선에 최소 종료 3.5초 전에 도착); --music 사용 시 music.sections의 마지막을 새 마디 수로 늘림.

프로젝트 루트에 PRODUCT.md 작성: URL, 제품이 하는 일, 브랜드 색상과 마크 (라이선스 포함), 선택한 단어, 날짜.

리뷰, 렌더링, 전달

  1. 모든 형태에 대한 시트 및 폰 체크:
    node scripts/render.mjs film --all --times key --sheet
    node scripts/render.mjs film --all --phone
    
    그런 다음 모든 휩, 풀백, 플러드에서 12프레임 스트립을 가로와 세로로: node scripts/render.mjs film --size 9:16 --strip <time>.
  2. critique.md로 평가하고 최악의 문제를 수정. 배송 전에 새로운 판정을 받으세요. 에이전트가 이 세션의 메모리 없이 하위 에이전트를 시작할 수 있다면, critique.md, STORY.md, 이미지만 주고 다른 것은 없이 시작하여 발견한 문제를 수정하세요. 그렇지 않으면 critique.md를 다시 읽고 이미지만으로 평가. 8점 미만은 배송 금지. 세 번의 라운드 후 남은 문제를 보고.
  3. 반복성, 새 페이지, 긴 이름, 필름 자체 검사 확인: node scripts/render.mjs film --all --check --check-fresh --stress. 세 가지 형태 모두 통과할 때까지 렌더링하지 마세요. 새 페이지만 다른 프레임은 일반적으로 필름 중간에 처음 그려진 이미지를 의미: prepare()에서 한 번 그리도록 수정. 오버플로우되는 이름은 스트레스 길이에서 해당 형태에 맞아야 함. 검사는 또한 커서가 대상 위에 정지하지 않은 누름, 커서가 움직이는 상태에서의 필드 타이핑, 다음 이동까지 0.9초 미만의 결과, 클릭 전 읽을 시간이 없는 캡션, 증명 부분에서 1.8초 초과 정지, 마디 그리드에서 벗어난 길이를 실패 처리. 타이밍을 수정하고 검사는 수정하지 마세요.
  4. 렌더링:
    node scripts/render.mjs film --all --video --blur 4 --audio music/song.mp3 --sound --poster <time>
    
    이 명령은 out/16x9.mp4, out/1x1.mp4, out/9x16.mp4를 작성: 60fps, 모션 블러, 스킬의 노래와 효과, 약 -14 LUFS. 몇 분이 소요됨: 포그라운드에서 실행하고 세 파일 모두 완료될 때까지 기다린 후 전달하세요. 무인 실행에서 백그라운드에 남겨진 렌더는 세션이 종료될 때 중단될 수 있음. 노래 (music/song.mp3: 120 BPM의 누디스코)는 각 형태에 맞춰짐: 마디선에서 시작하고, 끝 근처에서 한 번의 히트에 도착하여 드럼이 멈추고 나머지가 닫히고 페이드아웃 (music/song-stems/의 스템에서). --from <seconds>로 다른 8마디 섹션 시작 가능 (노래는 약 2분 길이). --music은 합성된 점수 대신 사용; 사용자 자체 노래는 --audio their.wav로 작동.
  5. node scripts/preview.mjs film 실행하고 로컬호스트 주소를 제공. 모든 형태를 재생하고 단어를 편집; 저장된 편집은 MP4에 반영되려면 새 렌더링 필요.
  6. README.md (파일, 미리보기 방법, 단어 변경 방법, 렌더링 방법) 및 out/CAPTION.md (제품 자체 단어로 280자 미만의 게시물, URL 포함) 작성. MP4 링크, 포스터, 캡션, 간단한 검사 요약, 필름을 가장 개선할 한 가지 변경 사항을 전달. 상세 점수는 out/REVIEW.md에 저장.

수정 사항

"결과를 더 오래 유지" 또는 "내보내기 표시"와 같은 요청의 경우, 현재 스토리와 필름을 편집. 승인된 부분과 사용자가 저장한 단어는 유지. 변경된 상태만 다시 캡처하고, 검사를 다시 실행하고, 다시 렌더링하고, STORY.md와 PRODUCT.md 업데이트.

엄격한 규칙

  • 실제 화면만, 캡처됨; 샘플 데이터만; 사용자의 브랜드만.
  • 화면의 모든 주장은 STORY.md에 출처가 있음.
  • 숨 쉴 공간: 각 단계의 캡션은 어떤 것도 움직이기 전에 읽히고, 요소는 액션을 가하기 전에 보이며, 각 결과는 다음 카메라 또는 커서 이동 전 약 1초 동안 읽힘. 약 1.8초 이상의 정지 금지. 스토리가 맞지 않으면 한 번에 한 마디씩 필름을 늘리거나 (최대 약 40초) 한 단계를 제거; 절대 유지 시간을 압축하지 마세요.
  • 커서는 누를 때 대상 위에 정지해 있어야 하며, 앱의 자체 눌린 상태와 시간이 일치해야 함 (clickKeys).
  • seek(t, values)는 인수에서만 페인팅: 시계, 시드되지 않은 난수, 타이머, 네트워크 없음. CPU 기반 캔버스, 매 프레임 리셋.
  • 필름이 로드하는 모든 파일은 film/ 내부에 있어야 함.

파일

  • reference/: Lamplit의 런치 필름, STORY.md, 캡처 계획 (plans/lamplit.json), 캡처된 화면, 마크, 그리고 OFL 라이선스가 있는 폰트 (Instrument Sans, JetBrains Mono). Lamplit은 옴니가미의 예제를 위해 만들어진 가상 회사입니다.
  • style.md: 숫자가 포함된 문법. critique.md: 리뷰.
  • music/: 스킬의 노래와 스템.
  • scripts/: screens.mjs (상태의 실제 화면), capture.mjs (URL에서 브랜드), render.mjs (스틸, 스트립, 검사, MP4), preview.mjs, music.mjs, song.mjs (제공된 노래 맞춤), sfx.mjs (사운드 키트 포함), chrome.mjs.

이 스킬은 omnigami의 자산이며, © 2026 Auberon LLC. 이것으로 만든 것을 상업 작업을 포함하여 어떤 용도로든 사용하고, 자신의 용도로 스킬을 변경할 수 있습니다. 스킬을 재배포하거나 판매하지 마세요. 전체 이용약관: LICENSE.md

Individual skills in this repo

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

관련 스킬