Communitygithub.com

oleg-motion

정적인 이미지를 반복 배너, 애니메이션 광고, 스토리, 시네마그래프 스타일 클립(MP4/WebM/GIF)으로 변환합니다.

oleg-motion란 무엇인가요?

oleg-motion은 정적 이미지(단일 JPG/PNG, 레이어드 PSD, 또는 PNG 레이어 폴더)를 입력받아 HTML 씬을 헤드리스 Chrome에서 프레임별로 렌더링하고 ffmpeg로 인코딩하여 애니메이션 클립을 생성하는 전문 기술입니다. 모든 모션은 시간의 순수 함수이므로 루프가 정확하게 닫히고 렌더링이 재현 가능합니다. 배경/피사체/텍스트 레이어를 자동 분할(ML 기반 또는 수동), 패럴랙스/2.5D 카메라 움직임, 파티클(눈, 나뭇잎, 먼지, 종이 조각, 보케), 라이트(샤인 스윕, 별 반짝임, 플레어, 글로우), 텍스트/제품 모션을 지원하며, 가격표, 로고, 법적 텍스트는 선명하게 유지합니다. Claude Code, Cursor 등 AI 에이전트 환경에서 실행 가능하며, 사용자가 "애니메이션", "움직임 추가", "배너 만들기" 같은 요청을 하거나 참고 영상을 보여줄 때 자동으로 활성화되도록 설계되었습니다.

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

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

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

문서

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

정적 이미지에서 결정론적 모션 디자인: HTML 씬을 헤드리스 Chrome에서 프레임별로 렌더링하고 ffmpeg로 인코딩합니다. 모든 것은 시간의 순수 함수이므로 루프가 정확하게 닫히고 렌더링이 재현 가능합니다. 사용자와 사용자의 언어로 대화하고, 파일 이름과 씬 JSON은 영어로 유지합니다.

$OM은 아래에서 이 스킬의 디렉토리(이 SKILL.md가 포함된 폴더)를 의미합니다.

0. 실행 확인 (머신당 한 번)

모든 것은 런처 $OM/om을 통해 실행합니다. 이 런처는 스킬 자체의 Node, ffmpeg 및 Python을 PATH의 맨 앞에 두므로 개발자 도구가 없는 깨끗한 Mac에서도 작동합니다.

$OM/om doctor              # 설치 상태 확인
bash $OM/scripts/setup.sh  # 핵심: Node.js, ffmpeg, 렌더링 엔진 (누락된 항목 다운로드)
$OM/om setup --psd         # + PSD 가져오기
$OM/om setup --ml          # + 평면 이미지 자동 레이어 (~1 GB, 모델 포함)
$OM/om update              # GitHub에서 최신 버전 (git 없이 작동), 그 다음 setup 다시 실행

설치에는 관리자 비밀번호, Homebrew 또는 git이 필요하지 않습니다. 누락된 도구는 ~/.cache/oleg-motion/tools에 다운로드됩니다(OLEG_MOTION_HOME으로 폴더 재정의 가능); 이미 머신에 있는 도구는 충분히 괜찮을 때 사용됩니다. 핵심만으로도 모든 이미지를 애니메이션화(카메라, 파티클, 라이트, 오버레이)할 수 있습니다. --ml을 실행하기 전에는 먼저 물어보세요. 모델을 다운로드합니다. om이 실행 가능하지 않은 경우(zip에서 압축 해제된 경우) bash $OM/om …을 호출하세요.

1. 브리핑 — 먼저 살펴보고, 클릭 가능한 옵션으로 질문하기

사용자가 파일을 던지며 "움직이게 해줘"라고 말합니다. 대부분의 사람들은 움직임을 말로 설명할 수 없으므로 개방형 질문을 하지 말고 — 먼저 직접 이미지를 살펴보고(열어서), 요소(헤드라인, 가격, 버튼, 로고, 사진, 제품, 화살표…)를 나열한 다음 질문합니다.

브랜드 키트 먼저. 요청에 브랜드/프로젝트 이름이 언급되거나, *.brand.json / oleg-motion.brand.json이 작업 폴더에 있거나, $OM/brands/에 일치하는 키트가 있으면 로드하여 scene에 --brand로 전달합니다. 해당 기본값이 대부분의 질문에 답하고(따라서 건너뜁니다), protect / avoid / notes는 엄격한 규칙입니다. 형식: references/brand-kit.md. 키트가 없으면 → 전달(6단계) 시 저장 제안.

