Communitygithub.com

모션 그래픽 스킬

HTML을 기반으로 프레임 정확도가 높고 재현 가능한 코드 기반 모션 그래픽 비디오를 제작합니다. 실제 앱 캡처로 만든 제품 론칭/기능 발표 영상과 YouTube 쇼츠, 릴스, 틱톡용 세로형 숏폼을 지원합니다.

모션 그래픽 스킬란 무엇인가요?

이 스킬은 하나의 HTML 페이지를 시간 `t`에 대한 순수 함수로 간주하여, 헤드리스 Chromium에서 프레임별로 렌더링하고 ffmpeg으로 인코딩하는 모션 그래픽 비디오 제작 도구입니다. 사용자가 론칭 비디오, 프로모션, 앱 트레일러, 쇼츠 등 모션 그래픽 비디오를 요청할 때 사용됩니다. 제품 론칭/기능 발표 영상 (Apple/Google 키노트 스타일, SaaS 론칭)과 YouTube 쇼츠, 릴스, 틱톡용 세로형 숏폼을 지원합니다. 각 비디오는 고유한 아이디어, 스크립트, 디자인으로 제작되며, 프레임 0부터 이미 움직임이 시작되고 0.8~2초마다 의미 있는 변화가 일어납니다. `engine/` 디렉토리를 복사하고 npm 설치와 Playwright 브라우저 설치로 환경을 설정한 후, `motion.html`에 장면을 등록하고 `MG.ready()`를 호출하여 작동합니다. 렌더링은 `node engine/render.mjs` 명령어로 수행하며, 스틸 이미지로 레이아웃을 검증한 후 최종 동영상을 생성합니다. 오디오는 라이선스를 준수하는 음악과 효과음을 사용하며, 최종 출력은 약 -14 LUFS 통합 음량과 -1 dBFS 이하의 최대 진폭을 목표로 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

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

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

문서

모션 그래픽

비디오는 모든 픽셀이 시간 t의 순수 함수인 하나의 HTML 페이지이며, 헤드리스 Chromium에서 프레임별로 렌더링되고 ffmpeg으로 인코딩됩니다. 기준은 시니어 모션 디자이너의 쇼릴(showreel)이며, 절대 슬라이드쇼가 아닙니다.

1. 포맷 선택

요청읽기
실제 제품에 대한 론칭, 프로모션, 광고, 기능 릴, 앱 트레일러formats/launch-video.md
쇼츠, 릴스, 틱톡, 세로형 설명 영상 또는 스토리formats/shorts.md

포맷 파일을 따라 브리프, 콘텐츠 단계, 비트 구조를 확인하세요. 작성 후에는 다시 이곳으로 돌아와 빌드합니다. 또한 컴포지션을 작성하기 전에 references/pitfalls.md를 읽으세요.

매 실행마다 새로운 콘셉트. 각 비디오는 고유한 아이디어, 스크립트, 디자인을 가집니다. 사용자가 이전 작업을 참고하지 말라고 하면, 이전 비디오와 컴포지션은 워크스페이스에서 열지 않은 상태로 두세요.

2. 작업 폴더

사용자가 원하는 위치에 <slug>-<YYYYMMDD>/ 폴더를 만듭니다 (기본값: 현재 디렉토리):

brief.md          포맷의 브리프 테이블에서 가져온 매개변수
beats.md          비트 시트 (시간, 카피, 에셋, 움직임, 전환, 악센트 히트)
assets/           캡처, 이미지, 폰트, 오디오
assets/manifest.md  에셋 파일당 한 줄: 출처, 라이선스 또는 "<표면>에서 캡처", 표시 내용
motion.html       컴포지션
motion.json       {"size": [W, H], "fps": 60, "duration": 30, "stills": [비트 시간], "captions": []}
engine/           이 스킬의 engine/ 디렉토리 복사
out/              스틸, 렌더, 콘택트 시트

폴더당 한 번씩 엔진을 설정합니다:

cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. 컴포즈

motion.html은 engine/runtime.css와 engine/runtime.js를 로드하고, DOM을 구성하며, 장면을 등록한 후 MG.ready()를 호출합니다.

