Communitygithub.com

carrusel-motion

Instagram용 움직이는 캐러셀을 생성합니다. 각 슬라이드는 1080x1350, 60fps의 짧은 비디오로, 정적인 시트처럼 보이지만 텍스트가 줄 단위로 나타나고, 선이 그려지고, 카운터와 버튼이 부드럽게 애니메이션됩니다. '움직이는 캐러셀', '애니메이션 슬라이드', '애니메이션 Instagram 게시물'을 요청하거나 정적 슬라이드/이미지를 마이크로 애니메이션이 포함된 비디오로 변환할 때 사용하세요. Remotion을 사용하여 슬라이드당 무음 MP4를 생성하며, 루프가 끊김 없이 이어지도록 인/아웃 포인트를 포함합니다.

carrusel-motion란 무엇인가요?

`carrusel-motion`은 Instagram 움직이는 캐러셀을 생성하는 Claude Code 및 유사 AI 에이전트 전용 스킬입니다. 각 슬라이드는 1080x1350 해상도, 60fps, 5초 길이의 무음 MP4 비디오이며, 정적인 디자인처럼 보이지만 텍스트가 줄 단위로 나타나고, 선이 그려지고, 카운터가 올라가는 등 부드러운 마이크로 애니메이션을 포함합니다. 이 스킬은 '움직이는 캐러셀', '애니메이션 슬라이드' 등의 요청을 처리하며, 기존 정적 이미지를 애니메이션화하거나 새로운 콘텐츠를 처음부터 제작할 수 있습니다. 주요 플랫폼은 Remotion이며, 추가 외부 종속성(ffmpeg나 API 키) 없이 Node.js 18 이상만 있으면 됩니다. 워크플로는 콘텐츠 이해, 고유 스타일 선택, 프로젝트 설정(템플릿 복사), 각 슬라이드 빌드(미리 정의된 블록 사용), 특정 프레임 확인, 각 슬라이드별로 MP4 렌더링 순으로 진행됩니다. 핵심 규칙으로는 60fps 유지, 부드러운 이징 커브, 모든 슬라이드에 인/아웃 적용, 마지막 프레임이 비어 있어 루프가 끊기지 않도록 하는 것, 첫 번째 슬라이드(커버)는 0프레임부터 완전히 보여야 Instagram 미리보기가 정상적으로 표시되도록 하는 점 등이 있습니다. 이 스킬은 사용자가 제공한 로고나 마스코트만 사용하며, 타사 브랜드를 복사하지 않고, 시각적 아이덴티티를 존중합니다.

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

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

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

문서

움직이는 캐러셀 (Remotion)

각 슬라이드가 약 5초 비디오인 Instagram 캐러셀로, 언뜻 보기에는 정적인 디자인처럼 보이지만 내부적으로 부드럽게 움직입니다. "멈춰 있는 듯하지만 숨 쉬는" 듯한 대비가 사용자가 계속 넘기도록 유도합니다.

사용 시기

  • Instagram용 애니메이션 또는 "움직이는" 캐러셀/게시물/슬라이드를 요청할 때
  • 정적 슬라이드 이미지(PNG)를 받고 애니메이션 버전을 원할 때
  • 주제/텍스트만 주어졌을 때 처음부터 애니메이션 캐러셀을 만들 때

전체 화면(9:16) 내레이션 비디오를 요청하는 경우 이 스킬은 적합하지 않습니다.

