Communitygithub.com

CambridgeMonorail/WallRun

Nx 모노레포 데모 디렉토리 내에서 WallRun용 Remotion 데모 비디오를 구축하고 편집합니다.

WallRun란 무엇인가요?

이 스킬은 Nx 모노레포 환경에서 Remotion 기반 개발자 설명 비디오를 구축하고 유지 관리하는 방법을 정의합니다. 'demos/wallrun-video' 디렉토리에 위치한 이 프로젝트는 WallRun이라는 개발자 도구를 소개하는 데 사용되며, 주 시청자는 프론트엔드 개발자입니다. 스킬은 씬 생성, 컴포지션 구조, 재사용 가능한 모션 컴포넌트, 비디오 페이싱, 그리고 명확한 코드 구성을 위한 지침을 제공합니다. 비디오는 마케팅 광고처럼 느껴지지 않도록 편집적이고 미니멀하며 절제된 모션 스타일을 우선시하며, 각 씬은 하나의 아이디어만 전달하고 4~8초의 짧은 지속 시간을 가집니다. 이 스킬은 Remotion 스튜디오 미리보기, 전체 렌더링, 타입 체크를 위한 Nx 타겟을 지원하며, TypeScript와 함수형 React 컴포넌트 사용을 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CambridgeMonorail/WallRun/tree/HEAD/skills/remotion-demo-video

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

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

문서

Remotion 데모 비디오 스킬

이 스킬은 다음 위치에 있는 Remotion 비디오 데모를 구축하고 유지 관리합니다:

demos/wallrun-video

다음에 대한 구조를 제공합니다:

  • 씬 생성
  • 컴포지션 구조
  • 재사용 가능한 모션 컴포넌트
  • 비디오 페이싱
  • 개발자 대상 설명

이 스킬은 다음 작업 시 사용해야 합니다:

  • Remotion 컴포지션
  • 씬 컴포넌트
  • 애니메이션 설명 세그먼트
  • 비디오 구조 또는 시퀀싱
  • 데모에서 사용하는 모션 기본 요소

프로젝트 컨텍스트

이 저장소는 Nx 모노레포입니다.

Remotion 비디오는 다음 위치에 있습니다:

demos/wallrun-video

이 프로젝트는 WallRun에 대한 개발자 대상 설명 비디오를 렌더링합니다.

시청자는 프론트엔드 개발자이며, 마케터가 아닙니다.

시청자가 다음을 이해한다고 가정합니다:

  • React
  • TypeScript
  • 컴포넌트 아키텍처
  • 레이아웃 시스템
  • 개발자 도구

기본 JavaScript 개념을 설명하지 마십시오.


디자인 의도

비디오는 개발자 미디어처럼 느껴져야 하며, 제품 광고처럼 느껴져서는 안 됩니다.

좋은 톤:

  • 편집적
  • 미니멀
  • 현대적
  • 자신감 있는
  • 절제된 모션

나쁜 톤:

  • 일반적인 SaaS 프로모션
  • 시네마틱 트레일러 효과
  • 과도한 입자 애니메이션
  • 빽빽한 마케팅 카피

우선시해야 할 것:

  • 가독성
  • 계층 구조
  • 페이싱
  • 명확성

프로젝트 구조

모든 코드는 다음 안에 있어야 합니다:

demos/wallrun-video/src

구조:

  • components/ — 재사용 가능한 프레젠테이션 기본 요소
  • scenes/ — 비디오의 시간이 지정된 섹션
  • data/ — 스크립트, 카피, 타이밍 상수
  • Root.tsx — 컴포지션 등록
  • index.ts — Remotion CLI 진입 파일

씬 디자인 규칙

각 씬은 하나의 아이디어만 전달해야 합니다.

일반적인 지속 시간: 4–8초

씬은 다음을 충족해야 합니다:

  • 빠르게 읽힐 것
  • 큰 타이포그래피를 사용할 것
  • 혼란을 피할 것
  • 모션을 미묘하게 유지할 것

선호되는 씬 유형:

  • 타이틀 카드
  • 단계별 리포지토리 스크린샷
  • 컴포넌트 클로즈업
  • 콜아웃 오버레이
  • 아키텍처 다이어그램
  • 통계 패널

피해야 할 것:

  • 작은 UI
  • 긴 문단
  • 지나치게 복잡한 전환

애니메이션 가이드라인

단순하고 결정론적인 애니메이션을 선호하십시오.

예:

  • 페이드 인
  • 슬라이드 업
  • 지연된 나타남
  • 미묘한 스케일 변경

피해야 할 것:

  • 바운스 효과
  • 복잡한 물리 모션
  • 과도한 이징 커브

목표는 명확성이지, 스펙터클이 아닙니다.


코딩 규칙

다음을 사용하십시오:

  • React 함수형 컴포넌트
  • TypeScript
  • 명명된 내보내기
  • 명시적 타입
  • 재사용 가능한 모션 래퍼

피해야 할 것:

  • 중복된 애니메이션 코드
  • 매직 넘버
  • 하드코딩된 씬 타이밍

가능할 때 타이밍 상수를 추출하십시오.

예:

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

새 씬 생성을 위한 기본 워크플로우

  1. 씬의 메시지를 정의합니다.
  2. 프레임 단위로 지속 시간을 정의합니다.
  3. 레이아웃을 구성합니다.
  4. 기본 모션을 추가합니다.
  5. 명확성을 향상시키는 경우에만 보조 모션을 추가합니다.
  6. 가독성을 확인합니다.
  7. 코드가 재사용 가능한지 확인합니다.

Nx 타겟

  • preview — nx preview wallrun-video Remotion Studio를 엽니다.
  • render — nx render wallrun-video 전체 비디오를 dist/demos/wallrun-video/로 렌더링합니다.
  • type-check — nx type-check wallrun-video TypeScript 컴파일러를 실행합니다.

완료 조건

씬이 완료되었다는 것은 다음을 의미합니다:

  • 메시지가 즉시 명확함
  • 타이포그래피가 비디오 크기에서 읽힘
  • 애니메이션이 절제됨
  • 타이밍을 쉽게 편집할 수 있음
  • 코드가 깔끔하게 구조화됨

관련 스킬