Communitygithub.com

iamhuynq/video-remotion

모든 Remotion 스킬의 라우터

video-remotion란 무엇인가요?

이 스킬은 Remotion 관련 작업의 중앙 라우터 역할을 합니다. 사용자가 비디오 생성, 프로젝트 설정, React 마크업 작성, 지도, 멀티미디어 편집, 인터랙티브 기능 개선 등 다양한 요청을 할 때 적절한 하위 스킬(REFERENCE.md 파일)로 안내합니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자의 의도에 따라 미리보기(Studio 실행) 또는 렌더링을 자동으로 선택합니다. 특히 사용자 변경 사항을 보존하고, 명시적인 요청이 없으면 비디오를 렌더링하지 않고 대화형 미리보기를 우선 제공하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/iamhuynq/video-remotion/tree/HEAD/.agents/skills/remotion-best-practices

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

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

문서

사용자 변경 사항 유지

사용자는 대화 외부의 코드에서 편집을 할 수 있습니다.

그 사이에 예상치 못한 변경이 감지되면 덮어쓰지 말고, 의도적인 변경으로 간주하거나 확인을 요청하세요.

비디오 생성

사용자가 새 비디오나 컴포지션을 만들거나 생성하거나 제작하도록 요청하면, Remotion 프로젝트가 이미 존재하는지 여부와 관계없이 새 Remotion 비디오 만들기를 로드하세요.

새 프로젝트 설정

현재 Remotion 프로젝트가 존재하지 않으면 새 Remotion 프로젝트 만들기를 로드하세요.

React 마크업 모범 사례

Remotion React 마크업을 작성 중이라면 Remotion 마크업 모범 사례를 로드하세요.

지도

정적 지도, 애니메이션 경로 및 마커, 지리적 설명, Mapbox, MapLibre, MapTiler, GeoJSON 또는 3D 지리적 플라이오버의 경우 Remotion 지도를 로드하세요.

멀티미디어

브라우저에서 비디오 트리밍, 자르기, 메타데이터 가져오기 등 멀티미디어 작업을 수행하려면 Remotion 멀티미디어를 로드하세요.

인터랙티브성 향상

Remotion 마크업을 잘 구조화하면 사용자가 스튜디오에서 항목을 대화형으로 변경하고 코드에 다시 쓸 수 있습니다. 관련된 경우: 인터랙티브 모범 사례

미리보기 열기

사용자가 비디오를 "만들거나", "생성"하라고 요청한 경우 등. 매우 명시적이지 않은 한 기본적으로 비디오를 렌더링하지 마세요. 대신 대화형 미리보기를 보여주고 싶어 합니다. 프로젝트를 실행할 수 있게 되면, 컴포지션을 빌드하거나 편집하기 전에 Studio를 시작하고 브라우저에서 미리보기를 엽니다. 작업하는 동안 미리보기를 열어두어 사용자가 진행 상황을 보고 방향을 정할 수 있게 하세요.

Cursor를 사용하는 경우

--no-open 없이 Studio를 실행하여 브라우저가 자동으로 열리게 하세요:

npx remotion studio

앱 내 브라우저가 있는 다른 에이전트 클라이언트를 사용하는 경우

위 명령어를 사용하여 Studio가 브라우저를 열게 하거나 다음을 실행할 수 있습니다:

npx remotion studio --no-open

이 명령은 장기 실행 프로세스를 시작하고 미리보기 서버 URL을 출력합니다. 서버가 이미 시작된 경우 URL을 출력합니다. --no-open을 사용하는 경우, 출력된 정확한 URL을 앱 내 브라우저에서 열고 Studio가 로드되는지 확인하세요. 컴포지션이 존재하면 해당 비디오 미리보기가 로드되는지 확인하세요. 앱 내 브라우저에서 열 수 없으면 --no-open 없이 Studio를 실행하세요.

특정 컴포지션은 /[composition-id]로 이동하여 볼 수 있습니다. 예: http://localhost:3000/MapAnimation

:::note Studio는 WebMCP 도구를 지원합니다. :::

앱 내 브라우저가 없는 경우

이 명령은 Studio를 브라우저에서 열거나 이미 열려 있으면 포커스를 다시 맞춥니다.

npx remotion studio

추가 옵션

Remotion Studio에서 프로젝트를 실행하거나, 정확한 로컬 URL을 열거나, Studio CLI 플래그를 구성하려면 Remotion Studio를 로드하세요.

비디오 렌더링

사용자가 매우 명시적으로 요청할 때만 렌더링하세요. 예: "비디오 렌더링", "내보내기", "MP4 파일 줘".

미리보기에는 더 직관적인 렌더링 인터페이스도 있으므로, 렌더링 시 명령줄 대신 미리보기를 사용하는 것을 고려하세요.

npx remotion render

더 많은 옵션은 렌더링을 참조하세요.

단순한 npx remotion render를 넘어서는 고급 렌더링은 렌더링 모범 사례를 참조하세요.

자막

자막 작업 시 Remotion 자막을 로드하세요.

SaaS, 자동화 또는 애플리케이션 만들기

Remotion 기반 SaaS 앱(예: <Player>, Lambda, Vercel, Cloudflare에서의 렌더링, Express.js를 통한 렌더링, 클라이언트 측 렌더링 또는 적절한 SaaS 템플릿 찾기)에 대한 지식은 Remotion SaaS 스킬을 사용하세요.

Remotion API 및 문서 조회

최신 Remotion 문서를 찾고 읽으려면 Remotion 문서를 로드하세요.

업그레이드

Remotion, 관련 패키지, 호환되는 Mediabunny 패키지 및 설치된 Remotion 에이전트 스킬을 업그레이드하려면 Remotion 업그레이드를 로드하세요.

Individual skills in this repo

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

관련 스킬