motion-spot은(는) 무엇을 하나요?
스튜디오 수준의 스팟을 제작합니다. Claude로 제작되어 수백만 뷰를 기록한 45개의 스팟을 분석한 방법론을 기반으로 합니다(references/estudio.md). 모든 성공 사례에 공통된 핵심 레시피는 다음과 같습니다:
긴장감이 있는 컨셉(기능 나열이 아님) + 실제 인터페이스나 제품을 주인공으로 + 키네틱 타이포그래피 + 절대 멈추지 않는 카메라 + 음성이 언급되는 순간에 맞춰 등장하는 모든 요소 + 브랜드 컬러의 절정 + 로고와 슬로건으로 마무리되는 깔끔한 엔딩.
모든 것은 코드로 이루어집니다. 각 프레임은 웹 페이지의 상태입니다. GSAP 타임라인을 일시 정지한 상태에서 Chrome 창 없이 프레임 단위로 탐색하며, ffmpeg가 모션 블러, 글로우, 그레인을 포함한 MP4를 조립합니다. 엔진은 이미 plantilla/motor/에 구현되어 있으며, plantilla/escenas.js에 완전한 예제 스팟이 포함되어 있습니다.
사용자가 참조 영상을 제공한 경우("똑같이 만들어줘")
- 디자인 전에 참조 영상을 분석합니다: 주요 구간의 초당 8~12프레임을 적절한 크기로 추출하여(Read로 접촉 시트 생성), 각 요소(실제 UI, 폰트, 색상, 등장/퇴장 방식(늘리기, 블러, 뒤집기))를 주석으로 기록합니다.
- 구조와 실제 요소를 그대로 복사하며, "일반적인 대체 요소"를 사용하지 않습니다. 원본이 iMessage 말풍선을 사용했다면
-apple-system(시스템 SF)과 꼬리가 있는 말풍선을 사용하고, Spotify의 가사 카드를 사용했다면 태그, 버튼, 색상을 그대로 재현하고, 거대한 단어를 사용했다면 Arial Black(macOS 내장)을 사용합니다. - 타이포그래피: 절대 기본 폰트를 사용하지 않습니다. 사용자는 여러 번 Claude 기본 폰트(간격이 좁고 tracking이 심하게 negative인 검은색 산세리프, Inter, 이탤릭 세리프)를 거절했습니다. 브랜드의 실제 정적 폰트(예:
SocialMedia/fuentes/의MonaSans-Black/Bold/Regular.ttf, 일러스트레이션 비디오에서 사용된 동일한 폰트)를 tracking은 최대 -0.01em으로 사용하고, 참조가 있으면 해당 폰트를 사용하거나, 렌더링 전에 3가지 샘플을 보여주고 선택을 요청합니다. 가변 폰트의 중간 굵기와 좁은 tracking은 절대 사용하지 않습니다. 3b. "Claude 스타일"은 기본적으로 금지: Inter/Anton/이탤릭 세리프/HUD 모노 폰트는 참조 영상이나 브랜드가 사용할 때만 사용합니다. 참조가 있는 경우, 타이포그래피와 요소는 참조를 따릅니다. - 실제 스크린샷 요청: 앱, 플레이어, 커버 등 충실히 재현할 수 없는 것은 사용자가
activos/에 넣도록 요청합니다. Spotify 등 일부 앱은 정책상 제어가 차단될 수 있습니다. 차단을 우회하지 않고, 스크린샷을 요청하거나 공개 이미지를 사용하고 그 사실을 알립니다. - 자체 버전과 참조 영상을 나란히 비교한 사진 시트를 보여주고, 전달 전에 차이점을 수정합니다.
references/referencia-fiel.md를 읽습니다: 전체 프로세스, 각 요소별 레시피(Apple Messages 말풍선, Spotify 가사 카드, SVG 컨트롤, 슬라이딩 셰이딩) 및 이미 시간을 소비한 오류 목록.motor/ui.js와motor/ui.css에 기성 부품이 있으며,ejemplos/video-con-letra/에 전체 예제가 있습니다.
시작 전에
알아야 할 사항이 있으며, 명확하지 않으면 단일 메시지로 질문하고, 기본값을 제안하십시오:
- 광고할 대상과 대상 고객(한 줄).
- 실제 에셋: 로고(가급적 SVG), 앱 또는 웹사이트 스크린샷, 제품 사진, 색상. 웹사이트도 가능합니다. 실제 에셋이 없으면 브랜드가 평범해 보이므로, 항상 요청하십시오. 없다면 예시 아이덴티티를 디자인하고 그 사실을 명시합니다.
- 형식 및 길이: 기본 9:16, 15~20초. 웹 또는 YouTube는 16:9.
- 음성: ElevenLabs(최종),
say(초안) 또는 음성 없음. - 음악: 엔진이 작곡하거나 사용자 제공 트랙 사용(게시용으로 권장).
사용자가 완성된 의뢰(references/encargo.md)를 가져오거나 "결정은 네가 해"라고 말하면, 질문하지 말고 제작하고 DECISIONES.md에 설명을 추가합니다.
워크플로우
1. 프로젝트
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot> # 예제 "Turnito"를 참조하여
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot> --limpio # 빈 템플릿
템플릿을 복사하고, 종속성을 설치하며(약 10초), Chrome이 사용 가능한지 확인합니다. 사용자 에셋을 activos/로 복사합니다.
2. 컨셉 및 아키텍처
references/arquetipos.md를 읽고 하나를 선택합니다(와우 포인트를 위해 하나의 샷을 빌려올 수 있음). 다음을 작성합니다:
- 한 문장으로 된 컨셉과 그 긴장감: "토요일의 혼란 vs. 세 번의 터치로 예약하는 평온."
- 브랜드 인사이트: 다른 브랜드는 절대 사용할 수 없는 브랜드 고유의 디테일(아마존의 A와 Z를 연결하는 화살표, 화면을 가르는 나이키 스우시). 이것이 없으면 스팟은 평범해집니다.
3. 음성 대본 → guion.json
references/voz-y-musica.md를 읽습니다. 애니메이션보다 먼저 음성을 작성합니다. 음성이 모든 타이밍을 결정하기 때문입니다. 장면당 한 문장, 2~8단어, 악센트와 여는 기호 포함. 상황에 따른 후크("새벽 2시입니다..."), 행동, 이점, 절정, 브랜드 + 슬로건. guion.json에 장면, BPM, 음악 스타일, pico(절정) 장면, 효과를 기록합니다.
4. 샷 리스트
장면별 한 행씩 표로 작성: 시간 · 음성 · 히어로 · 카메라 · 모션 그래픽 기법(3개 이상, references/lenguaje.md에서) · 종료 전환. 규칙:
- 샷당 세 개의 레이어: 움직이는 배경 + 히어로 + 디테일.
- 카메라는 항상 움직입니다. 모션 그래픽 전환 사용(비트에 맞춘 컷, 줌 스루, 커튼, 아이리스, 푸시). 페이드 인/아웃 금지.
- 스팟의 약 70% 지점에 브랜드 컬러 또는 3D로 절정을 만듭니다.
- 스팟 전체에 최소 8가지 다른 기법을 사용합니다.
스팟이 길거나 비용이 많이 드는 경우, 제작 전에 사용자에게 샷 리스트를 보여줍니다. 사용자가 "그냥 해"라고 말하면 진행합니다.
5. 비주얼 시스템 → estilo.css
references/diseno.md를 읽습니다. 변수(--fondo, --tinta, --acento, --acento2...)와 재현된 인터페이스의 클래스를 고유 접두사(.ui ...)와 함께 정의합니다. 타이포그래피: 굵고 좁은 산세리프 + 이탤릭 세리프 한 단어 + HUD용 모노 폰트(이미 설치됨: Inter, Instrument Serif, JetBrains Mono, Anton).
6. 음성 및 타이밍
- ElevenLabs: 장면당 한 번 생성 →
audio/voz/<id>.mp3→node motor/preparar.mjs --recortar. - 초안:
node motor/preparar.mjs --borrador-voz. - 이후
node motor/preparar.mjs: 음성을 측정하고, 컷을 비트에 맞게 양자화하며, 각 단어의 예상 시간을guion.tiempos.json에 작성합니다.
7. 장면별 제작 → escenas.js
references/motor.md(API, 레시피, 알려진 함정)를 읽습니다. 각 장면:
spot.escena('id', (capa, c) => { ... })로 세 개의 레이어, 카메라 드리프트, 기법을 구현합니다.- 음성과 동기화:
spot.cuando('id', 'palabra'). node motor/render.mjs --fotos <inicio+0.1>,<mitad>,<fin-0.1>를 실행하고 Read로 시트(salida/fotos/hoja.jpg)를 확인합니다. 계속 진행하기 전에 수정합니다.
plantilla/escenas.js(Turnito)를 고급 수준의 참조로 사용하십시오. 폐색, 궤도, 시계 바퀴, 알림, 복셀 3D, 커튼, 줌 스루가 어떻게 구현되는지 확인하십시오.
8. 음악 및 믹싱
node motor/musica.mjs # BPM에 맞춰 작곡, "pico" 장면에서 절정; 또는 guion.json의 사용자 트랙 사용
node motor/mezcla.mjs # 음성 + 음악, 덕킹 및 효과 포함, -14 LUFS로
node motor/servir.mjs로 사용자가 오디오와 함께 미리보기를 보고 탐색할 수 있습니다.
9. 렌더링, 리뷰 및 폴리싱
node motor/render.mjs --fotos # 12장 사진 시트: 구성, 철자, 안전 영역 확인
node motor/render.mjs --subida # 최종: 30fps, 4x 블러, 후처리, 10MB 미만 복사본(20초당 2~3분 소요)
references/calidad.md 체크리스트(세 번 패스)를 확인합니다. 그런 다음 폴리싱 한 번 더 수행: 보조적인 미세 애니메이션, 비트 악센트, 각 장면의 첫 프레임과 마지막 프레임 확인. 두 번째 패스가 좋은 결과물과 훌륭한 결과물을 가릅니다.
10. 전달
salida/spot.mp4및salida/spot-subida.mp4.- 커버 이미지: 가장 인상적인 순간의 스틸 프레임(첫 프레임이 아님).
DECISIONES.md: 컨셉, 아키텍처, 결정 사항, 폐기된 아이디어, 반복 횟수 및 소요 시간(calidad.md템플릿).- 채팅: 경로, 초안 여부(
say음성, 합성 음악), 2~3가지 구체적인 개선 사항.
절대 깨지 않는 규칙
- 모든 것은 시간
t의 함수입니다. 스팟에Math.random,Date.now, CSS 애니메이션,setTimeout,requestAnimationFrame을 사용하지 마십시오. 무작위성은ruido(i)또는azar(semilla)를 사용하십시오. - GSAP이 애니메이션하는 요소의 CSS에
transform을 절대 넣지 마십시오. (xPercent/yPercent사용). 요소 정렬 불량의 가장 큰 원인입니다. - 각 장면의 사진을 확인한 후에만 진행하십시오. 확인하지 않은 것은 전달하지 마십시오.
- 실제 에셋을 사용하거나 예시임을 명시하십시오. 인터페이스는 스크린샷을 기반으로 충실히 재현하며, "일반적인" 인터페이스를 임의로 만들지 마십시오.
- 타사 브랜드: 사용자의 것이 아닌 실제 브랜드의 스팟은 포트폴리오 연습("스펙")입니다. 공식인 것처럼 게시하지 말고, 브랜드와의 관계를 암시하지 말며, 로고를 변형하지 마십시오.
- 데이터: 사용자의 데이터이거나, 예시 데이터임을 명시하십시오.
- 듣고 확인할 수 없습니다. 레벨(피크 -1~-2dB, -14 LUFS)을 확인하고 음성이 음악 위에 잘 들리는지 확인하며, 사용자가 직접 듣고 판단합니다.
- 컨텍스트: 스팟 제작은 컨텍스트를 많이 사용합니다. 세션이 컨텍스트의 40%를 초과하면 제작을 계속하기 전에 압축하십시오.
- 노래 가사: 사용자가 제공하더라도 Claude는 코드,
letra.json, 채팅 어디에도 가사를 작성하지 않습니다. 가사가 있는 비디오의 경우:letra.json에 텍스트는 비워두고 타임스탬프만 기록하며, 가사 유무에 관계없이 작동하는 스팟을 만들고, 테스트 복사본에서 중립적인 문구로 검증한 후, 사용자가 가사를 붙여넣고 최종 렌더링을 실행합니다. 자세한 내용은references/motor.md→ "letra.json"을 참조하십시오.
뮤직 비디오 및 배경 비디오
node motor/extraer.mjs <video> --desde S --hasta S로 프레임(activos/clip/)과 오디오를 추출하고, videoCuadros(...)로 동기화하여 표시하며, motor/letra.js가 letra.json에서 가라오케를 생성합니다. 아키텍처 9번은 references/arquetipos.md를 참조하십시오.
문제 해결
| 증상 | 가능한 원인 |
|---|---|
window.spot.listo가 true가 아님 | escenas.js의 JS 오류: 렌더러가 페이지 오류를 출력합니다. import와 await spot.terminar()의 존재를 확인하십시오. |
| 요소가 정렬되지 않거나 튐 | CSS transform과 GSAP 충돌; 또는 다른 클래스와 충돌하는 클래스(.app); 또는 너무 포괄적인 하위 선택자 |
| 장면이 흰색 또는 검은색으로 보임 | id가 대본에 없음(preparar.mjs 실행 필요); 또는 전환으로 레이어의 opacity가 0이 됨 |
| 3D가 평평해 보임 | 중간 컨테이너에 transform-style: preserve-3d 누락; 또는 중간에 overflow나 filter가 있음 |
| 음성과 영상이 맞지 않음 | spot.cuando(...)에서 ±0.1초 조정; servir.mjs에서 오디오와 함께 확인 |
| 렌더링이 너무 오래 걸림 | 초안에는 --blur 1 --escala 0.5 사용; 그림자나 블러 노드 감소; voxelOla나 particulas의 n 값 낮춤 |
| MP4 파일 크기가 너무 큼 | 그레인 문제: --grano 3 또는 --crf 22; 업로드용은 --subida 사용 |