애니메이션 제너레이터은(는) 무엇을 하나요?
자연어 설명을 바탕으로 애니메이션 비디오와 모션 그래픽을 생성합니다. 브라우저에서 재생되는 독립형 Vite + React + Framer Motion 프로젝트를 만듭니다.
워크플로우
1단계: 요청 파싱
사용자 설명을 장면 계획으로 분해합니다:
- 3-7개 장면, 각각 3-5초 길이
- 스토리 아크 파악: 히어로/인트로, 문제, 해결책, 기능, CTA/아웃트로
- 브랜드/분위기에 맞는 색상 팔레트 및 타이포그래피 선택
- 사용자 애니메이션 설명에는
$ARGUMENTS사용
2단계: 애니메이션 스택 선택
요청에 따라 최적의 접근 방식을 자동 감지합니다:
| 요청 유형 | 스택 | 사용 시기 |
|---|---|---|
| 제품 인트로, 프레젠테이션, 마케팅 | 프레이머 모션(Framer Motion) (기본값) | 텍스트, 아이콘, 전환이 포함된 장면 기반 |
| 제너러티브 아트, 파티클, 패턴 | p5.js | 창의적/알고리즘적 비주얼 |
| 3D 객체, 환경, 제품 렌더 | Three.js + react-three-fiber | 3D 장면 필요 시 |
| 간단한 텍스트/로고 애니메이션 | CSS 애니메이션 전용 | 최소한, 무거운 의존성 불필요 |
요청이 명확히 다른 것을 요구하지 않는 한 기본값으로 프레이머 모션을 사용합니다.
3단계: 프로젝트 스캐폴딩
- 디렉토리 생성:
~/animations/[project-name]/ - 스캐폴드 스크립트 실행:
bash ~/.claude/skills/animate/scripts/scaffold.sh [project-name] [stack] ~/.claude/skills/animate/assets/template-files/에서 템플릿 파일을 프로젝트로 복사
4단계: 장면 컴포넌트 생성
애니메이션 사전 설정과 장면 패턴에 대한 참조를 읽습니다:
references/animation-presets.md— 사용 가능한 모든 전환, 스프링, 이징references/scene-patterns.md— 예제 장면 코드 패턴
각 장면에 대해 client/src/components/video/video_scenes/에 React 컴포넌트를 생성합니다:
- 장면 전환 사전 설정(fadeBlur, scaleFade, slideLeft, splitHorizontal, morphExpand 등)과 함께
motion.div사용 - 지연된 콘텐츠 표시를 위해
containerVariants및itemVariants사용 - 반응형 크기 조정을 위해
vw단위 사용 (모든 해상도에서 작동) - 테마 설정을 위해 CSS 변수 사용 (
var(--color-accent),var(--color-bg-dark)등) - 시각적 요소에 Lucide 아이콘 사용
- 프로스트 글라스 카드에
.glass-panel클래스 사용 - 그래디언트 텍스트에
.text-gradient및.text-gradient-accent사용
5단계: VideoTemplate 생성
client/src/components/video/VideoTemplate.tsx를 생성합니다:
- 모든 장면 컴포넌트 가져오기
SCENE_DURATIONS객체 정의 (장면 이름 -> 밀리초)useVideoPlayer훅을 사용하여 장면 진행 관리- 부드러운 전환을 위해
AnimatePresence mode="wait"로 장면 감싸기 - 각 장면은
currentScene인덱스에 따라 조건부 렌더링
6단계: 테마 사용자 정의
올바른 색상으로 client/src/index.css를 업데이트합니다:
- 사용자가 브랜드 색상을 지정한 경우 CSS 변수 업데이트
- 분위기에 맞는 글꼴 선택 (기술 분야는 Space Grotesk, 우아한 분위기는 Playfair Display 등)
- 팔레트에 맞게 그래디언트와 글로우 스타일 업데이트
7단계: Gemini 3.1 Pro 향상 (선택 사항)
GEMINI_API_KEY 환경 변수가 사용 가능한 경우:
references/gemini-integration.md에서 API 세부 정보 읽기- 사용자 설명을 Gemini 3.1 Pro에 전송하여 다음을 요청:
- 설명과 제안된 전환이 포함된 장면 분류
- CSS 변수로 된 색상 팔레트
- 각 장면에 대한 카피/헤드라인
- 해당되는 경우 SVG 그래픽
- Gemini 출력을 장면 생성에 활용
- API 키가 없으면 이 단계 건너뛰기 — Claude가 모든 창의적 결정을 직접 처리
8단계: 빌드 및 미리보기
cd ~/animations/[project-name]
npm install
npm run dev
사용자에게 애니메이션이 http://localhost:5173에서 실행 중임을 알리고 브라우저에서 엽니다.
장면 전환 참조 (빠른 참조)
스토리 비트에 맞는 전환을 선택하세요:
- fadeBlur — 부드러운 인트로/아웃트로, 꿈결 같은 표시
- scaleFade — 자신감 있는 표시, 제품 쇼케이스
- slideLeft/slideRight — 순차적 진행, 타임라인 흐름
- splitHorizontal/splitVertical — 극적인 표시, 전후 비교
- morphExpand — 대단원, CTA 화면
- clipCircle — 주의 집중, 스포트라이트 효과
- perspectiveFlip — 카드 뒤집기, 관점 변화
- wipe — 깔끔한 전환, 방향성 흐름
- zoomThrough — 몰입형, 전진적 모멘텀
- crossDissolve — 부드럽고 감성적인 전환
요소 애니메이션 참조 (빠른 참조)
- popIn — 아이콘/뱃지를 위한 통통 튀는 스케일 진입
- fadeUp/fadeDown — 미묘한 콘텐츠 표시
- slideInLeft/slideInRight — 방향성 콘텐츠
- blurIn — 부드러운 초점 표시
- elasticScale — 장난기 가득하고 에너지 넘치는 진입
- perspectiveRotateIn — 3D 카드 표시
- pulse — 반복적인 주목 유도
- float — 부드러운 호버링 효과
중요 규칙
- 항상 크기 조정에
vw단위를 사용하여 애니메이션이 모든 해상도에서 잘 보이도록 합니다. - 각 장면은 3-5초로 유지 — 총 비디오는 15-30초
AnimatePresence mode="wait"를 사용하여 한 장면이 나간 후 다음 장면이 들어오도록 합니다.- 모든 장면에는 배경 처리(그래디언트, 이미지 또는 애니메이션 모양)가 있어야 합니다.
- 목록과 그리드에는 지연 애니메이션을 사용합니다 (staggerChildren: 0.1-0.2)
- 자산이 무거운 경우 로딩 상태를 포함합니다.
- 프로젝트는 완전히 자체 포함되어야 합니다 — npm 패키지 외부 의존성 없음
- 생성된 코드나 콘텐츠에 이모지를 사용하지 마십시오.