절대 장인정신에 대해 묻지 마세요 — 타이밍, 이징, 진폭, 지연, 파티클 수는 전문가 기본값(references/motion-guidelines.md)입니다. 사용자가 요청할 때만 변경합니다. 모든 질문은 기본값을 제공하며 사용자는 그냥 수락할 수 있습니다.

질문을 건너뛰세요 사용자가 "просто зроби" / "just do it" / "on your own"이라고 말하거나, 요청에 이미 답변이 포함된 경우: 기본값을 선택하고 한 줄로 설명합니다.

그렇지 않으면 한 번만 옵션과 함께 질문하세요 — 가능할 때 AskUserQuestion 도구 사용(클릭 가능한 카드; 그렇지 않으면 번호가 매겨진 옵션이 있는 하나의 메시지). 최대 4개의 질문, 각각 이미지에서 본 내용을 바탕으로 먼저 추천 옵션을 제시합니다.

  1. 어디에 사용될까요? → 프로필: "як є — не змінювати пропорції" (source: 원본 가로세로비, 긴 쪽 최대 1920px), Instagram 포스트 4:5 (feed-portrait), Stories/Reels 9:16 (story), 웹사이트 배너 (web-hero / web-strip), 디스플레이 광고 GIF (display-*). 이미지에 맞게 4가지 옵션을 조정: 비율이 이미 형식과 일치하면(예: 4:5 → Instagram 포스트), 별도의 "як є" 대신 해당 형식을 제공(동일한 결과)하고 추천; 그렇지 않으면 "як є"를 먼저 추천. 다른 비율의 형식은 이미지를 자르거나(fit: cover) 흐린 여백을 추가합니다(contain-blur) — 어떤 방식인지, 무엇이 잘리는지(헤드라인 가장자리, CTA) 말해서 사용자가 놀라지 않도록 합니다.
  2. 캐릭터(분위기)? → 이미지에 맞는 3-4가지 무드. 이름 대신 느낌으로 설명: "차분하고 프리미엄", "에너제틱", "페스티벌", "거의 움직이지 않음". 설명에 일치하는 무드를 언급합니다(premium, energetic, festive, calm …; 전체 목록: $OM/om moods).
  3. 구조? → "요소가 나타난 후 루프" (intro-loop, 소셜 포스트에 적합), "씨름리스 루프만" (loop, 사이트 배너에 적합), "엔딩이 있는 한 번 통과" (oneshot).
  4. 히어로는 무엇인가요? (다중 선택) → 찾은 가장 눈에 띄는 3-4가지 요소(예: "헤드라인 SUMMER SALE", "CTA 버튼", "사진", "제품"). 히어로가 주요 움직임을 얻고, 다른 모든 것은 차분하게 유지됩니다.

답변이 없을 경우 기본값: 가로세로비에서 프로필, 6초(intro-loop의 경우 intro 2초 + loop 4초), MP4, 팔레트와 주제에서 선택한 무드. 참조 비디오("이것처럼")는 어떤 답변보다 우선합니다— references/reference-analysis.md로 분석하고 내용이 아니라 리듬을 복사합니다.

2. 모션 계획 — 렌더링 전에 말로 합의

첫 번째 렌더링 전에, 계획을 평범한 언어(사용자 언어)로, 요소당 한 줄씩, 타이밍과 함께 보여줍니다. 예:

인트로 (2초): 로고 나타남 → 헤드라인 줄단위로 올라감 → "-30%" 튀어나옴 → 버튼과 제품 아래에서 나타남. 루프 (4초): "-30%" 은은하게 빛나고, 위로 샤인 스윕 · 버튼 맥동 · 제품 은은하게 떠다님 · 배경에 따뜻한 먼지. 움직이지 않음: 로고(약간의 반짝임만), 가격(나타난 후), 날짜.

같은 메시지에 "이렇게 할까요, 아니면 뭔가 바꿀까요?"라고 묻고, 예스(또는 사용자가 질문을 건너뛴 경우 — 바로 렌더링하고 결과와 함께 계획을 보여줌) 후에만 진행합니다. 계획을 바꾸는 데는 몇 초가 걸리지만, 렌더링 결과를 바꾸는 데는 몇 분이 걸립니다. 계획은 또한 다음 단계에서 어떤 요소가 자체 레이어가 필요한지 결정합니다.