필요 사항

  • Node.js 18 이상. ffmpeg나 어떤 서비스의 API 키도 필요하지 않습니다.
  • 사용자가 로고나 마스코트를 가지고 있는 경우: 투명 배경 PNG (또는 흰색 배경; scripts/Preparar-brand.py 스크립트가 자동으로 제거합니다. Python과 Pillow 필요).
  • 로고와 이미지는 프로젝트 폴더 내에 파일로 존재해야 합니다. 채팅에 붙여넣은 이미지는 파일이 아닙니다: Claude가 볼 수는 있지만 프로젝트에 복사할 수는 없습니다. 사용자가 로고를 붙여넣으면 public/brand/에 저장하도록 요청하세요.
  • Remotion 라이선스: 개인 및 최대 3명 팀은 무료, 더 큰 기업은 라이선스 필요 (현재 조건: https://www.remotion.dev/docs/license). 사용자가 기업 소속인 것 같으면 알려주세요.

작업 흐름

  1. 콘텐츠 파악. 슬라이드 이미지가 있으면 읽고(이미지입니다: 직접 보세요) 텍스트를 있는 그대로 옮깁니다. 디자인상 필요한 경우(예: 한 줄에 고립된 단어 방지) 줄이거나 나눌 수 있지만, 의미를 바꾸거나 데이터를 임의로 만들지 마세요.
  2. 이 캐러셀만의 고유한 스타일 선택 (referencias/variedad-de-estilo.md 참조). 편의상 다른 캐러셀의 스타일을 복사하지 마세요. 사용자가 아이덴티티(예: "검은 배경과 흰색 텍스트")를 가지고 있다면 존중하고 다른 축(구성, 애니메이션 요소)을 변경하세요.
  3. 프로젝트 설정. 프로젝트가 없으면 이 스킬의 plantilla/ 폴더를 사용자 작업 폴더로 복사하고 npm install을 실행하세요. 템플릿에는 기본 규칙이 담긴 CLAUDE.md가 있습니다: 사용자가 자신의 브랜드로 채우도록 도와주세요(매 세션 반복하지 않도록). 이미 프로젝트가 있으면 src/carousels/<slug>/에 새 캐러셀을 추가하고 src/carousels/index.tsx에 등록하세요.
  4. 각 슬라이드 구성 plantilla/src/carousels/ejemplo/style.tsx의 블록(Block, Title, Body, Eyebrow, GhostNumber, Cta, Header, Footer)을 사용합니다. 슬라이드 하나 = 컴포지션 <slug>-01, <slug>-02...
  5. 실제 프레임 검토 렌더링 전에: npx remotion still src/index.ts <slug>-01 salida.png --frame=200 명령어로 네 지점(진입 ~프레임10, 정지 ~200, 종료 ~285, 마지막 299)에서 각 이미지를 확인하세요. 텍스트 잘림, 겹침, 여백, 마지막 프레임이 비어 있는지(고정 헤더와 푸터 제외) 확인하세요.
  6. 렌더링 슬라이드당 하나의 MP4 (아래 명령어 참조)로 파일 목록을 제공하세요.
  7. 확인하지 않은 점 솔직히 말하기: 프레임은 봤지만 움직임은 확인하지 않았고, Instagram 업로드는 테스트하지 않았음을 알리세요.

형식 (변경 불가)

  • 1080 × 1350 (4:5), 60fps에서 300프레임 (5초), 무음 (--muted).
  • 측면 여백 80px. 가장자리에 중요한 요소 배치 금지. (Instagram 프로필 그리드는 4:5를 3:4로 자르므로 한쪽에 약 34px 손실: 80px 여백이면 문제없음.)
  • 커버(슬라이드 1) — 필수: 진입 없음. 모든 콘텐츠(제목, 텍스트, 마스코트)는 프레임 0에서 보이고 제자리에 있어야 합니다. Instagram 미리보기/썸네일이 이 프레임을 사용하기 때문입니다: 커버가 빈 상태에서 시작하면 게시물이 하얗게 나옵니다. 이를 위해 enterAt을 매우 낮게 설정합니다(템플릿에서는 COVER = -200). 이후에는 정상적으로 움직입니다: 주기적인 미세 움직임과 다른 슬라이드와 같은 종료. 진입만 다르며 나머지 과정은 동일합니다. 다른 슬라이드(2…N)는 빈 상태에서 진입하고 빈 상태로 종료됩니다. 확인: 커버의 --frame=0은 절대 비어 있으면 안 됩니다.
  • 출력: out/carruseles/<slug>/<slug>_01.mp4, _02.mp4...

슬라이드당 렌더 명령어:

npx remotion render src/index.ts <slug>-01 out/carruseles/<slug>/<slug>_01.mp4 --codec=h264 --crf=16 --pixel-format=yuv420p --image-format=png --muted

node scripts/render-carrusel.mjs <slug> <슬라이드 수>를 사용하여 한 번에 모두 렌더링할 수도 있습니다.

부드러움 규칙 (모바일에서 "끊김" 방지)

자세한 내용: referencias/fluidez.md. 요약:

  • 60fps와 부드러운 커브 (easeOutCubic, easeInOutCubic), 진입 시간 ~0.6초. 급격한 지수 커브는 피하세요: 갑자기 시작하고 미세 단계를 오래 끕니다.
  • 각 슬라이드에 진입 및 종료. 모든 콘텐츠는 마지막 프레임에서 보이지 않게 종료되어 비디오가 반복될 때 끊김 없이 이어집니다. 항상 프레임 299를 확인하세요: 컨테이너의 불투명도를 재정의하는 인라인 스타일(예: opacity: undefined)이 요소를 보이게 할 수 있습니다.
  • transform과 opacity만 애니메이션. 필터(blur, displacement)나 배경 노이즈/그레인은 사용 금지: Instagram이 재압축하면서 깜박입니다. 그림자와 광택은 고정 (baked in), 절대 애니메이션 금지.
  • 캐릭터나 일러스트레이션을 애니메이션할 경우: SVG 또는 고해상도 PNG, 일관된 두께의 윤곽선, 항상 비례적 스케일링, 미묘한 스쿼시 & 스트레치(±2-3%). plantilla/src/motion.ts에는 일회성 이벤트(시작과 끝이 정지 상태)를 위한 도우미(bell, hold, wobble, win)가 있습니다.
  • 헤더와 푸터는 고정: 움직이는 요소가 적을수록 더 부드럽게 느껴집니다.
  • 주기적인 배경 움직임 (기간 = 지속 시간의 loop 함수)으로 루프가 연속적으로 이어지도록 합니다.
  • 모든 것은 결정론적: Math.random이나 타이머 사용 금지; 모든 것은 프레임 번호에 기반합니다.

콘텐츠 및 브랜드 규칙

  • 타사 브랜드 로고를 복사하지 마세요. 사용자가 제공한 로고/마스코트만 public/brand/에서 사용하세요.
  • 숫자, 가격, 주장을 임의로 만들지 마세요: 사용자가 제공한 것만 사용하세요.
  • 사용자가 지정한 시각적 아이덴티티(색상, 배경, 폰트)를 존중하고 그 안에서 다양화하세요.

이 스킬의 파일

  • plantilla/ — 최소 기능의 Remotion 프로젝트로, 3개 슬라이드 예제 캐러셀이 포함되어 있습니다.
  • referencias/fluidez.md — 모바일에서 부드러운 움직임을 만드는 이유와 방법.
  • referencias/variedad-de-estilo.md — 각 캐러셀이 독특한 외관을 갖도록 하는 축.
  • referencias/qa-checklist.md — 전달 전 체크리스트.
  • plantilla/CLAUDE.md — 사용자 브랜드로 채울 프로젝트 규칙.
  • plantilla/scripts/preparar-brand.py — 로고를 자르고 마스코트의 흰색 배경을 제거합니다.

관련 스킬