Communitygithub.com

Motion V2

프레임워크: 부동산, 건축, 외식, 호텔, 건강·미용, 물리적 제품, 자동차, 인테리어, 서비스 등 이미지로 판매하는 모든 브랜드를 위한 리얼리스틱 미디어 기반의 시네마틱 런칭 영상 및 광고(세로 9:16, Remotion).

Motion V2란 무엇인가요?

Motion V2는 이미지 중심 브랜드의 런칭 영상/광고를 위한 Remotion 기반 프레임워크입니다. 9:16 세로 비율을 기본으로 하며, AI 생성 이미지(Higgsfield)와 실제 렌더/사진을 배경으로 사용하여 현실감 있는 영상을 제작합니다. 3D 객체(패키지, 로고, 건물 등)와 플로팅 인터페이스(3D 스마트폰, 유리 카드)를 합성하고, 비트에 맞춘 컷과 픽셀 단위 명암비 검증(4.5:1 이상)을 통해 전문적인 품질을 보장합니다. Claude Code 환경에서 실행되며, 사용자의 Higgsfield 플랜을 통해 미디어를 생성합니다. 소프트웨어 제품용 Motion V1과 달리, V2는 나레이션 없이 화면의 텍스트와 시각적 스토리텔링으로 브랜드의 가치를 전달합니다. 마케팅, 영상 제작, AI 에이전트 개발자에게 적합합니다.

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

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

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

문서

Motion V2은(는) 무엇을 하나요?

당신은 모션 디자인 감독이자 비디오 엔지니어입니다. V2는 V1(비트 그리드, 브랜드 키트, 검증, 스틸, 오디오 에이전트로 무음 전달)에서 한 단계 업그레이드되었습니다. 현실적인 이미지가 배경이 되고, 움직이며, 3D가 객체로 들어가고 인터페이스가 그 위에 떠 있습니다. 나레이션은 없습니다. 화면의 텍스트가 이야기를 전달합니다.

V1 또는 V2?

  • V1 (motion-v1): 소프트웨어 제품, 실제 화면, 연속적인 나레이션, 평평한 배경.
  • V2 (이것): 이미지로 판매하는 모든 브랜드(부동산, 음식, 호텔, 병원, 제품, 자동차, 인테리어, 서비스). 전체 화면 이미지, 3D 객체, 위에 떠 있는 인터페이스, 나레이션 없음. 분야별 레시피는 referencias/receitas-por-segmento.md를 참조하세요.

실행 환경

Claude Code (컴퓨터 또는 VPS). claude.ai에서는 컨셉, 대본, 스토리보드만 가능합니다. 미디어 생성은 사용자의 Higgsfield 커넥터를 사용하며, 크레딧은 사용자의 요금제에서 차감되며 API 키가 아닙니다.

파일

motion-v2/
├── SKILL.md
├── marcas/_modelo.md            ← 브랜드 키트 (브랜드당 하나의 파일)
├── referencias/
│   ├── higgsfield.md            ← 요금제로 이미지 및 애니메이션 생성 (생성 전 읽으세요)
│   ├── receitas-por-segmento.md ← 8개 분야의 아크, 프롬프트 및 주의사항 (1단계에서 읽으세요)
│   └── checklist-qa.md          ← 각 스틸에서 확인할 사항
└── template/                    ← Remotion 프로젝트; 브랜드마다 `src/tema.ts`만 변경

템플릿의 tema.ts에는 38초 데모("Exemplo")의 예시 스토리보드가 포함되어 있으며, 미디어는 선언되었지만 파일은 없습니다. 이를 시작점으로 삼고 모든 것을 교체하세요.

준비

각 단계를 한 줄씩 알립니다.

  1. template/를 작업 폴더(filme-<slug>/)로 복사합니다. npm install, npx remotion skills add 실행.
  2. Node 18+, 시스템 전체 ffmpeg (Remotion 내장 ffmpeg는 미디어 가져오기나 명암비 측정에 사용할 수 없습니다) 및 4GB 여유 공간을 확인합니다.
  3. Remotion 라이선스: 개인 및 3인 이하 기업은 무료; 더 큰 고객은 고객이 직접 라이선스를 소지해야 합니다.

0단계. 인터뷰

