Communitygithub.com

Remotion 설정 (Claude Code Agent Skills)

Claude Code 에이전트 스킬과 함께 사용할 새로운 Remotion 비디오 프로젝트를 스캐폴딩합니다. Node 버전 확인, create-video 스캐폴딩, 스킬 설치, 폴더 규칙, Google Fonts 및 스모크 테스트 렌더링을 포함합니다. 누군가 Remotion과 Claude로 비디오 제작을 시작하려 할 때, 심지어 'Claude로 제품 비디오를 만들어 줘' 같은 경우에도 사용하세요.

Remotion 설정 (Claude Code Agent Skills)란 무엇인가요?

이 스킬은 Claude Code(또는 이와 유사한 터미널 기반 AI 코딩 에이전트)가 Remotion 비디오 프로젝트를 처음부터 설정할 수 있도록 설계된 단계별 워크플로우입니다. 핵심 기능은 Node.js 버전 확인, `create-video` 스캐폴딩, `remotion skills add`를 통한 Remotion 에이전트 스킬 설치, 소스 코드 및 에셋을 위한 표준 폴더 구조 생성, `@remotion/google-fonts`를 통한 Google Font 통합, 그리고 최종적으로 스모크 테스트 렌더링을 통해 전체 파이프라인이 올바르게 작동하는지 검증하는 것입니다. 이 스킬은 제품 비디오 제작에 최적화된 Blank 템플릿을 권장하며, 구성 요소가 `/src/compositions/`에, 정적 에셋이 `/public/assets/`에 저장되는 일관된 레이아웃을 적용합니다. 이후 `remotion-compose` 및 `remotion-render`와 같은 다른 스킬들이 이 구조에 의존합니다. 스모크 테스트가 `out/smoke-test.mp4` 파일을 성공적으로 생성하고 Remotion Studio가 실행될 때까지 설정이 완료된 것으로 간주하지 않으며, 이후 사용자는 Claude에게 비디오 구성을 설명하기만 하면 됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/remotion-setup

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

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

문서

Remotion 설정

새로운 Remotion 프로젝트를 스캐폴딩하고 나머지 워크플로우가 "그냥 Claude에게 프롬프트"만으로 동작하도록 연결합니다. 이는 일회성 환경 설정 작업입니다. 프로젝트당 한 번만 수행하면 되며, 이후 remotion-compose와 remotion-render는 바로 창의적인 루프로 넘어갑니다.

적극적으로 트리거하세요. 사용자가 "Claude로 비디오 만들기"와 관련된 어떤 말이라도 하면 - "Remotion 설정", "Remotion 프로젝트 생성", "Claude로 제품 비디오를 만들고 싶어", "비디오 프로젝트 시작" - 이 스킬을 실행하세요.

1단계 - 도구 체인 확인

Remotion은 헤드리스 Chromium으로 렌더링하므로 스캐폴딩 전에 Node를 확인하세요:

node --version   # >= 16 필요; 활성 LTS 릴리스 권장

Node 버전이 16보다 낮으면 중단하고 사용자에게 업그레이드하도록 안내하세요 (nvm: nvm install --lts && nvm use --lts). 또한 npx를 사용할 수 있는지 확인하세요 (npm 5.2+와 함께 제공됨).

2단계 - 프로젝트 스캐폴딩

npx create-video@latest

이 명령은 대화형입니다. Blank (Hello World) 템플릿을 추천합니다 - 제품 비디오에 가장 깔끔한 기반입니다. CLI가 프로젝트 디렉토리와 패키지 매니저를 묻습니다. 사용자가 선택하게 한 후, 새 폴더로 이동하여 설치하세요:

cd <project-name>
npm install

3단계 - Remotion Agent Skills 설치

Claude Code가 이 저장소에서 Remotion 자체 스킬 컨텍스트를 사용할 수 있도록 합니다:

npx remotion skills add remotion

이 명령은 Remotion의 에이전트 스킬 파일을 프로젝트에 넣습니다. 설치된 Remotion 버전에서 이 명령을 사용할 수 없으면 사용자에게 최신 @remotion/cli를 안내하고 계속 진행하세요 - 이는 편의 기능일 뿐 필수 종속성은 아닙니다.

4단계 - 폴더 규칙 설정

나중에 사용할 스킬이 항상 파일 위치를 알 수 있도록 레이아웃을 표준화합니다:

src/
  Root.tsx              # 모든 <Composition>을 등록 (항목 레지스트리)
  index.ts              # registerRoot(RemotionRoot)
  compositions/         # 비디오당 하나의 .tsx 파일 - remotion-compose가 여기에 작성
public/
  assets/               # 이미지, 로고, 오디오 - staticFile()을 통해 참조

템플릿이 폴더를 생성하지 않은 경우 생성하세요:

mkdir -p src/compositions public/assets

src/Root.tsx는 레지스트리입니다. 모든 비디오는 여기에 등록된 <Composition>입니다:

// src/Root.tsx
import { Composition } from "remotion";
import { HelloWorld } from "./compositions/HelloWorld";

export const RemotionRoot: React.FC = () => {
  return (
    <Composition
      id="HelloWorld"
      component={HelloWorld}
      durationInFrames={90}
      fps={30}
      width={1920}
      height={1080}
    />
  );
};
// src/index.ts
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);

합리적인 기본값으로 등록: 가로 제품 비디오의 경우 30fps 및 1920x1080 (세로 소셜 미디어의 경우 1080x1920), 짧은 지속 시간 - 30fps에서 90프레임은 3초이며 대부분의 제품 데모 비디오는 15초에서 60초 사이입니다 (450-1800프레임).

5단계 - Google Font 로드

