Communitygithub.com

Remotion 비디오 툴킷

React와 Remotion을 사용하여 프로그래매틱하게 비디오를 제작합니다. 사용자가 코드로 비디오를 만들거나, 개인화된 비디오를 생성하거나, 애니메이션 데이터 시각화를 구축하거나, TikTok 스타일의 캡션을 추가하거나, 프로그래매틱하게 비디오를 렌더링하거나, 자동화된 비디오 제작을 요청할 때 사용합니다. CLI 렌더링, AWS Lambda, Google Cloud Run 배포를 지원합니다.

Remotion 비디오 툴킷란 무엇인가요?

Remotion 비디오 툴킷은 React와 Remotion을 사용하여 프로그래매틱하게 비디오를 생성할 수 있는 AI 에이전트 스킬입니다. 이 스킬은 반응형 비디오 템플릿을 React 컴포넌트로 제작하고, CLI 또는 클라우드 인프라를 통해 MP4/WebM으로 렌더링하며, 대규모 개인화된 비디오를 생성하는 데 특화되어 있습니다. 소셜 미디어 콘텐츠 자동화, 애니메이션 데이터 시각화, 동적 비디오 제작 파이프라인 등에 이상적입니다. 사용자는 Remotion 프로젝트 설정, 비디오 컴포지션 생성, TikTok 스타일의 애니메이션 캡션 추가, 로컬 또는 클라우드에서 비디오 렌더링, 애니메이션 데이터 시각화 등 다섯 가지 주요 작업을 수행할 수 있습니다. 각 작업은 상세한 코드 예제와 함께 제공되어 사용자가 즉시 시작할 수 있도록 돕습니다. 이 스킬은 Claude Code, Cursor와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 제공된 SKILL.md 문서를 기반으로 명확한 지침과 예제를 제공합니다. AWS Lambda와 Google Cloud Run을 통한 배치 렌더링도 지원하여 확장 가능한 비디오 제작 솔루션을 제공합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/TerminalSkills/skills/tree/HEAD/skills/remotion-video-toolkit

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

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

문서

Remotion 비디오 툴킷은(는) 무엇을 하나요?

개요

React와 Remotion을 사용하여 프로그래매틱하게 비디오를 생성하세요. 비디오 템플릿을 React 컴포넌트로 제작하고, CLI 또는 클라우드 인프라를 통해 MP4/WebM으로 렌더링하며, 대규모 개인화된 비디오를 생성할 수 있습니다. 소셜 미디어 콘텐츠 자동화, 애니메이션 데이터 시각화, 동적 비디오 제작 파이프라인에 이상적입니다.

지침

사용자가 프로그래매틱 비디오 생성을 요청하면 작업을 결정하세요:

작업 A: Remotion 프로젝트 설정

# 새 Remotion 프로젝트 생성
npx create-video@latest my-video
cd my-video
npm start  # http://localhost:3000에서 Remotion Studio 열기

프로젝트 구조:

my-video/
  src/
    Root.tsx          # 모든 컴포지션 등록
    MyComposition.tsx # 비디오 컴포넌트
  remotion.config.ts  # 렌더링 설정

작업 B: 비디오 컴포지션 생성

모든 Remotion 비디오는 useCurrentFrame()과 useVideoConfig()를 사용하는 React 컴포넌트입니다:

import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, spring } from "remotion";

interface MyVideoProps {
  title: string;
  subtitle: string;
  bgColor: string;
}

export const MyVideo: React.FC<MyVideoProps> = ({ title, subtitle, bgColor }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  // 제목 슬라이드 인 애니메이션
  const titleY = spring({ frame, fps, from: -100, to: 0, durationInFrames: 30 });

  // 20 프레임 후 서브타이틀 페이드 인
  const subtitleOpacity = interpolate(frame, [20, 40], [0, 1], {
    extrapolateRight: "clamp",
  });

  return (
    <AbsoluteFill style={{ backgroundColor: bgColor, justifyContent: "center", alignItems: "center" }}>
      <h1 style={{ fontSize: 80, color: "white", transform: `translateY(${titleY}px)` }}>
        {title}
      </h1>
      <p style={{ fontSize: 36, color: "rgba(255,255,255,0.8)", opacity: subtitleOpacity }}>
        {subtitle}
      </p>
    </AbsoluteFill>
  );
};