3. 레이어 가져오기

입력에 따라 선택 — 목표는 역할이 있는 layers.json입니다(참조: references/scene-format.md).

입력명령어
평면 JPG/PNG, ML 설치됨$OM/om py $OM/scripts/ml/auto_layers.py in.jpg --out work/layers
PSD$OM/om py $OM/scripts/psd_layers.py in.psd --out work/layers
PNG 레이어 폴더$OM/om layers-from-dir path/to/pngs
디자인된 크리에이티브(카드, 버튼, 화살표, 머리가 프레임 밖으로 나온 사진) 또는 auto-layers가 잘못됨regions.json 작성(박스/폴리곤 + 마스크 모드) → $OM/om py $OM/scripts/ml/cut_regions.py regions.json --out work/layers (스크립트의 독스트링에 형식 있음)
평면 이미지, ML 없음수동으로 layers.json 작성: 하나의 background 레이어(파티클이 텍스트를 피해야 하는 경우 텍스트 상자 요청)

regions.json의 경우, 좌표를 눈대중이 아니라 측정하여 찾습니다: 밝은/어두운 픽셀의 임계값을 정하고 구성 요소의 경계 상자를 출력합니다. 사진 카드의 경우 프레임 색상을 스캔하고 가장자리를 맞춥니다(실제 가장자리 안쪽 3-5px의 폴리곤은 배경에 밝은 선을 남기고 카드를 자릅니다). mask: "contrast"는 평범한 배경의 텍스트/로고/라인에 사용, "full" + popout은 머리가 튀어나온 사진 카드에 사용, "seg"는 복잡한 사진의 객체에 사용합니다.

항상 preview.png / 레이어 PNG를 열고 분할을 확인한 후 씬을 빌드하세요: auto-layers는 잘못 라벨링할 수 있습니다(로고를 텍스트로, 가격을 헤드라인으로, 실제로 배경인 주제를 피사체로). layers.json에서 역할을 수정하세요 — 역할은 무엇이 움직일 수 있는지 결정합니다. 피사체 컷아웃이 좋지 않으면, 들쭉날쭉한 가장자리를 애니메이션화하는 대신 해당 레이어를 버리세요.

4. 씬 빌드

$OM/om scene --layers work/layers/layers.json --mood energetic \
     --profile feed-portrait --structure intro-loop [--brand brand.json] \
     [--intensity 1] [--speed 1] [--density 1] --out work/scene.json

이것은 무드 번들(및 브랜드 키트)에서 scene.json을 초안합니다. 그런 다음 합의된 계획과 일치하도록 편집합니다. 이것이 바로 장인정신이 필요한 부분입니다: 레이어별 인트로 타이밍은 50-100ms 간격으로 지연(전체 캐스케이드 ≤ 2초, 등장 400-800ms, ease-out; 바운스는 하나의 장난기 있는 요소에만), 히어로의 라이트/글로우, 장식 모션(화살표 바운스, 배지 회전), 이미지나 브랜드 키트의 하나의 액센트 색상의 파티클. 모든 효과와 해당 매개변수에 대해서는 references/effects.md를, 전문성을 유지하는 한계에 대해서는 references/motion-guidelines.md를 읽으세요.

5. 렌더링, 확인, 반복

$OM/om render work/scene.json --out work/out --quality draft     # 빠른 확인
$OM/om render work/scene.json --out work/out --formats mp4,webm,gif  # 최종

렌더링할 때마다 *-sheet.jpg(8프레임)를 보고, 의심스러운 부분이 있으면 단일 프레임을 추출하여(ffmpeg -ss 2.5 -i out.mp4 -frames:v 1 f.png) 확인합니다. 보고서(*-report.json, stderr에 요약됨)는 다음을 확인합니다: 루프 이음새, 플래시(≤3/s), 잠긴 레이어 움직임 없음, 안전 영역(텍스트/가격/CTA 가장자리에서 ≥ 10%, 로고 ≥ 5%; cut = 형식 변경으로 잘림, as-designed = 소스가 이미 그렇게 빡빡했음), 파일 예산.