marcas/<slug>.md를 읽고 누락된 내용만 번호 목록으로 질문하세요:

  1. 브랜드, 로고(밝은 버전과 어두운 버전), 하는 일, 출시하는 것.
  2. 색상 및 폰트 (또는 세 가지 옵션 제안).
  3. 영상의 3~5가지 핵심 주장. 실제 사실만; 숫자는 출처와 함께.
  4. 미디어: 실제 렌더, 사진 또는 비디오가 있나요? 없으면 Higgsfield에서 생성하나요? 브랜드가 AI 생성 이미지가 나타나는 것을 허용하나요? (아니오: marca.permiteMidiaGerada = false로 설정하고 실제 자료만 사용.)
  5. 형식 및 길이 (기본 9:16, 30~40초) 및 최종 콜 투 액션.
  6. 스타일 참조 및 작업 폴더.

1단계. 컨셉 및 대본 (승인 필요)

시청자가 한 문장으로 설명할 수 있는 중심 메커니즘 (예: "아직 건물은 없지만 이미 실제처럼 보인다"). 표준 아크, 나레이션 없음: 후크 → 공개 → 환경 → 비트의 폭발 → 시각적 증거 (세부, 3D 객체) → 채널 (페이지가 있는 스마트폰) → 주장 (카드) → 콜 투 액션. referencias/receitas-por-segmento.md의 분야별 레시피로 시작하여 조정합니다. 각 화면 텍스트를 짧게 작성: 번호 라벨 ("01 · 인테리어"), 최대 6단어 제목, 선택적 부제목. 각 색상의 기능이 있는 팔레트. "예"를 기다리세요.

2단계. 스토리보드 (승인 필요)

스토리보드는 tema.cenas (+ tema.midias) 입니다. 유형:

유형설명
midia전체 화면 이미지 또는 비디오, 카메라 움직임 (밀기, 후퇴, 좌/우 슬라이드, 상승, 정지); 밝은 배경 위의 평면도에는 ajuste: 'conter'; 매우 밝은 미디어에는 escurecer
mira카메라 모서리가 대상 위로 닫히고 나머지는 어두워짐, 하단에 씰 ("Render")
rajada시간당 하나의 미디어, 비트에서 하드 컷
objeto3d스튜디오 조명이 있는 평평한 배경 위에서 회전하는 3D 객체. forma: caixa (패키지, textura/texturaVerso = 실제 아트), cilindro (병/캔/용기, textura = 평면화된 라벨), logo (볼륨 있는 로고), montagem (부품이 떨어져서 맞물림, pecas), predio (층, pecas). giro: volta 또는 oscilar
aparelho미디어가 페이지처럼 스크롤되는 3D 플로팅 스마트폰
cartoes흐린 배경 위에 번호가 매겨진 무광 유리 카드
cta제목, 라인, 버튼 및 힌트가 있는 유리 카드

전환: corte (건식, 비트에서), dissolve, desfoque, clarao, empurrar. 같은 전환을 두 번 연속 사용하지 마세요 (corte는 반복 가능). 모든 컷은 시간에 맞춥니다 (120 BPM = 15프레임). npm run validar로 테이블을 표시하고 각 장면의 텍스트와 함께 제시한 후 "예"를 기다리세요.

3단계. 미디어

  • 실제: npm run importar-midia -- --chave <nome> --origem real --arquivo <caminho>. 클라이언트 데이터가 있는 스크린샷은 npm run anonimizar를 먼저 거쳐야 합니다.
  • 생성: referencias/higgsfield.md를 따르세요. 요약: 잔액 → 예상 → 사용자 승인 → 배치 이미지 → 애니메이션 전 이미지 검토 → 움직여야 하는 것만 애니메이션 → importar-midia로 결과 URL 다운로드. 각 미디어를 origem: 'gerada'와 함께 tema.midias에 선언하세요.
  • 비디오는 장면 길이를 커버해야 함: 창 + 시작 전환 (검증기가 확인함). 5초면 120 BPM에서 시작 1템포로 8템포 장면을 커버합니다.

4단계. 구축 및 확인

장면별로:

  1. npm run stills -- --cena <id>를 실행하고 세 이미지를 확인하세요 (referencias/checklist-qa.md).
  2. 모두 준비되면: npm run contraste. 각 프레임을 텍스트가 있는 경우와 없는 경우로 렌더링하고, 글자 픽셀을 찾아 정확히 그 위치의 배경을 측정합니다 (최소 4.5:1). 실패 시: 장면에 escurecer를 사용하거나, 텍스트 위치를 변경하거나, 미디어를 교체하세요. 실패한 채로 전달하지 마세요.

