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개의 질문, 각각 이미지에서 본 내용을 바탕으로 먼저 추천 옵션을 제시합니다.
- 어디에 사용될까요? → 프로필: "як є — не змінювати пропорції" (
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) 말해서 사용자가 놀라지 않도록 합니다. - 캐릭터(분위기)? → 이미지에 맞는 3-4가지 무드. 이름 대신 느낌으로 설명: "차분하고 프리미엄", "에너제틱", "페스티벌", "거의 움직이지 않음". 설명에 일치하는 무드를 언급합니다(
premium,energetic,festive,calm…; 전체 목록:$OM/om moods). - 구조? → "요소가 나타난 후 루프" (
intro-loop, 소셜 포스트에 적합), "씨름리스 루프만" (loop, 사이트 배너에 적합), "엔딩이 있는 한 번 통과" (oneshot). - 히어로는 무엇인가요? (다중 선택) → 찾은 가장 눈에 띄는 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/너비를 낮추세요.