Communitygithub.com

beimeibeile/Remotion-controls-skill

Remotion 코드 기반 동영상 애니메이션 전문 제어 스킬. React/TypeScript 코드로 2D 애니메이션을 정밀 제어하고, 투명 배경(알파 채널) 렌더링을 기본 지원하여 WebM/MOV 투명 채널 비디오를 출력합니다. 컷편집 템플릿 애니메이션 소재, UI 애니메이션, 텍스트 레이아웃 애니메이션, 캐릭터 2D 애니메이션 등에 적합합니다. API 서비스화, 템플릿 라이브러리, 품질 관리 및 자가 학습 진화 기능을 제공합니다.

Remotion-controls-skill란 무엇인가요?

이 스킬은 Remotion을 기반으로 한 코드 기반 2D 애니메이션 제어 전문 스킬입니다. React/TypeScript를 사용하여 모든 프레임을 정밀하게 제어하며, 알파 채널을 기본 지원하여 WebM(VP9) 및 MOV(ProRes 4444) 형식의 투명 배경 비디오를 출력할 수 있습니다. 이를 통해 컷편집 템플릿의 애니메이션 소재, UI 애니메이션, 텍스트 레이아웃 애니메이션, 캐릭터 2D 애니메이션 등 다양한 장면에 활용할 수 있습니다. 또한 HTTP API 서비스를 제공하여 애니메이션 지시를 받아 비디오 파일을 출력하고, 다양한 사전 설정 템플릿(캐릭터 애니메이션, UI 애니메이션, 텍스트 애니메이션, 전환 효과)을 지원합니다. 품질 관리를 통해 프레임 레이트, 해상도, 비트레이트 및 알파 채널 무결성을 자동으로 검사하고, 렌더링 매개변수와 효과 점수를 기록하여 사전 설정을 최적화하는 자가 학습 진화 기능을 갖추고 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add beimeibeile/Remotion-controls-skill

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

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

문서

Remotion Controls Skill

코드로 비디오 애니메이션을 구동하는 전문 제어 스킬입니다. Remotion은 React 기반의 비디오 제작 프레임워크로, 코드로 모든 프레임을 정밀하게 제어하고 투명 배경 렌더링을 기본 지원합니다.

핵심 기능

기능설명
투명 배경 렌더링알파 채널을 기본 지원하며, WebM(VP9) / MOV(ProRes 4444) 투명 비디오 출력
코드 정밀 제어React/TypeScript로 위치, 확대/축소, 회전, 투명도, 이징 곡선 정밀 제어
API 서비스화HTTP API로 애니메이션 지시를 받아 비디오 파일 출력
템플릿 라이브러리사전 설정 애니메이션 템플릿 (캐릭터 애니메이션, UI 애니메이션, 텍스트 애니메이션, 전환 효과)
품질 관리프레임 레이트, 해상도, 비트레이트, 알파 채널 무결성 자동 검사
자가 학습 진화렌더링 매개변수와 효과 점수를 기록하여 사전 설정 매개변수 최적화

ComfyUI / Blender와의 차별점

스킬핵심 강점적용 분야
ComfyUI-controlsAI 생성 (이미지/비디오/오디오), 창의성 통제 불가캐릭터 이미지/씬 이미지/특수 효과 비디오 생성
Blender-controls3D 애니메이션, 물리 시뮬레이션, 고품질 렌더링3D 캐릭터 애니메이션, 제품 프레젠테이션, 물리 특수 효과
Remotion-controls2D 코드 애니메이션, 정밀 제어 가능, 투명 배경템플릿 애니메이션 소재, UI 애니메이션, 텍스트 레이아웃, 2D 캐릭터 애니메이션

빠른 시작

1. 종속 항목 설치

cd remotion-project
npm install

2. 투명 배경 비디오 렌더링

# CLI 방식
npx remotion render src/index.ts MyComp out/video.webm --transparent

# API 방식
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent

3. API 서비스 시작

python remotion_controls.py serve --port 8765

투명 배경 렌더링 설명 (검증된 프로세스)

Remotion은 투명 배경을 기본 지원하지만, CLI의 --transparent 인코딩은 알파 채널이 손실됩니다 (WebM VP8/VP9, MOV ProRes 모두 검증 실패).

