제품 릴 (코스 04단계, 레벨 L2)
실제로 판매하는 제품에 스튜디오를 조준하세요. 쇼릴의 에너지는 유지되며, 콘텐츠는 사용자의 것이 됩니다: 실제 스크린샷, 실제 로고, 실제 색상과 폰트, 실제 카피, 하나의 실제 숫자, 그리고 모션이 따라가는 음악. 브랜드 스테이지 이후의 모든 것은 표준 모션릴 파이프라인을 따릅니다.
요청 인수(비어 있을 수 있음), 한 번 표시됨; 이후 섹션에서는 "위 요청"이라고 함:
범위: 사용자가 자산만 캡처하거나 수정하기를 원하거나, 모션릴의 브랜드 스테이지에서 여기로 왔다면, 섹션 2와 3(및 요청 시 4)을 수행하고 보고한 후 중단합니다. 완전히 새로운 영화를 원한다면 모든 섹션을 따르십시오; 섹션 5에서 8은 모션릴 파이프라인으로 핸드오버됩니다.
패턴의 출처
- Tony Dinh(@tdinh_me)는 TypingMind 릴이 30분도 안 걸려 제작되었는데, 이전에는 비슷한 비디오에 약 $1,000 이상을 지불했었다고 보고했습니다. 그의 프롬프트는 쇼릴 한 줄 프롬프트와 네 가지 짧은 방향 지시문이었습니다: 제품 URL 소개; 실제 제품 스크린샷, 로고 및 자산 사용; 비디오에 음악이 있고 모션이 음악과 일치해야 함; 실제 전문 프로덕션으로 만들되 데모나 프로토타입이 아니어야 함. 그는 Claude가 브랜드 자산을 스스로 수집했다고 말했습니다.
- 그의 후속 요청은 스크린샷을 원시 스크린샷으로 보여주는 대신 움직일 수 있도록 컴포넌트와 아이콘으로 분해하고, 모션을 더 풍성하게 만들어 달라는 것이었습니다. 그것이 아래의 컴포넌트 규칙입니다.
- 그의 프롬프트는 "Try again, ultracode."로 끝났습니다. 현재 Claude Code에서
ultracode는 Claude가 작업을 위한 멀티 에이전트 워크플로우를 작성하게 하는 키워드입니다. 이것이 그의 결과를 주도했는지는 문서화되지 않았습니다; 품질 스위치로 제시하지 마십시오. - Rob Hallam(@robj3d3)은 첫 번째 릴과 동일한 Claude Code 채팅에서 자신의 제품에 대한 두 번째 릴을 만들었습니다. 코스는 엔진이 재사용되었다고 추론합니다; 따라서 브랜드당 하나의 세션과 하나의 프로젝트입니다.
- 반대 사례: @mablesjoseph이 한 줄로 자산 폴더에서 "멋지고 강력한" 프로모션을 요청했지만 결과는 "공유하기에 충분하지 않았습니다". 방향성이 자산만큼 중요합니다.
1. 입력
위 요청이 다루지 않는 항목을 한 번의 AskUserQuestion 라운드에서 물어보십시오:
| 입력 | 기본값 | 규칙 |
|---|---|---|
| 제품 URL 및 이름 | 필수 | 사용자 자신의 제품 또는 프로모션 권한이 있는 제품 |
| 길이 | 20초 | 2~4초의 5개 스토리 비트 |
| 형식 | 9x16 우선, 그 다음 1x1, 16x9 | 동일한 타임라인, 재구성됨 |
| CTA | 질문 | 정확한 화면상 단어 |
| 하나의 증명 숫자 | 질문 | 사용자 또는 해당 사이트에서 가져와야 함; 절대 발명하지 마십시오 |
| 음악 | 합성, 120 BPM | 제공된 트랙은 이 사용에 대한 라이선스가 필요함 |
| 음성/마스코트 | 없음 | 음성은 .env에 ELEVENLABS_API_KEY가 필요함 |
| 참고용 룩 | 없음 | 선택 사항, /motion-studio:reference-style 사용 |
2. 프로젝트
브랜드당 하나의 프로젝트 폴더(이상적으로는 하나의 세션). studio.json이 없는 경우:
node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install
스킬 전용 설치의 경우: ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs. 그런 다음 npm run doctor.
3. 브랜드 캡처
프로젝트 루트에서 캡처 스크립트를 실행합니다(또는 이 정확한 명령과 프로젝트 경로로 motion-studio:asset-scout에 간략히 브리핑):
node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
| 플래그 | 용도 |
|---|---|
--viewports desktop,mobile | 기본값; tablet도 사용 가능 |
--full-page | 섹션을 자를 긴 스크린샷 |
--selector "<css>" | 특정 제품 부분 자르기(반복 가능): 히어로, 가격 카드, 대시보드 패널 |
--dismiss-banners | 일회용 브라우저에서 명백한 쿠키 또는 동의 버튼 클릭(영어, 한국어, 일본어, 중국어, 독일어, 프랑스어 또는 스페인어로 수락, 동의, 허용; 배너 또는 대화상자 내에서만 OK 또는 닫기와 같은 약한 레이블 포함). 매니페스트에 어떤 버튼이 클릭되었는지 또는 일치하는 것이 없음을 기록 |
--apply-brand | 이름, URL 및 제안된 색상을 studio.json에 기록 |
--dark | 다크 테마 캡처 |
--no-fonts | 글꼴 다운로드 건너뛰기(기본값: 페이지가 로드하는 웹 폰트 저장) |
--allow-private | 페이지가 루프백, LAN 및 링크-로컬 주소에 도달하도록 허용(기본값: 대상 자체 호스트 및 포트만); 사용자가 신뢰하는 페이지(예: 사용자 자신 제품의 로컬 개발 서버)에만 사용 |
--no-sandbox | 렌더러 샌드박스 없이 Chrome 시작(MOTION_NO_SANDBOX=1도 가능; Linux에서 root로 실행 시 자동, Chrome이 샌드박스로 시작할 수 없음); 꺼져 있을 때마다 메시지 출력 |
--json | 하나의 JSON 결과 라인 |
다음을 기록합니다: assets/brand/screens/, assets/brand/logo/, assets/brand/components/, assets/brand/og-image.* 및 assets/manifest.json(제안된 역할이 있는 팔레트, CSS 색상 변수, 사용 중인 폰트, 헤드라인, 버튼 및 탐색 카피, 메모). 이미지 확장자는 파일 바이트에서 결정되며, 페이지 외부의 컴포넌트 크롭은 메모와 함께 건너뜁니다. 페이지가 실제로 로드하는 웹 폰트는 assets/fonts/에 저장되고 assets/fonts/fonts.json에 등록됩니다(기존 항목은 절대 덮어쓰지 않음); 각각의 license는 매니페스트에 UNVERIFIED 상태로 유지되며, 라이선스 URL 또는 파일이 발견되지 않는 한 그렇습니다. 스크립트는 게시 전에 확인하라는 알림을 출력합니다. 실패한 실행은 이전 캡처를 유지합니다. 세부 사항 및 매니페스트 스키마: references/asset-capture.md.
로고 및 타입. 헤더에 로고 이미지나 SVG가 없으면 브랜드는 일반적으로 텍스트 워드마크입니다. 캡처는 이를 manifest.brand.wordmark에 텍스트로 기록하고(마크업, 역할별 색상, 계산된 폰트 패밀리, 두께, 크기 및 자간) assets/brand/logo/wordmark-crop.png 참조 크롭을 추가하며, 로고 파일만 요청하는 대신 메모에 이를 명시합니다. 해당 기록에서 재구성하십시오; 영화에 정확한 로고가 필요한 경우에만 SVG 또는 PNG를 요청하십시오.
폰트. 로그 라인 font registry: <family>: ...(및 manifest.fonts.registry)는 사용 중인 모든 패밀리에 대해 assets/fonts/fonts.json에 이미 있는지, 라이선스가 확인되었는지(라이선스 ID 및 텍스트 기록 있음) 또는 UNVERIFIED인지, 그리고 이번 실행에서 추가된 내용을 명시합니다. 동일한 패밀리의 확인된 항목 옆에 도착하는 폰트는 해당 라이선스를 재사용합니다.
UI 상태 및 캔버스 프레임
capture.mjs는 로드 시 한 번 촬영합니다. 두 개의 관련 스크립트가 나머지를 다룹니다; 둘 다 --help를 출력하고, 프로젝트 내에서만 기록하며(기본값 assets/brand/), 동일한 보안 스택 뒤에서 실행됩니다(Windows의 헤드리스 셸, 렌더러 샌드박스 켜짐, 개인 주소 거부, 비밀 정보 숨김). 플러그인 설치: 아래 명령어. 스킬 전용 설치( ${CLAUDE_PLUGIN_ROOT} 없음): 스크립트는 이 파일 옆에 있으므로 node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ...을 실행하십시오(마찬가지로 capture.mjs 및 canvas-frames.mjs); Node와 실행 폴더에서 확인되는 playwright만 필요하며(--root <folder> 전달), 프로젝트, studio.json 또는 tools/는 필요하지 않습니다. asset-scout 에이전트는 동일한 명령을 실행합니다.
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
| 스크립트 | 대상 | 기록 |
|---|---|---|
states.mjs | 보호된 제품(모달, 동의), 내부 창에서 스크롤되는 앱, 클릭 뒤의 상태, 계산된 스타일이 있는 요소 | assets/brand/states/<name>/: 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNG 및 states.json |
canvas-frames.mjs | 클릭할 때마다 변경되고 스스로 애니메이션되는 하나의 <canvas>인 화면 | assets/brand/frames/<clip>.png 스프라이트 시트 및 frames.json(프레임 크기, 실제 시간 및 모든 프레임의 해시); pack은 pack/<clip>.png 및 영화가 재생하는 프레임만 포함하는 pack.json을 추가 |
canvas-frames.mjs는 정수 비율로 drawImage(스무딩 끄기)를 사용하여 캔버스 버퍼를 복사합니다. 요소 스크린샷을 절대 사용하지 않습니다: 테두리 상자에 정수가 아닌 배율로 표시된 캔버스(1272 장치 픽셀의 1280 픽셀 버퍼)는 브라우저에 의해 리샘플링되어 픽셀 아트 캔버스가 흐려집니다. 버퍼의 정수 축소가 아닌 프레임 크기는 거부됩니다. 사용하기 전에 모든 PNG를 읽으십시오.
페이지는 신뢰할 수 없는 콘텐츠이므로 캡처는 실행 중인 머신을 보호합니다:
- Chrome은 렌더러 샌드박스를 켠 상태로 유지합니다(
manifest.sandbox에 기록). 컨테이너 또는 root로 실행되는 CI는--no-sandbox가 필요하며, 신뢰하는 페이지에 대해서만 사용하십시오. - Windows에서 브라우저는 Playwright의 헤드리스 셸(
npx playwright install chromium-headless-shell)이며, 설치된 Chrome이나 Edge 자체를 사용하지 않습니다: 이러한 프로그램을 새 프로필로 실행하면 실패한 Windows 로그온으로 간주되어 계정을 잠글 수 있습니다. 하나를 선택하면(studio.jsonbrowser,MOTION_BROWSER,MOTION_CHROME_PATH) 실행 시 경고가 출력되며, 10분 내 4번째 실행은 거부되고 3번은 허용됩니다(references/asset-capture.md 참조). - 루프백, LAN, 링크-로컬(클라우드 메타데이터 포함) 및 비웹 주소에 대한 요청은 대상 자체 호스트 및 포트로 가는 경우를 제외하고 중단됩니다. 거부는
manifest.blocked와 메모에 나열됩니다. URL 자체가 거부되면 실행은 실패하고 아무것도 저장하지 않습니다. 신뢰하는 페이지에 대해--allow-private을 전달하십시오. - URL의 자격 증명(
https://user:pass@host/)은 대상 출처에만 HTTP 인증으로 전송됩니다. 자격 증명이나 비밀처럼 보이는 쿼리 값(token,key,sig,session,code...)은 로그,manifest.json,states.json또는studio.jsonbrand.url에 나타나지 않습니다(***로 대체됨). - 스펙룰레이션 규칙(
<script type="speculationrules">)을 선언하는 페이지는 Chrome이 요청 필터가 보지 못하는 로컬 주소를 직접 가져올 수 있습니다; 매니페스트가 이를 기록합니다. 민감한 로컬 서비스가 있는 머신에서 신뢰하지 않는 페이지를 캡처하지 마십시오.
그런 다음, 애니메이션 전에:
- 찾은 항목을 사용자에게 나열합니다: 화면, 로고 후보, 제안된
bg/fg/accent/muted, 폰트, 헤드라인 및 CTA 카피, 모든 메모(봇 확인, 로고 누락). - 팔레트와 폰트를 확인하거나 수정하고,
studio.jsonbrand를 기록합니다. 캡처된 폰트는 이미assets/fonts/에 있지만, 라이선스가 확인된 후에만 사용하십시오(UNVERIFIED는 아무도 확인하지 않았음을 의미). Google 폰트는npm run fonts -- add "Family:400,700"로 구매하고, 상업용 폰트는 사용자 자신의 라이선스 또는 파일이 필요합니다. 한국어 또는 기타 CJK 카피에는 해당 글리프가 있는 폰트가 필요합니다:npm run fonts -- coverage --text "..." --family "Name". - 누락된 항목을 발명하지 말고 요청하십시오: SVG 로고, 정확한 강조 색상 헥스 코드, 로그인 뒤의 스크린샷.
4. 컴포넌트, 원시 스크린샷이 아님
- 캡처된 화면의 일부를 별도의 이미지로 자릅니다(
--selector또는 자동 크롭: 헤더, 히어로, CTA 버튼, 카드, 제품 이미지, 가격 책정, 섹션). 부품을 애니메이션합니다: 카드가 레이아웃으로 슬라이드, 버튼이 눌림, 차트 패널이 그려짐. - 실제 색상, 카피 및 크롭에서 측정된 반경을 사용하여 캔버스에서 간단한 UI 크롬(버튼, 토글, 필드)을 재구성합니다. 이는 재조판이지 발명이 아닙니다: 레이아웃, 레이블 및 데이터는 제품과 정확히 일치해야 합니다.
- 존재하지 않는 제품 화면을 절대 그리지 마십시오. 플레이스홀더 카피, 로렘 입숨, 가짜 숫자 없음. 필요한 화면이 없으면 요청하십시오.
5. 음악 및 비트 그리드(샷 리스트 전)
실제 그리드에서 모든 것을 시간을 측정하므로, 누군가 샷을 작성하기 전에 음악을 측정하거나 합성하십시오:
- 제공된 트랙:
node tools/beats.mjs audio/<track>, 그런 다음studio.jsonaudio.music을 가리키고bpm및duration을 설정하십시오. 첫 번째 다운비트는 0초 이후에 있거나 120과 다른 템포일 수 있으며, 샷 리스트는 가정된 그리드가 아닌 이를 따라야 합니다. - 트랙 없음:
node tools/score.mjs --style pulse --bpm 120 --dur 20(UI가 많은 영화의 경우minimal).audio/music.wav및 분석용audio/beats.json을 기록합니다. - 보이는 모든 히트는 큐를 받습니다; 모션은 음악을 따르며, 그 반대가 아닙니다.
6. 스토리 비트
assets/brand-prompt.md에 사용자의 사실을 사용하여 브랜드 스토리를 작성하고 motion-studio:motion-director에 전달하여 docs/shotlist.md를 생성하십시오; 디렉터는 audio/beats.json을 읽으므로 섹션 5가 먼저 옵니다. 기본값 20초, 120 BPM, 비트당 2~4초, 다운비트에서 장면 변경:
| # | 비트 | 그림 | 소리 |
|---|---|---|---|
| 1 | 후크, 0~2초 | 거대한 키네틱 타입의 최대 5단어로 문제점; 프레임 0은 이미 구성됨 | 다운비트에서 쿵 |
| 2 | 제품 등장 | 실제 UI가 조각조각 조립됨 | 휙 들어오고, 부품에서 팝 |
| 3 | 세 가지 기능 | 각각 커서가 실제 동작을 수행하는 UI 순간 | 각 누름에서 클릭 |
| 4 | 증명 | 하나의 실제 숫자가 제자리에 튀어나옴 | 딱 또는 짤랑 |
| 5 | 락업 | 로고 + CTA, 마지막 다운비트에서 최종 히트 | 상승 후 히트 |
샷 리스트를 표시하고 사용자의 승인을 기다리십시오(먼저 계획), 자율 모드를 요청하지 않은 한. 나중에 그리드가 변경되면(다른 트랙, 다른 bpm 또는 duration), 리스트를 다시 시간 측정하고 다시 표시하십시오.
7. 음성 및 마스코트
- 음성(선택 사항):
audio/voice.json작성(assets/voice-script.example.json 참조): 비트당 한 줄, 섹션 5의 그리드 다운비트에서t, 짧은 문장.npm run voice -- --dry-run을 실행하고npm run voice가 크레딧을 사용하기 전에 사용자에게 문자 수를 알리십시오(동일한 줄은 한 번 합성되어 청구됩니다). 믹서는 음성 아래에서 음악을 덕킹합니다. - 마스코트(선택 사항): 하나의 고유한 정체성(모양, 브랜드에서 샘플링된 팔레트, 비율)을 가진 코드로 그려진 캐릭터로,
playful스프링으로 비트에 반응합니다.
8. 모션 릴 핸드오버
샷 리스트가 승인되면 motion-studio:motion-director를 호출하고, 디렉터는 모션 릴 스킬을 호출합니다. 최종 결과는 선택한 형식으로 전문적인 제품 영화여야 하며, 원시 스크린샷이 아닌 브랜드 자산을 사용하고, 가짜 데이터가 없어야 합니다.