Communitygithub.com

hiwurun/remotion-saas-boilerplate

모든 Remotion 스킬을 관리하는 라우터

remotion-saas-boilerplate란 무엇인가요?

이 스킬은 다양한 Remotion 관련 작업을 수행하기 위한 중앙 라우터 역할을 합니다. 사용자가 비디오 생성, 프로젝트 설정, React 마크업, 지도, 멀티미디어, 상호작용 개선, 미리보기 열기, 렌더링, 자막, SaaS 애플리케이션 구축, API 문서 조회, 업그레이드 등 다양한 요청을 할 때 적절한 하위 스킬 문서를 로드하여 안내합니다. 주로 Claude Code, Cursor, Codex 등의 AI 에이전트에서 사용되며, 사용자의 의도에 따라 Remotion Studio를 열어 대화형 미리보기를 제공하거나 명시적인 요청이 있을 때만 렌더링을 진행합니다. 또한 사용자가 대화 외부에서 코드를 수정한 경우 이를 덮어쓰지 않고 유지하는 지침을 포함하여 협업 효율성을 높입니다. 이 스킬은 Remotion 생태계 내에서 체계적이고 오류 없는 작업 흐름을 지원하는 것이 핵심 목적입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/hiwurun/remotion-saas-boilerplate/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에서 항목을 대화형으로 변경하고 코드에 다시 쓸 수 있습니다. 관련된 경우: 상호작용 모범 사례

미리보기 열기

사용자가 비디오를 "만들", "생성" 등을 요청한 경우. 기본적으로 사용자가 매우 명시적으로 요청하지 않는 한 비디오를 렌더링하지 마세요. 대신 대화형 미리보기를 보고 싶어합니다. 프로젝트가 실행 가능해지면 즉시 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.

관련 스킬