Remotion은 Google Font를 일급으로 지원하여 텍스트가 결정적으로 렌더링됩니다. 한 번 설치하고 로드하세요:

npm install @remotion/google-fonts
// 구성 파일 상단 근처에서 로드
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// 그런 다음: <div style={{ fontFamily }}>...</div>

loadFont()는 글꼴이 준비될 때까지 렌더를 차단하므로, 화면의 텍스트가 스타일이 지정되지 않은 대체 글꼴로 깜빡이는 일이 없습니다. 브랜드에 맞는 글꼴을 선택하세요 - Inter를 Poppins, Roboto 등으로 바꾸세요.

6단계 - 스모크 테스트 구성

환경이 엔드 투 엔드로 렌더링되는지 증명하는 간단한 구성을 작성하세요:

// src/compositions/HelloWorld.tsx
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";

const { fontFamily } = loadFont();

export const HelloWorld: React.FC = () => {
  const frame = useCurrentFrame();
  const opacity = interpolate(frame, [0, 30], [0, 1], {
    extrapolateRight: "clamp",
  });
  return (
    <AbsoluteFill style={{ backgroundColor: "#0B0B0F", justifyContent: "center", alignItems: "center" }}>
      <h1 style={{ fontFamily, color: "white", fontSize: 90, opacity }}>
        작동합니다.
      </h1>
    </AbsoluteFill>
  );
};

src/Root.tsx (4단계)에 등록되었는지 확인한 후 렌더링하세요:

npx remotion render src/index.ts HelloWorld out/smoke-test.mp4

첫 번째 렌더는 헤드리스 Chromium을 다운로드합니다 (수백 MB - 일반 연결에서 처음에 몇 분 정도 기다려야 합니다); 그 후 이 90프레임 스모크 테스트는 1분 이내에 렌더링되어야 합니다. out/smoke-test.mp4가 서서히 나타나는 제목을 재생하면 환경이 올바른 것입니다. 렌더가 실패하면 거의 항상 (a) Chromium 다운로드/권한 문제, (b) Root.tsx에 구성이 등록되지 않은 경우, 또는 (c) 1단계의 Node 버전 문제입니다.

7단계 - 미리보기를 위한 Remotion Studio 실행

대화형 미리보기 (타임라인 스크러빙, 편집 시 핫 리로드):

npx remotion studio

이 명령은 Studio를 http://localhost:3000 에 제공합니다. create-video 템플릿은 npm run dev도 동일한 작업에 연결합니다. 반복 작업하는 동안 Studio를 계속 실행하세요 - 구성 파일의 편집 내용이 즉시 핫 리로드됩니다.

결과물

사용자는 작업 중인 Remotion 프로젝트를 갖게 됩니다: src/compositions/ + public/assets/ 레이아웃이 적용된 스캐폴딩된 저장소, 설치된 Remotion 에이전트 스킬, 연결된 Google Font, 등록된 스모크 테스트 구성, 실제로 재생되는 렌더링된 out/smoke-test.mp4, 그리고 미리보기용으로 실행 중인 Remotion Studio입니다. 스모크 테스트 MP4가 존재하고 재생될 때까지 아무것도 "설정된" 것이 아닙니다.

하지 말아야 할 것

  • Node 확인을 건너뛰고 그냥 스캐폴딩하지 마세요 - 16 미만의 Node는 설치 시가 아닌 Chromium 렌더 내부에서 혼란스러운 오류와 함께 실패합니다.
  • 스모크 테스트를 렌더링하지 않고 설정 완료를 선언하지 마세요; 컴파일은 되지만 MP4를 한 번도 생성하지 않은 프로젝트는 Chromium 파이프라인이 작동한다는 것을 증명하지 못했습니다.
  • 구성이나 에셋을 임시 위치에 넣지 마세요 - 이후 스킬 (remotion-compose, remotion-render)은 src/compositions/ 및 public/assets/가 존재한다고 가정합니다.
  • 에셋을 상대 경로나 URL로 참조하지 마세요. public/에서 staticFile()을 사용하세요. 그렇지 않으면 로컬에서는 작동하지만 다른 곳에서 렌더가 깨집니다.
  • 화면 텍스트에 시스템 또는 CSS 가져오기 글꼴을 사용하지 마세요 - loadFont()가 차단되지 않으면 렌더 머신에서 텍스트가 대체 글꼴로 렌더링될 수 있습니다.
  • 제품 비디오에 기능이 많은 템플릿을 선택하지 마세요. Blank 템플릿은 사용자가 나중에 삭제해야 하는 데모 코드를 피합니다.

품질 기준

  • node --version이 16 이상이며 스캐폴딩 전에 확인되었습니다.
  • out/smoke-test.mp4가 존재하고 서서히 나타나는 제목을 재생합니다.
  • 폴더 규칙이 명시된 대로 정확히 존재하며, 스모크 구성이 src/Root.tsx에 등록되었습니다.
  • 텍스트가 시스템 대체 글꼴이 아닌 @remotion/google-fonts와 loadFont()를 통해 렌더링됩니다.
  • Remotion Studio가 localhost:3000에서 실행되고 편집 내용을 핫 리로드합니다.

인계

스모크 테스트가 렌더링되고 Studio가 실행되면, 사용자에게 프로젝트가 준비되었음을 알리고 인계하세요: "설정이 완료되었습니다. 원하는 비디오 - 길이, 장면, 브랜드 색상 - 을 설명해 주시면 구성을 작성하고 (remotion-compose), 렌더링 및 반복 작업 (remotion-render)을 진행하겠습니다."

Individual skills in this repo

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

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Classifies incident severity (SEV1-4) using impact, scope, and urgency signals and decides who to page. Use when an alert fires or a report comes in and a severity call must be made quickly.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

관련 스킬