Communitygithub.com

motion

모션 그래픽을 코드로 제작하여 MP4로 바로 내보냅니다 — 9:16 릴, 16:9 비디오, 짧은 광고, 로고 애니메이션, 랜딩 페이지 애니메이션. 단일 시계 방식의 HTML/Canvas 애니메이션을 작성하고, Playwright와 ffmpeg로 프레임 단위 렌더링하여 검토 시트와 함께 전달합니다.

motion란 무엇인가요?

이 스킬은 개발자가 모션 그래픽을 순수 코드로 작성하고, 정확한 결과물(MP4, HTML 플레이어)을 산출하도록 돕는 전문 기술입니다. HTML/Canvas 기반 템플릿에서 단일 시계 변수 `t`에 의존하여 애니메이션을 정의하고, Python 스크립트로 Playwright 브라우저를 통해 프레임별로 캡처한 뒤 ffmpeg로 MP4를 생성합니다. 브랜드 키트(팔레트, 폰트, 로고, 톤)를 한 번 설정하면 이후 작업에서 재사용하며, 39가지 기술(técnicas)을 조합하여 다양한 효과를 낼 수 있습니다. 검토 과정에서는 각 씬의 중간/끝 프레임을 이미지 시트로 출력하여 정확성을 확인하고, 6초 숏버전 렌더링, 오디오 믹싱, LP용 HTML 루프 등 다양한 배포 옵션을 지원합니다. 이 스킬은 실제 촬영, 사진, AI 이미지 생성에는 사용되지 않으며, 주어진 브랜드 자산을 정확히 애니메이션화하는 데 특화되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/motion

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

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

문서

코드로 만드는 모션 그래픽

비디오는 코드에서 탄생합니다. 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:161080×1920Reels, Stories, TikTok, Shorts8~15초, 첫 프레임에 후크
4:51080×1350IG/FB 피드6~15초
1:11080×1080피드, 일부 배치6~15초
16:91920×1080YouTube, 프레젠테이션, 대형 스크린, 웹사이트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가 플레이어에서 승인된 내용과 동일하게 나오는 것은 이 법칙에 달려 있습니다:

  1. 모든 것은 t의 함수입니다. setTimeout, Date.now(), CSS transition/animation 또는 프레임 간 누적 상태를 사용하지 마십시오. 1.4초 시점의 글자 3은 항상 같은 위치에 있습니다.
  2. 고정 시드 (rng(CFG.SEED + i))를 모든 난수에 사용합니다. 시드가 없으면 내보낸 결과가 승인된 것과 다릅니다.
  3. 시뮬레이션 (물리, 보이드, 천): t에 대한 분석 공식, 또는 로딩 시 고정 스텝(1/240초)으로 미리 계산하여 프레임별로 저장하고 인덱스로 읽습니다. draw 내부에서 절대 적분하지 마십시오.
  4. 폰트는 CFG.FONTS 에, 에셋은 CFG.ASSETS에 정의합니다. 엔진은 첫 프레임 전에 로딩을 기다립니다. 로딩되지 않은 폰트는 경고 없이 기본 폰트로 대체되며, 이것이 가장 흔한 오류입니다.
  5. 9:16 안전 영역: 텍스트, 숫자, 로고는 상단 250px, 하단 350px, 오른쪽 120px, 왼쪽 60px 이내에 위치해야 합니다 (근사치이며 앱에 따라 다릅니다).
  6. 의도적인 이징: inOut이 기본값입니다. back(오버슈트)은 텍스트, 핀, 숫자의 등장에 사용합니다. linear는 연속 회전 및 스크롤에만 사용합니다. bounce는 떨어지는 물체에만 사용합니다. 글자 간 스태거 0.07초, 카드 간 0.15초.
  7. 계층 구조: 주요 숫자는 씬에서 가장 큰 요소여야 합니다.
  8. 각 씬 상단에 시간과 기법을 주석으로 남깁니다.

긴 작품 또는 무거운 기법(셰이더, 시뮬레이션)을 사용하는 경우: 한 번에 한 씬씩 구현, 검토, 승인을 받은 후 병합합니다. 짧은 작품(약 ~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가 있는 최종 시그니처)을 재사용하고 새로 만들지 않습니다.

Individual skills in this repo

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

관련 스킬