Root.tsx에 컴포지션을 등록하세요:

import { Composition } from "remotion";
import { MyVideo } from "./MyVideo";

export const RemotionRoot: React.FC = () => {
  return (
    <Composition
      id="MyVideo"
      component={MyVideo}
      durationInFrames={150}
      fps={30}
      width={1920}
      height={1080}
      defaultProps={{ title: "Hello World", subtitle: "Made with Remotion", bgColor: "#1a1a2e" }}
    />
  );
};

작업 C: TikTok 스타일 애니메이션 캡션 추가

import { AbsoluteFill, useCurrentFrame, Sequence } from "remotion";

interface CaptionWord {
  text: string;
  startFrame: number;
  durationInFrames: number;
}

const captions: CaptionWord[] = [
  { text: "This", startFrame: 0, durationInFrames: 15 },
  { text: "is", startFrame: 15, durationInFrames: 10 },
  { text: "amazing!", startFrame: 25, durationInFrames: 20 },
];

export const CaptionOverlay: React.FC = () => {
  const frame = useCurrentFrame();

  const activeWord = captions.find(
    (c) => frame >= c.startFrame && frame < c.startFrame + c.durationInFrames
  );

  return (
    <AbsoluteFill style={{ justifyContent: "flex-end", alignItems: "center", paddingBottom: 120 }}>
      {activeWord && (
        <div style={{
          fontSize: 64,
          fontWeight: "bold",
          color: "white",
          textShadow: "2px 2px 8px rgba(0,0,0,0.8)",
          backgroundColor: "rgba(0,0,0,0.5)",
          padding: "8px 24px",
          borderRadius: 12,
        }}>
          {activeWord.text}
        </div>
      )}
    </AbsoluteFill>
  );
};

작업 D: 비디오 렌더링

# 로컬에서 CLI로 렌더링
npx remotion render MyVideo out/video.mp4

# 사용자 정의 props로 렌더링
npx remotion render MyVideo out/video.mp4 --props='{"title":"Custom Title"}'

# 정지 프레임 렌더링 (썸네일용)
 npx remotion still MyVideo out/thumbnail.png --frame=45

# 특정 코덱 및 품질로 렌더링
npx remotion render MyVideo out/video.mp4 --codec=h264 --crf=18

대규모 배치 렌더링:

# AWS Lambda에서 렌더링
npx remotion lambda render MyVideo --props='{"title":"Video 1"}'

# Google Cloud Run에서 렌더링
npx remotion cloudrun render MyVideo --props='{"title":"Video 1"}'

작업 E: 애니메이션 데이터 시각화

import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";

interface DataPoint { label: string; value: number; color: string; }

export const BarChart: React.FC<{ data: DataPoint[] }> = ({ data }) => {
  const frame = useCurrentFrame();
  const maxVal = Math.max(...data.map((d) => d.value));

  return (
    <AbsoluteFill style={{ padding: 80, justifyContent: "flex-end", backgroundColor: "#0f0f23" }}>
      <div style={{ display: "flex", alignItems: "flex-end", gap: 20, height: "70%" }}>
        {data.map((point, i) => {
          const height = interpolate(frame, [i * 10, i * 10 + 30], [0, (point.value / maxVal) * 100], {
            extrapolateLeft: "clamp",
            extrapolateRight: "clamp",
          });
          return (
            <div key={i} style={{ flex: 1, textAlign: "center" }}>
              <div style={{
                height: `${height}%`,
                backgroundColor: point.color,
                borderRadius: "8px 8px 0 0",
                transition: "height 0.3s",
              }} />
              <p style={{ color: "white", marginTop: 12, fontSize: 24 }}>{point.label}</p>
            </div>
          );
        })}
      </div>
    </AbsoluteFill>
  );
};