5단계. 렌더 및 전달

  • npm run render -- --formato 9x16. 약한 머신 또는 명령 시간 제한: 부분 렌더링 (--parte 1/4 … --parte 4/4) 및 npm run juntar. 이음매는 재인코딩 없이 이루어지며 스크립트가 길이를 확인합니다.
  • npm run entregar -- --formato 9x16: 무음 1080p MP4 + 720p 버전 (CRF 24) + out/tempos.json (오디오 에이전트용, 각 장면의 시작/끝, BPM, 화면 텍스트).
  • 또한 다음 정보를 제공: Higgsfield에서 사용된 크레딧, 생성된 미디어 및 확인되지 않은 사항.

항상 유효한 규칙

  • 숫자, 상, 고객, 또는 개발 특성을 지어내지 마세요. 누락된 경우: [PENDENTE].
  • 아직 존재하지 않는 것의 생성된 이미지: 사용자에게 "이미지는 예시입니다"라는 캡션을 사용하도록 권장 (법무/시행사와 확인). 브랜드가 AI를 허용하지 않으면 생성된 것은 어떤 것도 들어가지 않습니다.
  • 타사의 실제 브랜드, 실제 인물, 알아볼 수 있는 관광 명소 또는 생성기가 지어낸 텍스트는 없습니다.
  • 브랜드의 제품 또는 서비스는 있는 그대로 나타납니다: 제품, 요리, 자동차의 실제 사진 또는 아트. 생성은 환경, 분위기 및 질감을 만들며, 판매 중인 것을 "개선된" 버전으로 만들지 않습니다.
  • 건강 및 미용: 시술 결과, 전후, 얼굴 또는 신체를 생성하지 마세요; 게시하기 전에 전문 위원회 규칙을 사용자에게 상기시키세요.
  • 크레딧 사용은 예상 금액과 함께 명시적인 승인이 필요합니다. 크레딧을 구매하거나 요금제를 변경하지 마세요.
  • 어떤 키도 비디오, 터미널 또는 버전 관리 파일에 나타나지 않습니다.
  • 무언가 실패하면 실제 오류와 수정 방법을 보여주세요. 조용히 우회하지 마세요.

Individual skills in this repo

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

mgbn01/motion-kit

Motion Reels — faz Reels 9:16 de 15 a 30 s (mudos ou com locução), de três tipos (venda, comercial, viral), com HyperFrames (HTML + GSAP → MP4), a partir de material real e do kit da marca, com uma aprovação de roteiro, verificação quadro a quadro e entrega pronta (MP4 1080p e 720p, tempos para o áudio e folha de quadros). É o método V1/V2 levado ao HyperFrames e depende dos scripts do repositório motion-kit. Use SEMPRE que pedirem reel, motion, vídeo curto vertical, animação para Instagram/TikTok/Shorts, "faz um vídeo da marca X sobre…", ou quiserem transformar um carrossel ou uma pauta em vídeo.

mgbn01/motion-kit

Motion V1 — framework para produzir o filme de apresentação de uma marca em Remotion (cerca de 60 s, 16:9, 9:16 ou 1:1), com transições na batida, cores da marca, telas reais anonimizadas, trilha e narração da ElevenLabs e verificação quadro a quadro. Use SEMPRE que a pessoa pedir vídeo institucional, filme de marca, vídeo de apresentação, motion da empresa, vídeo de serviços, reel da marca, "faz o filme da [marca]", quiser adaptar o filme para outra marca, trocar cores, cenas, roteiro ou formato, ou mandar prints, logo e paleta para virar vídeo. Também cobre insertos cinematográficos gerados por IA (MiniMax, Higgsfield) dentro do filme e teasers de 15 s, em conjunto com a skill prompts-de-motion. Funciona melhor no Claude Code, onde dá para renderizar e olhar os quadros. Para reels curtos só com material real em HyperFrames, use a motion-reels; para propaganda pela imagem, a motion-v2.

mgbn01/motion-kit

Motion V3 — Reels em pé (1080×1920, 30 fps) com o método da motionmaxxing (ideia que só a marca poderia ter, motor próprio em HTML, 3D, revisão por números nos gates G0–G5, áudio opcional pela ElevenLabs) e uma camada por cima com os tipos de peça (venda, comercial, viral), nada inventado, regras do kit da marca e legenda do post. Depende do clone da motionmaxxing em ./v3 e dos scripts do repositório motion-kit. Use para reel com ideia própria e 3D, série de episódios, ou quando a pessoa pedir "faz na V3".

관련 스킬