헬퍼용도
MG.scene(start, end, fn, el)fn(local, t, dur)는 start <= t < end 동안 실행됨; el은 범위 밖에서 숨겨짐. 모든 애니메이션 속성을 매 호출마다 설정.
MG.always(fn)매 프레임 실행: 배경, 그레인, 진행 바.
MG.prog(t, a, b, ease)이징된 0..1 진행. 이징: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) 또는 모든 함수.
MG.tween(t, [[t0, v0], [t1, v1, ease], …])키프레임; 값은 배열일 수 있음.
MG.spring(t, {stiffness, damping})오버슈트가 있는 물리적 0 → 1.
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})요소당 매 프레임 한 번 호출.
MG.clip(videoEl, start, rate)화면 녹화를 start부터 프레임 정확도로 재생.
MG.rng(seed), MG.noise(x, seed)결정론적 난수와 흔들림.
MG.fmt(n, {decimals})카운터용 로케일 숫자 포맷.
MG.captions()motion.json의 캡션을 하단 UI 블록 위에 그림.

결정론: 렌더 로직에 Date, performance.now(), requestAnimationFrame, 또는 Math.random 없음. CSS @keyframes는 허용됨; 런타임이 t에서 일시 중지하므로 animation-delay로 타이밍을 조정함. 매니페스트에 나열된 폰트와 이미지만 사용.

프레임 미리보기: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (가이드가 안전 영역 표시). 실시간: ?play=1. 캡션은 렌더링에서만 표시됨.

4. 제작 기준

  • 프레임 0은 이미 움직이고 있음. 검은 화면에서 페이드 인, 로고 인트로 없음.
  • 0.8–2초마다 의미 있는 변화 발생: 레이아웃, 스케일, 색상, 숫자, 또는 카메라.
  • 진입은 스프링 또는 ease-out-expo로 약간의 오버슈트와 함께; 30–60 ms 지연; 선형은 티커에만 사용.
  • 빠른 움직임 중에만 모션 블러; 정적인 샷에서는 느린 푸시 (스케일 1 → 1.04); 2–3개 깊이 레이어 간 패럴랙스.
  • 하나의 배경 패밀리, 하나의 텍스트 색상, 하나의 악센트. 업로드 후 평면 채우기가 밴딩되지 않도록 그레인 또는 그래디언트 노이즈 추가.
  • 카피는 화면에 두 번 읽을 수 있을 만큼 오래 표시됨; 주요 텍스트는 안전 영역 내에 유지.
  • 비트는 사운드와 일치: 각 변화에서 우슈, 히트, 또는 음악 비트.

5. 렌더

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

먼저 스틸 이미지로 레이아웃을 확인: 비트당 하나, 모든 트윈 내부에 하나, 모든 스프링의 오버슈트 피크에 하나. 한 번에 전체 렌더 한 개 실행 (4개 워커로 1080p60에서 25초 기준 약 10분).

6. 오디오

매니페스트에 나열된 라이선스가 허용하는 음악과 SFX만 사용하거나, 사용자가 제공한 파일 사용. 없으면 무음으로 전달하고 그렇게 명시. 큐를 믹스한 후 먹싱:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

목표 약 −14 LUFS 통합 음량, 최대 진폭 −1 dBFS 이하. SFX는 약 −6 ~ −14 dB, 음악은 −14 ~ −18 dB. 화면 텍스트 아래의 음악은 악기 전용.

7. QA

  1. ffprobe로 지속 시간, 크기, fps가 브리프와 일치하는지 확인.
  2. 콘택트 시트: ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. 각 비트 변화 시점의 전체 크기 프레임도 확인 (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png).
  3. 모든 프레임: 가장자리에서 잘린 부분 없음, 빈 프레임이나 반쯤 페이드된 프레임 없음, 가이드 잔여물 없음, 오타나 플레이스홀더 텍스트 없음, 2초 이상 정적인 부분 없음.
  4. 포맷 파일 자체의 검사 항목.

모든 검사가 통과할 때까지 수정 및 재렌더링. 새로운 교훈은 스킬의 references/pitfalls.md에 날짜 · 비디오 · 교훈 형식으로 추가.

전달

최종 MP4 경로, 길이, 크기, fps, 표시 내용, 필요한 크레딧을 포함한 오디오 상태, 재렌더 명령어를 보고. 작업 폴더 유지. 사용자가 요청할 때만 업로드 또는 게시.

관련 스킬