예제

예제 1: 개인화된 환영 비디오

사용자 요청: "각 신규 사용자에 대해 이름이 포함된 환영 비디오를 생성해 줘"

# JSON 사용자 목록에서 비디오 생성
for user in $(jq -r '.[] | @base64' users.json); do
  name=$(echo "$user" | base64 -d | jq -r '.name')
  npx remotion render WelcomeVideo "out/welcome_${name}.mp4" \
    --props="{\"userName\":\"${name}\"}"
done

예제 2: 애니메이션 판매 대시보드

사용자 요청: "분기별 지표가 애니메이션으로 표시되는 비디오를 만들어 줘"

BarChart 컴포넌트를 사용하여 분기별 데이터로 컴포지션을 만들고 다음 명령어로 렌더링:

npx remotion render SalesDashboard out/q4_report.mp4 \
  --props='{"quarter":"Q4","revenue":1250000,"growth":12.5}'

예제 3: 캡션이 있는 소셜 미디어 콘텐츠

사용자 요청: "TikTok용 비디오에 애니메이션 캡션을 추가해 줘"

CaptionOverlay를 OffthreadVideo 소스와 결합:

import { OffthreadVideo } from "remotion";
<AbsoluteFill>
  <OffthreadVideo src="https://example.com/clip.mp4" />
  <CaptionOverlay />
</AbsoluteFill>

지침

  • 모든 애니메이션에는 useCurrentFrame()과 interpolate()를 사용하고, CSS 전환은 피하세요.
  • 컴포지션을 순수하게 유지하세요: 모든 동적 데이터를 props로 전달하여 배치 렌더링을 용이하게 하세요.
  • 비디오 타임라인의 섹션을 구성하려면 <Sequence>를 사용하세요.
  • 비디오 소스의 경우 성능 향상을 위해 <Video> 대신 <OffthreadVideo>를 사용하세요.
  • 좋은 품질 대 크기 비율을 위해 crf(Constant Rate Factor)를 16-20 사이로 설정하세요.
  • Lambda 렌더링의 경우 시간 초과 문제를 피하기 위해 컴포지션을 120초 미만으로 유지하세요.
  • 조기에 레이아웃 문제를 잡기 위해 렌더링 전에 Remotion Studio에서 테스트하세요.
  • public/ 폴더의 자산을 참조하려면 staticFile()을 사용하세요.

Individual skills in this repo

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

TerminalSkills/skills

>- Run GitHub Actions locally with act. Use when a user asks to test GitHub Actions workflows locally, debug CI pipelines without pushing, or run workflows offline.

TerminalSkills/skills

>- You are an expert in AG2 (formerly AutoGen), the open-source multi-agent conversation framework. You help developers build systems where multiple AI agents collaborate through structured conversations — with tool use, human-in-the-loop, code execution, group chat orchestration, and nested conversations — for complex tasks like software development, research, and data analysis.

TerminalSkills/skills

>- Generate short-form videos with AI — script writing, text-to-speech narration, stock footage selection, subtitle generation, and video assembly. Use when: creating TikTok/YouTube Shorts/Reels content, automating video production, building content pipelines.

TerminalSkills/skills

>- Animate 3D objects and characters in Blender with Python. Use when the user wants to keyframe properties, create armatures and rigs, set up IK/FK chains, animate shape keys for facial animation, edit F-Curves, use the NLA editor to blend actions, add drivers for expression-based animation, or script any animation workflow in Blender.

TerminalSkills/skills

>- Automate motion capture and tracking workflows in Blender with Python. Use when the user wants to import BVH or FBX mocap data, retarget motion to armatures, track camera or object motion from video, solve camera motion, clean up motion capture data, or script any tracking pipeline in Blender.

TerminalSkills/skills