검증된 올바른 프로세스 (PIT-024):

  1. PNG 시퀀스 렌더링: npx remotion render src/index.ts Composition out/frames --sequence (알파 채널이 포함된 PNG 시퀀스 출력)
  2. ffmpeg로 ProRes 4444 합성:
    ffmpeg -y -framerate 30 -i out/frames/%04d.png \
      -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \
      out/animation.mov
    
  3. 알파 채널 검증: python verify_animation.py out/animation.mov

컷편집 통합 시 주의 사항 (PIT-024):

  • add_media_safe로 ProRes 4444 mov를 가져오면 자동으로 H.264 mp4로 트랜스코딩되어 알파 채널이 손실됨 (66MB → 0.07MB)
  • 수동으로 가져와야 함: mov를 초안 materials 디렉터리에 직접 복사 → VideoMaterial 생성 → materials.videos에 등록 → VideoSegment(material=anim_material) → add_segment

애니메이션 소재 품질 기준

전체 기준은 QUALITY_STANDARD.md를 참조하세요.

적격 애니메이션 소재의 필수 지표:

  • 알파 채널 유지 (yuva444p12le)
  • ProRes 4444 인코딩 (profile=4)
  • 해상도/프레임 레이트/길이가 설정과 일치
  • 콘텐츠 커버리지 ≥ 50% (10포인트 샘플링)
  • 파일 크기 적절 (≤15MB/초)

자동화 검증:

python verify_animation.py <애니메이션 파일> --duration 20 --width 1080 --height 1920

기본 애니메이션 컴포넌트 라이브러리

remotion-project/src/components/에 위치하며, 모든 컴포넌트는 투명 배경을 지원합니다.

캐릭터 및 모션 컴포넌트

컴포넌트설명
CharacterSprite캐릭터 스프라이트: 다중 포즈 전환, 위치/확대/회전/투명도 키프레임 애니메이션
MotionPath모션 경로: 선형/베지어/탄성/바운스 모션
FlashEffect화면 플래시 효과: 빠르게 페이드 인, 천천히 페이드 아웃
ShakeEffect진동 효과: 진폭 감쇠 무작위 진동
FadeEffect페이드 인/아웃: 제어 가능한 페이드 인/아웃 시간
PopEffect팝업 효과: 탄성 확대/축소 팝업
SlideEffect슬라이드 효과: 네 방향으로 이징 슬라이드

텍스트 애니메이션 컴포넌트 (TextAnimations.tsx)

컴포넌트설명적용 분야
TextReveal문자별 나타나기: 타자기/페이드 인/위로 슬라이드/왼쪽으로 슬라이드내레이션, 대사, 제목 등장
TextPop팝업 텍스트: 확대/회전/바운스키워드 강조, 비트 포인트
TextWave웨이브 텍스트: 문자별 사인파 부동재미있는 스타일, 배경 음악 리듬
TextGlitch글리치 스타일: RGB 분리+떨림테크 감성, 글리치 아트, 전환
TextGradient그라데이션 광택: 색상 흐름+스캔 라이트제목, 브랜드명, 고급감
KineticText다이나믹 타이포그래피: 여러 줄 조합 애니메이션오프닝 타이틀, 엔딩 크레딧

전환 효과 컴포넌트 (TransitionEffects.tsx)

컴포넌트설명적용 분야
FadeTransition페이드 인/아웃 전환 (in/out/inOut)일반 전환, 감정적 이행
SlideTransition슬라이드 전환 (상하좌우)장면 전환, 콘텐츠 교체
ZoomTransition확대/축소 전환 (밀어넣기/당기기)강조 포인트, 카메라 추진
WipeTransition지우기 전환 (상하좌우/대각선)창의적 전환, 스타일화
BlurTransition블러 전환 (먼저 흐리게 후 선명하게)몽환적 이행, 회상 플래시백
GlitchTransition글리치 전환 (RGB 분리+스캔 라인)테크 감성, 글리치 아트

임팩트 효과 컴포넌트 (ImpactEffects.tsx)

컴포넌트설명적용 분야
PunchImpact펀치 임팩트 (충격파+별+화이트 플래시)격투, 타격, 충돌
ImpactFlash임팩트 플래시 (빠른 화이트 플래시)강타, 폭발, 비트 포인트
ParticleBurst파티클 버스트 (별/불꽃/파편)축하, 폭발, 충격
Shockwave충격파 (다중 링 확산)에너지 방출, 폭발, 진동
SpeedLines속도선 (방사형)고속 충격, 질주, 연속타