결함을 수정한 후에 전달하세요 — 보이는 이음새는 일반적으로 정수가 아닌 cycles 때문입니다. 예산 초과는 파티클/그레인을 줄이거나 GIF 크기/fps를 낮추면 됩니다.

드래프트(연락처 시트 또는 MP4)를 사용자에게 보여주고 사용자 자신의 말로 조정을 요청하세요 — "повільніше", "менше блиску", "без частинок", "кнопку яскравіше", "прибери інтро". references/tweaks.md는 이러한 구문을 씬 편집에 매핑합니다. 적용하고 드래프트로 다시 렌더링한 다음, 사용자가 만족할 때만 최종 렌더링합니다.

노트북(M1, 8GB)에서 비용: auto-layers ≈ 이미지당 3-4분(한 번 실행한 다음 씬에서 반복); 렌더링 ≈ 프레임당 0.2-0.4초(6초 30fps ≈ 1분). 긴 단계 전에 사용자에게 알립니다.

6. 전달

사용자에게 제공: 파일(경로 + 크기), 포스터 JPG, 무엇이 움직이는지 한 문장, 그리고 웹사이트의 경우 임베드 힌트 <video autoplay muted loop playsinline poster="…">. 대상 플랫폼에 엄격한 제한(정확한 크기, 코덱, 최대 MB)이 있는 경우 충족되었는지(또는 충족되지 않았는지) 알립니다. 브랜드 작업이고 키트가 아직 없는 경우, 한 줄로 저장(references/brand-kit.md)을 제안하여 다음 번에 질문이 이미 답변되었도록 합니다.

품질을 유지하는 규칙 (그리고 그 이유)

  • 하나의 히어로 모션, 최대 두 개의 앰비언트 모션. 시청자는 한 번에 한 가지만 읽습니다. 추가 모션은 메시지와 경쟁합니다.
  • 가격, 법적 텍스트 및 로고는 고정 유지. 움직임은 글자 형태를 흐리게 하고 흔들리게 합니다 — 가독성과 브랜드 신뢰가 화려함보다 우선합니다. 역할이 이를 강제합니다. 가격에 text를 재할당하여 움직임을 주지 마세요.
  • 사람의 움직임을 가장하지 마세요. 컷아웃된 사람은 달리거나 손을 흔들 수 없습니다. 전체 모습을 위아래로 흔들거나 맥동시키면 골판지 인형처럼 보입니다. 사람에게 깊이(카메라 시차)와 인트로만 제공하고 그 이상은 하지 마세요.
  • 작은 진폭. 카메라 푸시 3-6%, 기울기 2-4°, ≤ 2% 호흡. 큰 줌과 시차는 멀미를 유발하고 아마추어처럼 보입니다.
  • 전체 사이클만. 루프가 완벽하게 연결되는 이유는 모든 모션이 루프당 정수 사이클을 완료하기 때문입니다. 절대 분수 cycles를 설정하지 마세요.
  • 첫 번째 프레임 = 완성된 포스터. loop에서 첫 번째 프레임에는 이미 모든 것이 제자리에 있습니다. 인트로가 필요할 때 intro-loop을 사용하세요.
  • 텍스트의 생성적 재드로잉 없음. 이 스킬은 텍스트나 제품을 다시 칠하지 않습니다. AI 비디오(선택 사항, references/ai-video.md 참조)는 배경에만 사용되며, 원본 레이어가 위에 다시 합성됩니다.

문제 해결

  • Playwright is not installed, Node.js is missing, ffmpeg 오류 → bash $OM/scripts/setup.sh.
  • 빈 프레임 또는 검은 프레임 → 레이어 경로가 잘못됨(stderr 경고 확인) 또는 씬에 배경 레이어가 없음.
  • 텍스트 감지 건너뜀 → ocrmac은 macOS 전용입니다. 다른 곳에서는 수동으로 텍스트 레이어를 전달하세요.
  • 시차에서 가장자리 후광 → depthParallax.amp를 낮추거나 플레이트를 인페인트합니다(auto-layers는 --no-inpaint가 없으면 이 작업을 수행합니다).
  • GIF가 너무 큼 → display-* 프로필이 자동으로 크기를 줄입니다. 그렇지 않으면 fps/너비를 낮추세요.

관련 스킬