Communitygithub.com

Guilhermeslvg/video-portfolio

Remotion 및 관련 패키지를 업그레이드합니다.

video-portfolio란 무엇인가요?

이 스킬은 Remotion 기반 프로젝트의 의존성 및 패키지 관리를 자동화하는 업그레이드 도구입니다. 프로젝트 매니페스트와 잠금 파일을 분석하여 패키지 매니저와 워크스페이스 구조를 식별하고, `@remotion/cli`의 로컬 가용 여부에 따라 최적의 업그레이드 경로를 선택합니다. CLI가 설치되어 있으면 `npx remotion upgrade` 명령어로 단순 업그레이드를 수행하며, 그렇지 않은 경우 수동 업그레이드 모드로 전환하여 최신 안정 버전의 Remotion과 모든 `@remotion/*` 의존성을 정확히 일치시킵니다. 또한 `@remotion/studio`의 의존성 트리를 참조하여 `zod`, `mediabunny`, `@huggingface/transformers` 같은 보조 패키지의 권장 버전을 자동으로 조정하고, 프로젝트의 잠금 파일을 갱신합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 작업 완료 후에는 변경 사항을 검토하고 `npx remotion versions` 명령어로 최종 의존성 일관성을 확인합니다. 이를 통해 개발자는 Remotion 업그레이드 과정에서 발생할 수 있는 버전 충돌이나 누락된 업데이트를 걱정하지 않고 안정적으로 프로젝트를 최신 상태로 유지할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Guilhermeslvg/video-portfolio/tree/HEAD/.agents/skills/remotion-upgrade

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

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

문서

Remotion 업그레이드

  1. 프로젝트 매니페스트와 잠금 파일을 검사하여 패키지 매니저와 워크스페이스를 식별합니다. 관련 없는 변경 사항은 보존합니다.

  2. @remotion/cli가 로컬에 설치되어 있는지 확인합니다. 설치되어 있다면 다음 명령어를 실행합니다:

    npx remotion upgrade
    

    이 명령어는 프로젝트 로컬 Remotion 스킬도 업데이트합니다. 아래 수동 업그레이드 단계는 건너뜁니다.

  3. @remotion/cli를 사용할 수 없는 경우 수동으로 업그레이드합니다:

    • npm view remotion version 명령어로 최신 안정 Remotion 버전을 확인합니다.
    • 프로젝트 전체에서 설치된 모든 remotion 및 @remotion/* 의존성을 찾아 해당 정확한 버전으로 업그레이드합니다. 의존성 섹션과 프로젝트의 워크스페이스 또는 카탈로그 규칙을 유지합니다.
    • npm view @remotion/studio@<버전> dependencies --json 명령어를 사용하여 대상 Remotion 버전의 @remotion/studio 의존성을 읽습니다. 설치된 보조 패키지(zod, mediabunny, @huggingface/transformers 등)를 해당 목록에 있는 버전과 일치시킵니다. 설치된 @mediabunny/* 패키지에는 mediabunny 버전을 사용합니다.
    • 프로젝트의 패키지 매니저를 실행하여 잠금 파일을 업데이트합니다.
  4. @remotion/cli를 사용할 수 없는 경우 설치된 Remotion 스킬을 업데이트합니다:

    npx skills update remotion-best-practices remotion-captions remotion-create remotion-docs remotion-interactivity remotion-maps remotion-markup remotion-multimedia remotion-render remotion-saas remotion-studio remotion-upgrade --yes
    
  5. 매니페스트와 잠금 파일의 차이점을 검토합니다. 모든 Remotion 패키지가 하나의 버전을 사용하고 설치된 보조 패키지가 권장 버전을 사용하는지 확인합니다. CLI를 사용할 수 있는 경우 추가 확인을 위해 npx remotion versions 명령어를 실행합니다.

Remotion 릴리스 페이지에는 변경 로그가 포함되어 있으며, 업그레이드 후 관련 변경 사항을 요약하는 데 유용할 수 있습니다.

Individual skills in this repo

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

관련 스킬