Communitygithub.com

모션 스튜디오 (Motion Studio)

실제 URL에서 제품 브랜드 자산(스크린샷, 로고, 색상, 폰트)을 캡처하고 편집하여 제품 영화의 브랜드 스테이지를 제작합니다. UI를 다시 그리지 않고 실제 데이터를 사용합니다.

모션 스튜디오 (Motion Studio)란 무엇인가요?

이 스킬은 실제 판매 중인 제품을 대상으로 브랜드 자산을 캡처, 분석, 편집하여 전문적인 제품 영화(모션 릴)의 브랜드 스테이지를 제작합니다. 사용자가 제공한 URL을 기반으로 실제 스크린샷, 로고, 색상, 폰트, 버튼/헤드라인 문구 등을 자동으로 추출하고 분석하여 프로젝트를 초기화합니다. 캡처된 자산을 바탕으로 UI 구성 요소를 분리하여 애니메이션 가능한 부품으로 변환하고, 실제 제품 데이터(헤드라인, CTA, 숫자)만을 사용하여 가짜 데이터를 절대 생성하지 않습니다. 이 스킬은 Claude Code 플러그인 환경에서 실행되며, `capture.mjs`, `states.mjs`, `canvas-frames.mjs` 등의 스크립트를 통해 브랜드 자산을 수집하고, `motion-director` 에이전트와 협력하여 최종 영화의 샷 리스트를 생성합니다. 또한 음악(BPM 분석 또는 합성), 음성(ElevenLabs API), 마스코트 등의 옵션을 지원하며, 보안 및 개인정보 보호를 위해 캡처 과정에서 비밀 정보를 자동으로 마스킹하고, 트러스트되지 않은 페이지는 네트워크 요청을 제한합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/product-reel

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

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

문서

제품 릴 (코스 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.json browser, 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.json brand.url에 나타나지 않습니다(***로 대체됨).
  • 스펙룰레이션 규칙(<script type="speculationrules">)을 선언하는 페이지는 Chrome이 요청 필터가 보지 못하는 로컬 주소를 직접 가져올 수 있습니다; 매니페스트가 이를 기록합니다. 민감한 로컬 서비스가 있는 머신에서 신뢰하지 않는 페이지를 캡처하지 마십시오.

그런 다음, 애니메이션 전에:

  1. 찾은 항목을 사용자에게 나열합니다: 화면, 로고 후보, 제안된 bg/fg/accent/muted, 폰트, 헤드라인 및 CTA 카피, 모든 메모(봇 확인, 로고 누락).
  2. 팔레트와 폰트를 확인하거나 수정하고, studio.json brand를 기록합니다. 캡처된 폰트는 이미 assets/fonts/에 있지만, 라이선스가 확인된 후에만 사용하십시오(UNVERIFIED는 아무도 확인하지 않았음을 의미). Google 폰트는 npm run fonts -- add "Family:400,700"로 구매하고, 상업용 폰트는 사용자 자신의 라이선스 또는 파일이 필요합니다. 한국어 또는 기타 CJK 카피에는 해당 글리프가 있는 폰트가 필요합니다: npm run fonts -- coverage --text "..." --family "Name".
  3. 누락된 항목을 발명하지 말고 요청하십시오: SVG 로고, 정확한 강조 색상 헥스 코드, 로그인 뒤의 스크린샷.

4. 컴포넌트, 원시 스크린샷이 아님

  • 캡처된 화면의 일부를 별도의 이미지로 자릅니다(--selector 또는 자동 크롭: 헤더, 히어로, CTA 버튼, 카드, 제품 이미지, 가격 책정, 섹션). 부품을 애니메이션합니다: 카드가 레이아웃으로 슬라이드, 버튼이 눌림, 차트 패널이 그려짐.
  • 실제 색상, 카피 및 크롭에서 측정된 반경을 사용하여 캔버스에서 간단한 UI 크롬(버튼, 토글, 필드)을 재구성합니다. 이는 재조판이지 발명이 아닙니다: 레이아웃, 레이블 및 데이터는 제품과 정확히 일치해야 합니다.
  • 존재하지 않는 제품 화면을 절대 그리지 마십시오. 플레이스홀더 카피, 로렘 입숨, 가짜 숫자 없음. 필요한 화면이 없으면 요청하십시오.

5. 음악 및 비트 그리드(샷 리스트 전)

실제 그리드에서 모든 것을 시간을 측정하므로, 누군가 샷을 작성하기 전에 음악을 측정하거나 합성하십시오:

  • 제공된 트랙: node tools/beats.mjs audio/<track>, 그런 다음 studio.json audio.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를 호출하고, 디렉터는 모션 릴 스킬을 호출합니다. 최종 결과는 선택한 형식으로 전문적인 제품 영화여야 하며, 원시 스크린샷이 아닌 브랜드 자산을 사용하고, 가짜 데이터가 없어야 합니다.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

관련 스킬