Communitygithub.com

motion-spot

에이전시 수준의 모션 그래픽 스팟(제품 광고, 앱 광고, 스펙 광고, 런칭, 브랜드 인트로, 쇼릴)을 코드만으로 제작합니다. HTML, GSAP, CSS 3D, Three.js를 사용하며, 프레임 단위 렌더링, 실제 모션 블러, 음성 해설, 배경 음악을 지원합니다.

motion-spot란 무엇인가요?

motion-spot은 AI 에이전트(Claude Code, Cursor 등)가 사용자의 요청(“스팟 만들어줘”, “모션 그래픽”, “앱/비즈니스 광고”, “Apple/Nike/Spotify 스타일”)을 받아 에이전시 수준의 모션 그래픽 비디오 스팟을 완전히 코드로 생성하게 해주는 스킬입니다. HTML, GSAP, CSS 3D, Three.js로 모든 프레임을 웹 페이지 상태로 구현하며, 브라우저에서 프레임 단위로 캡처한 후 ffmpeg로 실제 모션 블러, 글로우, 그레인을 포함한 MP4를 렌더링합니다. 주요 워크플로우는 1) 컨셉 및 아키텍처 설정, 2) 음성 대본 작성, 3) 스토리보드(샷 리스트) 작성, 4) 비주얼 시스템(CSS 변수) 구축, 5) 음성 녹음(ElevenLabs 또는 macOS say), 6) 장면별 코드 작성(GSAP 타임라인), 7) 배경 음악 생성 및 믹싱, 8) 렌더링 및 리뷰, 9) 최종 제출입니다. 사용자는 자신의 로고, 앱 스크린샷, 제품 사진, 참조 영상 등을 제공할 수 있으며, 스킬은 이를 충실히 재현하여 독창적이면서도 브랜드 정체성을 살린 결과물을 만듭니다. 최종 산출물은 `salida/spot.mp4`와 `salida/spot-subida.mp4`이며, 함께 생성된 `DECISIONES.md`에 제작 과정과 결정 사항이 기록됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/santiagosantofimio/motion-spot/tree/HEAD

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

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

문서

motion-spot은(는) 무엇을 하나요?

스튜디오 수준의 스팟을 제작합니다. Claude로 제작되어 수백만 뷰를 기록한 45개의 스팟을 분석한 방법론을 기반으로 합니다(references/estudio.md). 모든 성공 사례에 공통된 핵심 레시피는 다음과 같습니다:

긴장감이 있는 컨셉(기능 나열이 아님) + 실제 인터페이스나 제품을 주인공으로 + 키네틱 타이포그래피 + 절대 멈추지 않는 카메라 + 음성이 언급되는 순간에 맞춰 등장하는 모든 요소 + 브랜드 컬러의 절정 + 로고와 슬로건으로 마무리되는 깔끔한 엔딩.

모든 것은 코드로 이루어집니다. 각 프레임은 웹 페이지의 상태입니다. GSAP 타임라인을 일시 정지한 상태에서 Chrome 창 없이 프레임 단위로 탐색하며, ffmpeg가 모션 블러, 글로우, 그레인을 포함한 MP4를 조립합니다. 엔진은 이미 plantilla/motor/에 구현되어 있으며, plantilla/escenas.js에 완전한 예제 스팟이 포함되어 있습니다.

