Communitygithub.com

muhammedadnank/Antigravity-Skills

Remotion(React 기반 비디오 제작)을 위한 모범 사례

Antigravity-Skills란 무엇인가요?

이 AI 스킬은 Agent(예: Claude Code)가 Remotion 프로젝트의 코딩 작업을 수행할 때 자주 발생하는 문제를 방지하고 올바른 구현 방향을 제시합니다. useCurrentFrame(), interpolate(), Sequence 등 Remotion의 핵심 API를 올바르게 사용하는 방법과 CSS 트랜지션 대신 Remotion의 내장 애니메이션 방식을 사용해야 하는 이유를 설명합니다. 이 스킬은 새 프로젝트 생성, 비디오 미리보기, 단일 프레임 렌더링, 자막, FFmpeg 활용, 사운드 효과, 3D 콘텐츠, Google Fonts, 애니메이션, 전환 등 다양한 영역을 포괄하며, 각 주제에 대한 상세 규칙 파일을 참조하도록 안내합니다. 이를 통해 에이전트는 Remotion의 특수한 렌더링 환경에 적합한, 맥락에 맞는 코드를 생성할 수 있습니다.

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

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

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

미리보기

스킬 README에서

문서

사용 시기

Remotion 코드를 다룰 때마다 이 스킬을 사용하여 도메인별 지식을 얻으세요.

새 프로젝트 설정

비어 있는 폴더나 기존 Remotion 프로젝트가 없는 워크스페이스에서 다음 명령어로 새 프로젝트를 스캐폴딩하세요:

npx create-video@latest --yes --blank --no-tailwind my-video

my-video를 적절한 프로젝트 이름으로 바꾸세요.

비디오 디자인

useCurrentFrame()과 interpolate()를 사용하여 속성을 애니메이션합니다. Easing을 사용하여 애니메이션의 타이밍을 커스터마이즈하세요.

import { useCurrentFrame, Easing } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

CSS 트랜지션이나 애니메이션은 금지입니다. 제대로 렌더링되지 않습니다. Tailwind 애니메이션 클래스 이름은 금지입니다. 제대로 렌더링되지 않습니다.

에셋은 프로젝트 루트의 public/ 폴더에 배치하세요.

staticFile()을 사용하여 public/ 폴더의 파일을 참조하세요.

<Img> 컴포넌트를 사용하여 이미지를 추가하세요:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

<Video> 컴포넌트를 사용하여 비디오를 추가하세요 (@remotion/media에서 가져옴):

import { Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

<Audio> 컴포넌트를 사용하여 오디오를 추가하세요 (@remotion/media에서 가져옴):

import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

에셋은 원격 URL로도 참조할 수 있습니다:

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

콘텐츠를 지연시키려면 <Sequence>로 감싸고 from을 사용하세요. 요소의 지속 시간을 제한하려면 <Sequence>의 durationInFrames를 사용하세요. <Sequence>는 기본적으로 절대 위치 전체 채움입니다. 인라인 콘텐츠의 경우 layout="none"을 사용하세요.

import { Sequence } from "remotion";

export const Title = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

비디오의 너비, 높이, fps, 지속 시간은 src/Root.tsx에서 정의합니다:

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

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

메타데이터는 동적으로 계산될 수도 있습니다:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

미리보기 시작

비디오를 미리 보려면 Remotion Studio를 시작하세요:

npx remotion studio

선택 사항: 단일 프레임 렌더링 확인

CLI로 단일 프레임을 렌더링하여 레이아웃, 색상 또는 타이밍을 점검할 수 있습니다. 단순한 수정, 순수 리팩터링, 또는 Studio나 이전 렌더링에서 이미 충분히 확인한 경우에는 건너뛰세요.

npx remotion still [composition-id] --scale=0.25 --frame=30

30fps에서 --frame=30은 1초 지점입니다 (--frame은 0부터 시작).

자막

자막이나 캡션을 다룰 때는 ./rules/subtitles.md 파일을 불러와 더 많은 정보를 확인하세요.

FFmpeg 사용

비디오 자르기나 무음 감지와 같은 일부 비디오 작업에는 FFmpeg를 사용해야 합니다. ./rules/ffmpeg.md 파일을 불러와 더 많은 정보를 확인하세요.

무음 감지

비디오 또는 오디오 파일에서 무음 구간을 감지하고 잘라야 할 때는 ./rules/silence-detection.md 파일을 불러오세요.

오디오 시각화

오디오를 시각화(스펙트럼 막대, 파형, 저음 반응 효과)해야 할 때는 ./rules/audio-visualization.md 파일을 불러와 더 많은 정보를 확인하세요.

음향 효과

음향 효과를 사용해야 할 때는 ./rules/sfx.md 파일을 불러와 더 많은 정보를 확인하세요.

3D 콘텐츠

Remotion에서 Three.js와 React Three Fiber를 사용한 3D 콘텐츠는 rules/3d.md를 참조하세요.

고급 오디오

트리밍, 볼륨, 속도, 피치와 같은 고급 오디오 기능은 rules/audio.md를 참조하세요.

동적 지속 시간, 크기 및 데이터

컴포지션의 지속 시간, 크기 및 props를 동적으로 설정하려면 rules/calculate-metadata.md를 참조하세요.

고급 컴포지션

스틸, 폴더, 기본 props 정의 및 컴포지션 중첩 방법은 rules/compositions.md를 참조하세요.

Google Fonts

Remotion에서 글꼴을 불러오는 권장 방법입니다. Google Fonts를 불러오는 방법은 rules/google-fonts.md를 참조하세요.

로컬 폰트

로컬 폰트를 불러오는 방법은 rules/local-fonts.md를 참조하세요.

오디오 길이 가져오기

Mediabunny를 사용하여 오디오 파일의 길이(초)를 가져오는 방법은 rules/get-audio-duration.md를 참조하세요.

비디오 크기 가져오기

Mediabunny를 사용하여 비디오 파일의 너비와 높이를 가져오는 방법은 rules/get-video-dimensions.md를 참조하세요.

비디오 길이 가져오기

Mediabunny를 사용하여 비디오 파일의 길이(초)를 가져오는 방법은 rules/get-video-duration.md를 참조하세요.

GIF

Remotion 타임라인과 동기화된 GIF를 표시하는 방법은 rules/gifs.md를 참조하세요.

고급 이미지

이미지 크기 및 위치 조정, 동적 이미지 경로, 이미지 크기 가져오기 등은 rules/images.md를 참조하세요.

Light Leak

@remotion/light-leaks를 사용한 Light Leak 오버레이 효과는 rules/light-leaks.md를 참조하세요.

Lottie 애니메이션

Remotion에 Lottie 애니메이션을 삽입하는 방법은 rules/lottie.md를 참조하세요.

Canvas에서 HTML

<HtmlInCanvas>를 통해 2D 또는 WebGL 효과를 적용하기 위해 HTML을 <canvas>에 렌더링해야 할 경우 rules/html-in-canvas.md를 참조하세요.

DOM 노드 측정

Remotion에서 DOM 요소의 크기를 측정하는 방법은 rules/measuring-dom-nodes.md를 참조하세요.

텍스트 측정

텍스트 크기 측정, 컨테이너에 텍스트 맞추기, 오버플로우 확인 방법은 rules/measuring-text.md를 참조하세요.

고급 시퀀싱

지연, 자르기, 항목 지속 시간 제한 등 더 많은 시퀀싱 패턴은 rules/sequencing.md를 참조하세요.

TailwindCSS

Remotion에서 TailwindCSS를 사용하는 방법은 rules/tailwind.md를 참조하세요.

텍스트 애니메이션

타이포그래피 및 텍스트 애니메이션 패턴은 rules/text-animations.md를 참조하세요.

고급 타이밍

interpolate와 베지어 이징, 스프링을 사용한 고급 타이밍은 rules/timing.md를 참조하세요.

전환

장면 전환 패턴은 rules/transitions.md를 참조하세요.

투명 비디오

투명도가 있는 비디오를 렌더링하는 방법은 rules/transparent-videos.md를 참조하세요.

트리밍

애니메이션의 시작이나 끝을 자르는 트리밍 패턴은 rules/trimming.md를 참조하세요.

고급 비디오

트리밍, 볼륨, 속도, 루핑, 피치 등 비디오 삽입에 대한 고급 지식은 rules/videos.md를 참조하세요.

매개변수화된 비디오

Zod 스키마를 추가하여 컴포지션을 매개변수화하는 방법은 rules/parameters.md를 참조하세요.

지도

이동이 거의 없는 단순한 지도는 정적 지도 이미지를 사용하는 것을 고려하세요. 애니메이션 경로나 비행 경로가 있는 복잡한 지도의 경우 지도 규칙을 불러오세요: rules/maplibre.md

음성 해설

ElevenLabs TTS를 사용하여 Remotion 컴포지션에 AI 생성 음성 해설을 추가하는 방법은 rules/voiceover.md를 참조하세요.

Individual skills in this repo

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

muhammedadnank/Antigravity-Skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language and any subject. The signature effect is mouse-driven video scrubbing \u2014 the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing -> joy -> nostalgia -> contemplation -> action). Do NOT use for parallax frame-scrub landings where the page itself doesn't scroll (use parallax-landing-page instead) or for video editing / captioning workflows (use video-edit).

muhammedadnank/Antigravity-Skills

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

muhammedadnank/Antigravity-Skills

Build a scroll-driven cinematic landing page from a short video. The user provides a 5–15 second video (often AI-generated); this skill extracts every frame at HD JPEG quality, then produces a single-hero HTML page where the user's scroll gesture scrubs the frames in place (the page itself never scrolls) and 5 dramatic text overlays crossfade in/out — Google Anton headlines, Caveat handwritten accents, locked body, virtual scroll. Use this skill whenever the user wants to "turn this video into a landing page", "make a scroll-scrub landing page", "build a parallax hero from this clip", "add a new landing page to the parasites showcase", "do the same as github/lion/hope for this new video", or any variant that pairs a short clip with dramatic scroll-triggered storytelling. Trigger even if the user only says "use my video for a landing page" — that is this skill.

muhammedadnank/Antigravity-Skills

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

muhammedadnank/Antigravity-Skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

관련 스킬