코드로 만드는 모션 그래픽
비디오는 코드에서 탄생합니다. t라는 단일 시계 변수로 각 프레임을 그리는 프로그램을 작성하고, 프레임 단위로 렌더링하여 MP4로 조립합니다. 따라서 HEX 색상, 브랜드 폰트, 숫자가 정확하게 나옵니다. 생성기가 아닌 코드로 쓰여졌기 때문입니다. 그래서 "30% 느리게" 또는 "9:16으로 변경" 같은 요청이 한 줄 수정으로 가능하며, 처음부터 다시 작업할 필요가 없습니다.
하지 않는 일: 사람, 장소, 제품 촬영; 완전한 포토리얼리스틱 이미지 생성; 브랜드 추측. 브랜드의 실제 사진, 비디오, 화면은 파일로 제공되어야 하며, 코드는 제공된 자료를 애니메이션화합니다.
기본 비디오는 <video>가 아닌 프레임 시퀀스로 처리됩니다: ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg로 추출하고, draw 함수에서 floor(t × fps) + 1로 이미지를 불러옵니다. <video>를 사용할 경우 렌더 서버가 Range 요청을 처리하지 못하고(seek 불가), 미디어 연결이 종료되지 않아(networkidle 타임아웃) 문제가 발생합니다.
요구 사항: Python 3.10+, pip install playwright + playwright install chromium (스크립트는 chrome 채널을 사용합니다. Chrome이 설치되지 않은 경우 abrir()에서 기본 Chromium으로 변경하세요), PATH에 ffmpeg와 ffprobe가 있어야 합니다.
이 스킬의 파일:
assets/template.html: 단일 시계, 고정 시드, 이징, 스태거, 타임바와 씬 이름이 있는 플레이어, 안전 영역을 포함한 엔진scripts/render.py: 프레임 단위로 MP4를 렌더링하고, 짧은 버전과 검토 시트도 생성합니다.tecnicas.md: 7개 그룹, 39개의 기법. 각 기법의 매개변수와 목적별 조합이 설명되어 있습니다.exemplos/reel-resultado-8s.html: 완성된 8초 작품 예제 (숫자 셔플 → 막대 → 컨페티 포함 CTA), 샘플 데이터 포함.
작업 폴더: 작품별로 한 폴더 (예: motion/<브랜드>/<작품명>/). HTML, 에셋(로고, 사진, 폰트), MP4, 검토 시트가 모두 함께 위치합니다.
단계 0 — 브랜드 키트
브랜드당 한 번 브랜드 키트를 구성합니다. 매뉴얼, 웹사이트 또는 의뢰인이 제공한 정보를 기반으로 합니다:
| 항목 | 입력 방식 |
|---|---|
| 팔레트 | HEX와 용도: 배경, 텍스트, 강조, 숫자. 3~4가지 색상; 7가지 색상은 색상이 너무 많고 대비가 부족합니다. |
| 폰트 | 정확한 이름. Google Fonts → <link>; 자체 폰트 → 폴더 내 파일 + @font-face |
| 로고 | 파일 (SVG 또는 투명 PNG). 로고를 처음부터 그리거나 말로 설명하지 마십시오: 파일이 없으면 요청하세요. |
| 움직임 톤 | 2~3가지 형용사 (차분한, 에너제틱, 프리미엄, 대중적인) → 이징과 컷 스타일 결정 |
| 숫자 | 실제 숫자, 소수점 포함, 폰트 적용. 확인되지 않은 숫자 → 요청하거나, 화면에 "예시 데이터" 라고 표시합니다. |
| 오퍼, CTA, @/사이트 | 브리핑 내용 기반. 실제 마감일이 있는 경우에만 긴박감 표현 |
| 배경 음악 | 라이선스된 브랜드 또는 스톡 음악 파일 + BPM과 드롭 시점(초) |
브랜드 폴더에 motion.md로 키트를 저장합니다. 두 번째 작품부터는 키트를 읽어서 재사용하며, 새로 만들지 않습니다.
단계 1 — 분류: 6가지 구성 요소
체크리스트를 한 번에 한 질문씩 출력하고, 이미 채워진 항목은 다시 묻지 않습니다. 브리핑에 답이 없는 구성 요소는 제가 결정하며, 거의 항상 의뢰인의 예상과 다릅니다.
1. 형식 — 비율 + 해상도 + 길이 + fps
2. 씬 — 무엇이, 어떤 순서로, 각각 몇 초 동안 나타나는가
3. 텍스트 — 정확한 문장, 따옴표로 묶음 (고정된 리스트, 그대로)
4. 기법 — 이름으로 지정 (tecnicas.md)
5. 리듬과 사운드 — 이징, 스태거, BPM / 배경 음악
6. 전달 — MP4 · 6초 숏버전 · 검토용 플레이어 · LP용 HTML 루프 · 투명 배경
플랫폼별 형식:
| 비율 | 해상도 | 사용처 | 일반적인 길이 |
|---|---|---|---|
| 9:16 | 1080×1920 | Reels, Stories, TikTok, Shorts | 8~15초, 첫 프레임에 후크 |
| 4:5 | 1080×1350 | IG/FB 피드 | 6~15초 |
| 1:1 | 1080×1080 | 피드, 일부 배치 | 6~15초 |
| 16:9 | 1920×1080 | YouTube, 프레젠테이션, 대형 스크린, 웹사이트 | 5초(로고 애니메이션)부터 긴 설명 영상까지 |
| LP | 페이지 너비 (예: 1440) | 히어로 섹션 등 | 5~10초 가벼운 루프, HTML로 전달 |
30fps가 대부분의 경우를 커버합니다. 60fps는 줌, 빠른 파티클, 카메라 움직임에만 필요합니다. 광고용 작품: 항상 동일한 시그니처가 포함된 6초 버전을 함께 제작하여 테스트합니다.
단계 2 — 타임라인이 포함된 스토리보드 (게이트)
코드를 작성하기 전에 스토리보드를 보여주고 승인을 기다려야 합니다:
형식: 9:16 · 1080×1920 · 15초 · 30fps · 배경 음악 120 BPM (컷 포인트: 3 / 7 / 11초)
키트: 배경 #050505 · 강조 #E50914 · 숫자 #FFDD00 · Morganite / IBM Plex Sans · logo.svg
| 씬 | 시간 | 기법 | 설명 | 텍스트 (그대로) | 등장/퇴장 |
스토리보드 규칙:
- 씬당 하나의 아이디어. 씬에 두 문장이 필요하면 두 개의 씬입니다.
- 씬당 2~4초. 2초 미만이면 텍스트를 읽을 시간이 부족합니다.
- 읽는 시간: 단어 3개당 1초 + 1초 여유. 숫자 단독: 1.5초 · 3단어: 2초 · 6단어: 3초 · 9단어: 4초. 4초 이상 필요한 문장은 한 씬에 너무 깁니다: 분할하거나 단어를 줄입니다 (승인된 카피의 단어를 줄이는 것은 승인자의 결정입니다).
- 등장과 퇴장 방식을 말하세요. 퇴장은 다음 씬으로 연결됩니다.
- 9:16과 4:5에서는 처음 3초에 후크를 만듭니다. 주요 메시지를 마지막까지 미루지 마십시오.
- 비트에 맞춰 컷: 비트 = 60 ÷ BPM 초; 마디 = 4비트. 씬 길이가 마디의 배수이면 정확히 맞아떨어집니다 (120 BPM: 비트 0.5초, 마디 2초 · 128: 0.47 / 1.88 · 100: 0.6 / 2.4 · 90: 0.67 / 2.67).
단계 3 — 구현
assets/template.html을 작업 폴더로 복사하고 CFG, BRAND, SCENES를 채웁니다. 코드의 법칙입니다. MP4가 플레이어에서 승인된 내용과 동일하게 나오는 것은 이 법칙에 달려 있습니다:
- 모든 것은
t의 함수입니다.setTimeout,Date.now(), CSS transition/animation 또는 프레임 간 누적 상태를 사용하지 마십시오. 1.4초 시점의 글자 3은 항상 같은 위치에 있습니다. - 고정 시드 (
rng(CFG.SEED + i))를 모든 난수에 사용합니다. 시드가 없으면 내보낸 결과가 승인된 것과 다릅니다. - 시뮬레이션 (물리, 보이드, 천):
t에 대한 분석 공식, 또는 로딩 시 고정 스텝(1/240초)으로 미리 계산하여 프레임별로 저장하고 인덱스로 읽습니다.draw내부에서 절대 적분하지 마십시오. - 폰트는
CFG.FONTS에, 에셋은CFG.ASSETS에 정의합니다. 엔진은 첫 프레임 전에 로딩을 기다립니다. 로딩되지 않은 폰트는 경고 없이 기본 폰트로 대체되며, 이것이 가장 흔한 오류입니다. - 9:16 안전 영역: 텍스트, 숫자, 로고는 상단 250px, 하단 350px, 오른쪽 120px, 왼쪽 60px 이내에 위치해야 합니다 (근사치이며 앱에 따라 다릅니다).
- 의도적인 이징:
inOut이 기본값입니다.back(오버슈트)은 텍스트, 핀, 숫자의 등장에 사용합니다.linear는 연속 회전 및 스크롤에만 사용합니다.bounce는 떨어지는 물체에만 사용합니다. 글자 간 스태거 0.07초, 카드 간 0.15초. - 계층 구조: 주요 숫자는 씬에서 가장 큰 요소여야 합니다.
- 각 씬 상단에 시간과 기법을 주석으로 남깁니다.
긴 작품 또는 무거운 기법(셰이더, 시뮬레이션)을 사용하는 경우: 한 번에 한 씬씩 구현, 검토, 승인을 받은 후 병합합니다. 짧은 작품(약 ~15초, 가벼운 씬 4개)은 한 번에 만들 수 있지만, 검토는 여전히 씬별로 진행합니다.
단계 4 — 공개 전 검토
python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe
각 씬의 중간과 끝 프레임을 안전 영역이 표시된 시트로 생성합니다. VER → AMPLIFY → CONFIRM 방법(작은 텍스트, 숫자, 로고의 확대된 부분 확인)으로 시트를 읽고 6개 레이어를 확인합니다:
| 레이어 | 확인 사항 |
|---|---|
| 1. 기법 | 요청된 길이, 해상도, fps와 일치; 시작 또는 끝에 검은 프레임 없음 |
| 2. 브랜드 | 올바른 HEX 색상; 브랜드 폰트가 로드되어 일반 폰트가 아님; 로고 왜곡, 회전, 색상 변경 없음; 움직임 톤이 브랜드와 일치 |
| 3. 가독성 | 씬당 하나의 아이디어; 각 텍스트가 규칙에 맞는 시간 동안 표시됨; 텍스트와 배경의 대비; 주요 숫자가 가장 큰 요소 |
| 4. 플랫폼 | 올바른 비율; 안전 영역 밖으로 나간 요소 없음; 처음 3초에 후크; 소리 없이도 이해 가능 |
| 5. 데이터 | 제공된 숫자와 정확히 일치하며 반올림 없음; 소수점과 폰트; 예시 데이터는 화면에 표시; 가상의 숫자 없음 |
| 6. 권리 | 라이선스된 브랜드 또는 생성된 배경 음악; 사진과 화면 사용 허가; 타사 브랜드는 허가 필요; 오퍼 약속 검증 완료 |
특정 순간을 확인하려면: --sheet 1.5,2.9,3.1. 문제를 발견하면 묻지 않고 수정한 후 공개합니다.
자료의 3차 검토는 승인자가 휴대폰에서 소리 없이 시청하는 것입니다. 저는 프레임을 확인하고, 실행 중인 비디오의 느낌을 확인하지 않습니다. 전달 시 이 검토를 명시적으로 요청하십시오.
단계 5 — 렌더링 및 전달
python ~/.claude/skills/motion/scripts/render.py peca.html # 전체 MP4
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4 # 숏버전
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3 # 배경 음악 포함
렌더링 후: ffprobe로 해상도, fps, 프레임 수, 길이를 확인합니다. 전달:
- MP4 (H.264, yuv420p, +faststart), 바로 업로드 가능;
- 6초 버전, 광고용인 경우;
- 플레이어가 있는 HTML (브라우저에서 열어 재생, 일시 정지, 타임바, 씬 이름, 안전 영역 확인 가능). 승인자가 정확한 초를 지정하여 수정을 요청하는 데 사용합니다.
LP: 전달은 루프 형태의 HTML 자체이며, MP4가 아닙니다. 가벼움이 최우선: 페이지 속도에 영향을 주면 안 됩니다.
배경 음악: 스킬은 파일(--audio)을 믹스하고 컷을 BPM에 맞춥니다. 코드로 생성된 배경 음악은 구현되지 않았습니다. 요청 시 즉석에서 처리하지 말고 이 사실을 알리십시오. 라이선스 없는 타사 음악은 광고가 중단될 수 있습니다: 절대 사용하지 마십시오.
단계 6 — 수정
첫 번째 버전은 초안입니다. 좋은 수정 요청은 씬 또는 초를 지정하고, 얼마나 수정할지 말하며, 무엇을 유지할지 명시합니다: "씬 1 (0~3초)에서 +248%를 1.5초 동안 고정시킨 후 변경하세요. 나머지는 건드리지 마세요." 저는 영향을 받은 부분만 수정하고 다시 렌더링합니다.
| 증상 | 가능한 원인 | 수정 방법 |
|---|---|---|
| 로봇 같은 움직임 | 선형 이징 | inOut, 등장 시 back 사용 |
| 모든 것이 동시에 나타남 | 스태거 없음 | 글자 간 0.07초, 카드 간 0.15초 |
| 브랜드 폰트와 다름 | 폰트가 로드되지 않음 | CFG.FONTS / @font-face 및 폴더 내 파일 확인 |
| 9:16에서 텍스트 잘림 | 16:9 기준 레이아웃 | 1080×1920 그리드에서 안전 영역을 고려하여 재작업 |
| 플레이어 끊김 | 너무 많은 파티클 또는 셰이더 | 플레이어에서는 요소 줄이고, 렌더 시에만 전체 적용 |
| 내보낸 결과와 플레이어 다름 | 시드 없는 난수 또는 누적 상태 | 단계 3의 법칙 1~3 적용 |
| 비트에 맞지 않는 컷 | 씬과 BPM의 관계 없음 | 비트 배수에 맞춘 길이 사용 |
| 잘못된 숫자 | 데이터 미제공 | 제공된 목록을 정확히 사용, 반올림 금지 |
게시 후: 유지율 하락이 처음 3초에서 발생하면 씬 1만 교체; 중간 씬에서 발생하면 해당 씬만 단축 또는 교체; 클릭이 발생하지 않으면 다른 엔딩(컨페티, 회전하는 봉인, QR)을 테스트하되 나머지는 동일하게 유지합니다. 한 번에 하나의 변수만 변경합니다.
계정 라이브러리
승인된 작품 → 브랜드의 motion.md에 다음 정보를 기록합니다: 승인된 스토리보드, 사용된 기법, HTML 경로, 그리고 가능하다면 첫 7일 동안의 성과 지표. 다음 작품은 이미 성과를 낸 내용에서 시작하며, 브랜드의 표준 엔딩(로고 + CTA가 있는 최종 시그니처)을 재사용하고 새로 만들지 않습니다.