사용자가 참조 영상을 제공한 경우("똑같이 만들어줘")

  1. 디자인 전에 참조 영상을 분석합니다: 주요 구간의 초당 8~12프레임을 적절한 크기로 추출하여(Read로 접촉 시트 생성), 각 요소(실제 UI, 폰트, 색상, 등장/퇴장 방식(늘리기, 블러, 뒤집기))를 주석으로 기록합니다.
  2. 구조와 실제 요소를 그대로 복사하며, "일반적인 대체 요소"를 사용하지 않습니다. 원본이 iMessage 말풍선을 사용했다면 -apple-system(시스템 SF)과 꼬리가 있는 말풍선을 사용하고, Spotify의 가사 카드를 사용했다면 태그, 버튼, 색상을 그대로 재현하고, 거대한 단어를 사용했다면 Arial Black(macOS 내장)을 사용합니다.
  3. 타이포그래피: 절대 기본 폰트를 사용하지 않습니다. 사용자는 여러 번 Claude 기본 폰트(간격이 좁고 tracking이 심하게 negative인 검은색 산세리프, Inter, 이탤릭 세리프)를 거절했습니다. 브랜드의 실제 정적 폰트(예: SocialMedia/fuentes/의 MonaSans-Black/Bold/Regular.ttf, 일러스트레이션 비디오에서 사용된 동일한 폰트)를 tracking은 최대 -0.01em으로 사용하고, 참조가 있으면 해당 폰트를 사용하거나, 렌더링 전에 3가지 샘플을 보여주고 선택을 요청합니다. 가변 폰트의 중간 굵기와 좁은 tracking은 절대 사용하지 않습니다. 3b. "Claude 스타일"은 기본적으로 금지: Inter/Anton/이탤릭 세리프/HUD 모노 폰트는 참조 영상이나 브랜드가 사용할 때만 사용합니다. 참조가 있는 경우, 타이포그래피와 요소는 참조를 따릅니다.
  4. 실제 스크린샷 요청: 앱, 플레이어, 커버 등 충실히 재현할 수 없는 것은 사용자가 activos/에 넣도록 요청합니다. Spotify 등 일부 앱은 정책상 제어가 차단될 수 있습니다. 차단을 우회하지 않고, 스크린샷을 요청하거나 공개 이미지를 사용하고 그 사실을 알립니다.
  5. 자체 버전과 참조 영상을 나란히 비교한 사진 시트를 보여주고, 전달 전에 차이점을 수정합니다.
  6. references/referencia-fiel.md를 읽습니다: 전체 프로세스, 각 요소별 레시피(Apple Messages 말풍선, Spotify 가사 카드, SVG 컨트롤, 슬라이딩 셰이딩) 및 이미 시간을 소비한 오류 목록. motor/ui.js와 motor/ui.css에 기성 부품이 있으며, ejemplos/video-con-letra/에 전체 예제가 있습니다.

시작 전에

알아야 할 사항이 있으며, 명확하지 않으면 단일 메시지로 질문하고, 기본값을 제안하십시오:

  1. 광고할 대상과 대상 고객(한 줄).
  2. 실제 에셋: 로고(가급적 SVG), 앱 또는 웹사이트 스크린샷, 제품 사진, 색상. 웹사이트도 가능합니다. 실제 에셋이 없으면 브랜드가 평범해 보이므로, 항상 요청하십시오. 없다면 예시 아이덴티티를 디자인하고 그 사실을 명시합니다.
  3. 형식 및 길이: 기본 9:16, 15~20초. 웹 또는 YouTube는 16:9.
  4. 음성: ElevenLabs(최종), say(초안) 또는 음성 없음.
  5. 음악: 엔진이 작곡하거나 사용자 제공 트랙 사용(게시용으로 권장).

사용자가 완성된 의뢰(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, 레시피, 알려진 함정)를 읽습니다. 각 장면:

  1. spot.escena('id', (capa, c) => { ... })로 세 개의 레이어, 카메라 드리프트, 기법을 구현합니다.
  2. 음성과 동기화: spot.cuando('id', 'palabra').
  3. 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가지 구체적인 개선 사항.

절대 깨지 않는 규칙

  1. 모든 것은 시간 t의 함수입니다. 스팟에 Math.random, Date.now, CSS 애니메이션, setTimeout, requestAnimationFrame을 사용하지 마십시오. 무작위성은 ruido(i) 또는 azar(semilla)를 사용하십시오.
  2. GSAP이 애니메이션하는 요소의 CSS에 transform을 절대 넣지 마십시오. (xPercent/yPercent 사용). 요소 정렬 불량의 가장 큰 원인입니다.
  3. 각 장면의 사진을 확인한 후에만 진행하십시오. 확인하지 않은 것은 전달하지 마십시오.
  4. 실제 에셋을 사용하거나 예시임을 명시하십시오. 인터페이스는 스크린샷을 기반으로 충실히 재현하며, "일반적인" 인터페이스를 임의로 만들지 마십시오.
  5. 타사 브랜드: 사용자의 것이 아닌 실제 브랜드의 스팟은 포트폴리오 연습("스펙")입니다. 공식인 것처럼 게시하지 말고, 브랜드와의 관계를 암시하지 말며, 로고를 변형하지 마십시오.
  6. 데이터: 사용자의 데이터이거나, 예시 데이터임을 명시하십시오.
  7. 듣고 확인할 수 없습니다. 레벨(피크 -1~-2dB, -14 LUFS)을 확인하고 음성이 음악 위에 잘 들리는지 확인하며, 사용자가 직접 듣고 판단합니다.
  8. 컨텍스트: 스팟 제작은 컨텍스트를 많이 사용합니다. 세션이 컨텍스트의 40%를 초과하면 제작을 계속하기 전에 압축하십시오.
  9. 노래 가사: 사용자가 제공하더라도 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 사용

관련 스킬