사용 예시:

import { PunchImpact, ParticleBurst, FadeTransition } from "./components";

// 격투 장면
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />

사용 예시:

import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";

<CharacterSprite
  poses={[
    { name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
      position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
    { name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
  ]}
  width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="맞았어!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="아야!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />

프로젝트 구조

remotion-controls-skill/
├── SKILL.md                    # 본 파일
├── QUALITY_STANDARD.md         # 애니메이션 소재 품질 기준
├── verify_animation.py         # 자동화 검증 도구
├── remotion_controls.py        # 메인 제어 스크립트 (CLI/API)
├── .env.example                # 환경 변수 예시
├── .gitignore
├── capabilities/
│   ├── cap_api_wrapper/        # Remotion API 래퍼
│   ├── cap_animation_renderer/ # 애니메이션 렌더러
│   ├── cap_template_library/   # 애니메이션 템플릿 라이브러리
│   ├── cap_quality_control/    # 품질 관리
│   └── cap_self_evolution/     # 자가 학습 진화
├── remotion-project/           # Remotion 프로젝트
│   ├── src/
│   │   ├── components/         # 기본 애니메이션 컴포넌트 라이브러리
│   │   │   ├── CharacterSprite.tsx
│   │   │   ├── MotionPath.tsx
│   │   │   ├── Effects.tsx
│   │   │   └── index.ts
│   │   ├── AnimationTemplate.tsx  # JSON 기반 애니메이션 템플릿
│   │   ├── Root.tsx
│   │   └── index.ts
│   ├── public/                 # 정적 소재 (캐릭터/소품 이미지)
│   └── package.json
└── out/                        # 렌더링 출력

기능 모듈

cap_api_wrapper — Remotion API 래퍼

  • render_media(): 비디오 렌더링 (투명 배경 지원)
  • render_still(): 단일 프레임 이미지 렌더링
  • select_composition(): 사용 가능한 Composition 목록 가져오기
  • get_props_schema(): Composition의 Props 정의 가져오기

cap_animation_renderer — 애니메이션 렌더러

  • 입력 애니메이션 명령 JSON → 투명 배경 비디오 출력
  • 키프레임 애니메이션 지원 (위치/확대/회전/투명도)
  • 이징 곡선 지원 (ease-in/ease-out/ease-in-out/linear/spring)
  • 다중 레이어 합성 지원

cap_template_library — 애니메이션 템플릿 라이브러리

  • 캐릭터 애니메이션 템플릿 (두바오 맞기, 표정 전환 등)
  • UI 애니메이션 템플릿 (버튼 클릭, 페이지 전환 등)
  • 텍스트 애니메이션 템플릿 (타자기, 페이드 인/아웃, 바운스 등)
  • 전환 효과 템플릿 (페이드 인/아웃, 슬라이드, 확대 등)

cap_quality_control — 품질 관리

  • 프레임 레이트 검사 (24/30/60fps)
  • 해상도 검사 (1080p/4K)
  • 알파 채널 무결성 검사
  • 비디오 길이와 예상치 비교
  • 파일 크기 적절성 확인

cap_self_evolution — 자가 학습 진화

  • 렌더링 매개변수와 효과 점수 기록
  • 사전 설정 매개변수 최적화
  • 모범 사례 문서 생성
  • 템플릿 효과 순위표

환경 변수

REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765

ai-video-editor와의 통합

Remotion-controls-skill은 ai-video-editor의 애니메이션 소재 제작 도구로 사용됩니다:

  1. ai-video-editor의 디렉터 엔진이 애니메이션 명령 출력
  2. Remotion-controls-skill이 명령을 수신하여 투명 배경 비디오 렌더링
  3. 투명 배경 비디오가 컷편집 템플릿의 애니메이션 소재 레이어로 사용됨
  4. 사용자가 배경을 교체하면 애니메이션이 완벽하게 오버레이됨

주의 사항

  • Remotion은 Node.js 18+ 환경이 필요합니다.
  • 투명 배경 비디오는 WebM 형식을 권장합니다 (컷편집 호환성 우수).
  • 긴 비디오 렌더링 시간이 오래 걸리므로, 구간별로 렌더링 후 합성하는 것을 권장합니다.
  • 애니메이션에서 CSS 필터 사용을 피하세요 (일부 필터는 투명 배경을 지원하지 않음).

관련 스킬