Communitygithub.com

pragma-sh/pragma

Pragma의 Remotion 런치 필름을 편집, 미리보기, 검증 또는 렌더링할 때 사용합니다.

pragma란 무엇인가요?

이 스킬은 Pragma 프로젝트의 README에 포함된 Remotion 기반 런치 필름을 유지보수하고 재현 가능하게 관리하는 방법을 정의합니다. 개발자는 `launch-video` 디렉토리 아래에 있는 Remotion 컴포지션 파일들을 편집하고, Studio를 통해 전체 타임라인을 검토한 후 일관된 설정으로 최종 렌더링을 수행할 수 있습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트가 README용 영상 아티팩트를 생성하거나 업데이트할 때 이 스킬을 참조하여 정확한 명령어와 파일 구조를 따르도록 합니다. 또한 사운드트랙은 결정론적으로 생성되며, 에셋 경로와 씬 지속 시간의 동기화가 중요하므로 변경 시 반드시 Studio에서 전체 재생을 확인해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pragma-sh/pragma/tree/HEAD/skills/launch-video

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

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

문서

Pragma 런치 필름 유지보수

README 런치 필름이 저장소 소유의 소스와 에셋에서 재현 가능하도록 유지합니다.

프로젝트 구조

  • launch-video/index.ts가 Remotion 루트를 등록합니다.
  • launch-video/Root.tsx가 1920x1080, 30fps의 PragmaLaunch 컴포지션을 정의합니다.
  • launch-video/PragmaLaunch.tsx가 타임라인, 씬 지속 시간 및 프레젠테이션을 소유합니다.
  • remotion.config.ts는 apps/www/public을 Remotion의 public 디렉토리로 사용합니다. 클립, 오디오 및 에이전트 마크는 해당 디렉토리에서 staticFile()로 해결하며, launch-video 아래에 에셋을 중복하지 마십시오.
  • .github/assets/pragma-launch.mp4는 렌더링된 README 아티팩트입니다.

컴포넌트를 포함하는 .tsx 파일은 PascalCase를 사용합니다. 컴포지션 ID PragmaLaunch를 루트 렌더 명령과 일치시키고, 전체 컴포지션 지속 시간을 씬 지속 시간에서 파생하여 타임라인 편집이 레지스트리를 낡은 상태로 두지 않도록 합니다.

워크플로

저장소 루트에서 명령을 실행합니다:

bun run video:studio
bun run video:typecheck
bun run video:render

Studio를 사용하여 씬, 타이밍, 타이포그래피 또는 에셋을 변경한 후 전체 타임라인을 검토하십시오. 렌더링 전에 집중된 타입체크를 실행하십시오. 렌더 명령은 추적된 README 필름을 remotion.config.ts의 코덱 및 품질 설정을 사용하여 .github/assets/pragma-launch.mp4에 기록합니다.

사운드트랙은 launch-video/generate-lofi.ts에 의해 결정론적으로 생성됩니다. 해당 생성기를 변경할 때는 bun run video:music을 실행하면 apps/www/public/media/pragma-lofi.wav가 교체됩니다. 관련 없는 비디오 편집을 위해 사운드트랙을 다시 생성하지 마십시오.

제품 녹화물은 apps/www/public/media에 있습니다. 녹화물을 교체할 때는 Studio에서 전체 재생을 확인하고 PragmaLaunch.tsx에서 해당 씬 지속 시간을 업데이트하여 너무 짧게 끝나거나 얼어붙은 꼬리가 뒤따르지 않도록 하십시오. 마지막으로 변경된 모든 소스 파일에 대해 저장소의 일반적인 형식 및 품질 검사를 실행하십시오.

관련 스킬