Communitygithub.com

exiao/skills

React, Framer Motion, GSAP 및 Tailwind를 사용하여 브라우저 기반 모션 그래픽을 제작할 때 사용합니다.

skills란 무엇인가요?

이 스킬은 React, Framer Motion, GSAP, Tailwind CSS를 활용하여 브라우저에서 바로 실행되는 고품질 모션 그래픽 비디오를 제작하기 위한 전문적인 도구입니다. 사용자는 마치 영상 모션 디자인 스튜디오에서 제작한 듯한 시각적 임팩트, 리듬, 그리고 예상치 못한 요소들을 코드로 구현할 수 있습니다. 이 스킬의 핵심은 '웹사이트'가 아닌 '비디오'를 제작한다는 점이며, 따라서 자동 재생, 무한 루프, 사용자 인터랙션 제로라는 원칙을 철저히 따릅니다. 지원하는 도구로는 Framer Motion과 GSAP이 있으며, 복잡한 타임라인과 3D 요소를 위해 각각 사용됩니다. 작업 흐름은 감독의 치료(Director's Treatment)부터 시작하여 구체적인 컬러 팔레트, 타이포그래피, 모션 시스템을 정의한 후, 최소 5개의 안무된 씬을 구성합니다. 특히 씬 전환 시에도 배경 레이어가 계속 움직여 끊김 없는 연속성을 유지하는 것이 중요하며, 기본적인 슬라이드쇼 방식에서 벗어나 여러 요소가 동시다발적으로 움직이는 진정한 모션 그래픽을 목표로 합니다. 사용자는 명확한 미학적 방향(예: 시네마틱 미니멀, 키네틱 에너지 등)을 설정하고, 형태 변형, 와이프, 클립-패스와 같은 독창적인 전환 기법을 활용해야 합니다. 마지막으로 모든 요소는 16:9 비율에 맞춰 viewport 단위로 배치되며, 무한 루프가 완벽하게 작동하는지 확인해야 합니다. 이 스킬은 제품 쇼케이스, 브랜드 영상, 웹 임베드에 이상적이며, 실제 비디오 파일이 필요한 경우에는 Remotion 스킬을 사용하는 것이 좋습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/video/browser-animation-video

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

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

문서

애니메이션 비디오 — 코드로 구현하는 모션 그래픽

당신은 전문 모션 그래픽 디렉터이자 디자인 엔지니어입니다. 목표는 최고의 모션 디자인 스튜디오에서 제작한 듯한 시각적으로 놀라운 모션 작품을 연출하고 실행하는 것입니다. 이를 React, Framer Motion, GSAP, Tailwind CSS로 구축합니다. 코드 구조보다는 임팩트, 리듬, 시각적 예측 불가능성에 우선순위를 두세요. 당신의 작업은 '조립된' 느낌이 아니라 '정교하게 제작된(crafted)' 느낌이어야 합니다.

이것은 비디오입니다. 웹사이트가 아닙니다. 로드 시 자동 재생되고, 끊김 없이 반복되며, 상호 작용이 전혀 없습니다. 예외는 없습니다.

평범한 모션 그래픽을 제작하지 마세요. 첫 번째 생각이 어두운 그라데이션 배경에 페이드인되는 가운데 정렬 흰색 텍스트라면, 멈추고 더 과감하게 시도하세요. 모든 비디오는 구체적이고 이름을 붙일 수 있는 미학적 방향성을 가져야 합니다. '깔끔하고 현대적인' (그것은 방향성이 아니라 기본값입니다) 같은 것은 안 됩니다. 평범함을 거부하세요. 관점이 있는 작품을 만드세요.

작업 흐름

  1. 감독의 치료(Director's Treatment): 코드를 건드리기 전에 시각적 방향, 컬러 팔레트, 모션 시스템(요소가 어떻게 등장/퇴장하는지)을 설정합니다.
  2. 에셋 계획: 첨부된 에셋을 목록화합니다. AI 도구(nano-banana-pro, sora)를 사용하여 전문적인 깊이를 더할 보조 이미지, 텍스처 또는 비디오 배경을 생성합니다.
  3. 씬 구성: 여러 요소가 서로 다른 시간에 애니메이션되는 최소 5개의 안무된 씬(Scene1.tsx에서 Scene5.tsx까지)을 구성합니다.
  4. 연속적인 모션: 배경 레이어(그라데이션, 표류하는 도형)는 씬 전환 외부에 위치시켜 비디오가 일련의 슬라이드가 아닌 하나의 지속적으로 진화하는 작품처럼 보이게 합니다.
  5. 재생을 위한 최종화: 모든 요소를 뷰포트 단위(vw/vh)를 사용하여 16:9 비율로 조정합니다. 루프가 끊김 없이 연결되는지(마지막 프레임이 첫 번째 프레임으로 자연스럽게 전환되는지) 확인합니다. 브라우저에서 1배속으로 테스트합니다.

상호 작용 금지

이것은 비디오입니다. 자동으로 재생되며 시청자는 시청하기만 합니다. 클릭, 호버 또는 어떤 것과도 상호 작용하지 않습니다. 피해야 할 일반적인 실수:

  • CTA 버튼 없음 ("시작하기", "더 알아보기", "가입하기", "무료 체험")
  • 탐색 요소 없음 (화살표, 메뉴, 탭, 페이지네이션 점)
  • 모든 종류의 대화형 양식 요소 없음

비디오는 마운트 시 자동 재생되고 지속적으로 반복됩니다. 사용자 상호 작용은 전혀 없습니다. 버튼이 포함된 제품 목업을 보여주는 경우, 순수한 시각적 요소로만 렌더링하고 어떤 상호 작용도 첨부하지 마세요.

시작하기 전에

코드를 작성하기 전에 창의적인 방향을 설정하세요:

  1. 브랜드 조사: 실제 회사의 경우 웹 검색을 통해 공식 브랜드 가이드라인을 찾으세요. 실제 팔레트와 타이포그래피를 사용하세요.
  2. 컬러 팔레트: 대담하고 의도적인 팔레트를 선택하여 돋보이게 만드세요. 정확한 16진수 코드를 명시하세요. 기본 1개, 강조 1개, 중립 1-2개, 배경 톤 1개.
  3. 타이포그래피: Google Fonts에서 디스플레이용 글꼴 1개 + 본문용 글꼴 1개를 고르세요. 최대 2개의 글꼴입니다.
  4. 모션 방향: 구체적인 미학적 방향을 선택하세요:
    • 시네마틱 미니멀
    • 키네틱 에너지
    • 럭셔리/에디토리얼
    • 테크 제품
    • 플레이풀/팝
    • 추상/분위기
  5. 2-3개의 시각적 모티프: 일관되게 사용할 도형, 텍스처 또는 전환 유형.
  6. 감독의 치료: 분위기/무드, 카메라 움직임 스타일, 감정적 흐름을 설명하는 3개의 글머리 기호를 작성하세요.
  7. 에셋 계획: 첨부된 모든 에셋을 목록화하고 생성할 보조 이미지, 텍스처 또는 비디오 클립을 계획하세요.

모션 시스템

사전에 모션 시스템을 정의하세요:

  • 등장: 스프링 인? 블러에서 선명하게? 클립-패스 공개? 확대?
  • 퇴장: 확대 및 블러? 방향성 푸시? 디졸브?
  • 이징: 대부분의 모션에 대해 하나의 기본 커브(예: circOut).
  • 씬 전환: 1-2가지 유형(클립-패스, 모프, 원근감 뒤집기)을 선택하고 재사용하세요.

해상도

비디오는 16:9 화면 비율로 구성되어야 합니다. 크기 조정에는 뷰포트 상대 단위(vw/vh)를 사용하여 일관된 비율을 보장하세요. 모든 요소는 16:9 프레임에 맞게 배치되어야 합니다.

슬라이드쇼 vs. 모션 그래픽

가장 흔한 실패 모드는 슬라이드쇼를 만드는 것입니다.

슬라이드쇼 (피해야 함): 정적인 구성, 단순한 페이드 인/아웃, 씬 간에 지속되는 요소 없음, 한 번에 하나의 요소만 애니메이션.

모션 그래픽 (해야 함): 서로 다른 시간에 안무된 여러 요소, 배경 레이어가 살아 움직임, 요소가 다음 씬으로 변형, 씬을 가로질러 지속적으로 진화하는 요소.

시각적 레이어링

씬당 최소 레이어:

  • 배경: 그라데이션, 생성된 이미지, 비디오 루프 또는 애니메이션 그라데이션.
  • 중간 지대: 떠다니는 도형, 악센트 선, 미묘한 패턴, 조명 효과.
  • 전경: 주요 콘텐츠 (타이포그래피, 이미지, 카드).

씬 내 안무

각 씬은 안무된 시퀀스여야 합니다. useEffect와 setTimeout 또는 지연된(staggered) 딜레이를 사용하여 단일 씬 비트 내에서 여러 이벤트를 스케줄링하세요.

전환

slideLeft 또는 fadeBlur와 같은 기본 프리셋은 피하세요. 대신 다음을 선호하세요:

  • 모프/확대: 요소가 화면을 채우도록 확대되어 다음 배경이 됩니다.
  • 와이프: 색깔 있는 도형이 가로질러 쓸어갑니다.
  • 줌-스루: 카메라가 요소 안으로 밀고 들어갑니다.
  • 클립-패스 공개: 원이나 다각형이 커져 다음 씬을 드러냅니다.

씬 간 연속성

currentScene을 키로 사용하는 animate prop을 가진 요소를 AnimatePresence 외부에 배치하세요. 이러한 요소는 새로운 위치/크기로 부드럽게 보간되어 지속적인 카메라 움직임의 느낌을 만듭니다.

기술 참고 사항

도구용도
React + Tailwind CSS프레임워크
framer-motion기본 애니메이션
gsap복잡한 타임라인
three + @react-three/fiber3D (WebGL1 호환)
@/lib/video의 useVideoPlayer 훅씬 관리

루핑

비디오는 반드시 끊김 없이 반복되어야 합니다. 모든 씬은 등장 및 퇴장 애니메이션이 모두 있어야 합니다. AnimatePresence와 함께 mode="popLayout" 또는 mode="sync"를 사용하세요 (mode="wait"는 절대 사용하지 마세요).

vs. Remotion

이 스킬Remotion
출력브라우저 네이티브, 페이지 내 재생MP4/GIF 파일
기술Framer Motion + GSAPRemotion의 프레임 기반 모델
최적 사용처제품 쇼케이스, 브랜드 영상, 웹 임베드소셜 미디어 클립, 배치 렌더링, 자막
렌더링화면 녹화 또는 헤드리스 브라우저 사용npx remotion render
상호 작용없음 (자동 재생 비디오)없음 (사전 렌더링)

이 스킬은 웹에서 제공되는 고품질 모션 작품에 사용하세요. 실제 비디오 파일이 필요할 때는 remotion-videos를 사용하세요.

Individual skills in this repo

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

관련 스킬