>- You are an expert in Bolt.new by StackBlitz, the AI-powered full-stack development environment that runs entirely in the browser. You help developers go from idea to deployed app in minutes using natural language prompts — Bolt generates complete applications with frontend, backend, database, and deployment, all running in a WebContainer without local setup.

TerminalSkills/skills

>- Assists with using Bun as an all-in-one JavaScript/TypeScript runtime, package manager, bundler, and test runner. Use when building HTTP servers, managing packages, running tests, or migrating from Node.js. Trigger words: bun, bun serve, bun install, bun test, bun build, javascript runtime, bun runtime.

TerminalSkills/skills

>- Self-host customer support with Chatwoot. Use when a user asks to set up open-source customer support, add live chat without SaaS costs, build a multi-channel inbox, or deploy a free Intercom alternative.

TerminalSkills/skills

>- You are an expert in Chi, the lightweight, idiomatic Go HTTP router built on `net/http`. You help developers build composable HTTP services using Chi's middleware stack, route groups, URL parameters, sub-routers, and context-based request scoping — providing Express-like ergonomics while staying 100% compatible with Go's standard library.

TerminalSkills/skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.

TerminalSkills/skills

>- Add live chat and customer support with Crisp. Use when a user asks to add a chat widget, implement live customer support, set up a help desk, create a knowledge base, or add a chatbot to a website.

TerminalSkills/skills

>- Assists with building custom interactive data visualizations using D3.js. Use when creating charts, graphs, maps, force layouts, or hierarchical diagrams that require fine-grained control beyond what charting libraries provide. Trigger words: d3, data visualization, chart, svg, scales, force graph, treemap, choropleth.

TerminalSkills/skills

dbt (data build tool) transforms data in your warehouse using SQL SELECT statements. Learn project setup, models, tests, documentation, incremental materializations, and integration with data warehouses like PostgreSQL, BigQuery, and Snowflake.

TerminalSkills/skills

>- You are an expert in dlt, the open-source Python library for building data pipelines. You help developers load data from any API, file, or database into warehouses and lakes using simple Python decorators — with automatic schema inference, incremental loading, and built-in data contracts. dlt is the "requests library for data pipelines.

TerminalSkills/skills

Data Version Control for ML projects. Track large datasets and models alongside Git, build reproducible ML pipelines, and run experiments with metric comparison. Works with any storage backend including S3, GCS, Azure, and local filesystems.

TerminalSkills/skills

>- You are an expert in E2B, the cloud platform for running AI-generated code in secure sandboxes. You help developers give AI agents the ability to execute code, install packages, read/write files, and run long processes in isolated cloud environments — each sandbox is a lightweight VM that boots in ~150ms with full Linux, filesystem, and networking.

TerminalSkills/skills

>- Transcode, convert, edit, and process audio and video with FFmpeg. Use when a user asks to convert video formats (webm to mp4, mkv to mp4), extract audio from video, compress video files, trim or cut clips, concatenate videos, add subtitles, create thumbnails, apply filters, change resolution or bitrate, re-encode media, create GIFs from video, add watermarks, normalize audio, stream media, or build automated media processing pipelines.

TerminalSkills/skills

>- Create advanced animations with GSAP. Use when building complex timelines, scroll-driven animations, SVG morphing, text animations, or high-performance web animations beyond CSS capabilities.

TerminalSkills/skills

>- Generate deterministic MP4 videos from HTML, CSS, media, and seekable animations using HeyGen's HyperFrames framework. Use when someone asks to "render HTML to video", "make a video with HyperFrames", "create a programmatic video", "turn an animation into MP4", "build a launch/product video from HTML", "render GSAP/Lottie/Three.js to video", or set up an agent-driven video pipeline. Covers init/preview/render/add/lint/inspect commands, data-* timing attributes, animation adapters, and the component catalog.

TerminalSkills/skills

When the user wants to perform load testing, stress testing, or performance testing of APIs and websites using k6. Also use when the user mentions "k6," "load test," "performance test," "stress test," "spike test," "soak test," "thresholds," "virtual users," or "VUs." For browser-based testing, see selenium.

관련 스킬