Communitygithub.com

atlantis-mk/three-dimensional-remotion-template

재사용 가능한 3D 미니어처 상업용 Remotion 템플릿으로, 주제에 따라 비디오와 세 가지 표지를 제작, 수정, 미리보기, 렌더링합니다. 템플릿 제작 도구 유지보수에도 사용되며, 유지보수 시에는 비디오 작업을 시작하지 않습니다.

three-dimensional-remotion-template란 무엇인가요?

이 스킬은 3D 미니어처 스타일의 상업용 Remotion 템플릿을 기반으로 주기별 비디오를 제작하고 관리하는 AI 에이전트 워크플로우입니다. 에이전트는 프로젝트 루트 디렉터리에서 시작하여 README, 규칙 파일, 스킬 문서(references/template.md) 및 기존 work/task.json을 읽어 현재 작업 상태를 파악합니다. 새 비디오 제작 시에는 assets/의 템플릿과 참고 자료, references/의 기술 사양, scripts/의 도구를 활용하며, work/ 디렉터리를 생성하여 작업 공간을 분리합니다. 제작 프로세스는 자재 확인, task-state.md 기반 파라미터 기록, remotion.md를 통한 환경 설정 및 의존성 설치, 장면 및 콘텐츠 수정, 미리보기, 렌더링, 검증의 단계로 구성됩니다. 에이전트는 다양한 종료 코드(0 성공, 2 사용법 오류, 3 환경 누락, 5 파라미터 오류, 7 실행/검증 실패)를 통해 결과를 보고하며, 자동으로 작업을 '완료'로 표시하지 않습니다. 이 스킬은 Claude Code, Cursor, Codex 등 Markdown 기반 지시를 따르는 AI 코딩 에이전트에 적합하며, 일관된 비디오 제작 워크플로우를 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atlantis-mk/three-dimensional-remotion-template/tree/HEAD/.agents/skills/make-video

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

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

문서

템플릿으로 금주 비디오 제작하기

진입점 및 책임

루트 규칙, README 및 이 스킬이 포함된 프로젝트 루트 디렉터리를 찾습니다. 처음에는 work/가 존재하지 않아도 됩니다. 먼저 루트 규칙, README, 이 스킬의 references/template.md 및 기존 work/task.json을 읽습니다. 작업 공간이 없으면 새 제작으로 처리합니다. 현재 실제 엔지니어링 및 참고 자료가 있으므로 템플릿을 다시 요청하지 않습니다. 필수 질문, 단계 및 기본 전달 사항은 루트 AGENTS.md를 따릅니다.

엔지니어링 템플릿과 참고 자료는 스킬과 함께 assets/에, 기술 사양은 references/에, 실행 도구는 scripts/에 통합되어 있습니다. 루트 디렉터리에는 이 패키지 규칙이 유지되며, 각 비디오 작업 공간은 제작 시작 시 생성됩니다. 현재는 전체 템플릿 패키지로 사용됩니다. 기존 작업이 있으면 실제 파일을 확인하고 변경 사항을 보존합니다. 유지보수 모드에서는 금주 엔지니어링을 초기화하지 않고, 자재를 요청하지 않으며, 금주 상태를 진행하지 않습니다.

제작 프로세스

  1. 자재 및 요구 사항, 참조 화면 및 관련 소스 코드를 확인합니다. 결과에 영향을 미치는 필수 정보를 한 번에 수집합니다. 주제와 방향이 이미 명확하면 단계별 확인 없이 연속적으로 진행합니다.
  2. references/task-state.md를 읽고 실제 파라미터, 자재 사용 용도, 장면 구성 및 타임라인을 기록합니다. 내레이션, 이미지, 비디오가 모두 필요하지 않으며, 불필요하게 새로운 해설이나 음악을 추가하지 않습니다.
  3. references/remotion.md을 읽고 pipeline.py env를 사용하여 환경을 확인합니다. 처음 실행 시 init --install을 실행하여 작업 공간과 빈 작업 상태를 생성하고, 베이스라인을 복사하며, 종속성을 잠금 설치하고, 완전한 content.json을 내보냅니다. 기존 엔지니어링이 있으면 계속 적응시키고 덮어쓰거나 재구축하지 않습니다.
  4. 금주 파라미터와 장면을 수정합니다. 소재를 변경할 때는 Scenes.tsx와 Visuals.tsx의 모델 소품을 확인합니다. 간판을 교체하는 것이 소재 전환을 의미하지는 않습니다. 이미지와 비디오를 표시해야 하는 경우 금주 코드에 통합합니다.
  5. 내레이션이 있으면 길이를 측정하고 의미에 따라 장면, 자막, 지표 및 음향 효과를 재배치합니다. 스크립트는 TTS, 전사 또는 자동 정렬을 제공하지 않습니다. 자체 내레이션이 있는 경우 내레이션 서비스 키를 확인하지 않습니다. 스키마나 총 길이 업데이트는 오디오-비디오 정렬로 간주되지 않습니다.
  6. content.cover의 텍스트와 장면을 설정합니다. 세 가지 표지 유형은 이미 독립적인 레이아웃을 가지고 있으므로 매번 진입점을 재구축할 필요가 없습니다. 각각 주체, 제목 및 경계를 확인합니다.
  7. validate를 사용하여 파라미터, 시간 관계 및 사운드 파일을 확인하고, check를 사용하여 유형 및 실제 합성을 확인하며, preview를 사용하여 키프레임 및 지정된 구간의 사운드 미리보기를 생성합니다. 실제로 보고 들은 후 수정합니다.
  8. render를 사용하여 금주 실제 전달 목록을 출력하고, verify를 사용하여 미디어 정보와 이번 렌더링 기록을 디코딩하고 확인합니다. 기술 통과 후에도 루트 규칙의 시청각 승인을 완료한 다음 상태와 전달 사항을 업데이트해야 합니다.

스크립트의 마지막 줄은 JSON을 출력합니다. 종료 코드 0은 성공, 2는 사용법 오류, 3은 환경 누락, 5는 파라미터 오류, 7은 실행 또는 검증 실패를 나타냅니다. 보고서 로그를 먼저 읽고 수정하며, 누적 검사 횟수 제한을 설정하지 않습니다. 스크립트는 자동으로 작업을 completed로 표시하지 않습니다.

필요 시 참조

  • 실제 템플릿 스타일, 파라미터 및 검증 범위: references/template.md. 엔지니어링 기준은 assets/project-template/에, 참조 키프레임은 assets/reference/에 있습니다.

  • 초기화, 파라미터, 자재, 미리보기, 렌더링 및 기술 검사: references/remotion.md.

  • 작업 복구, 단계 진행 및 승인 기록: references/task-state.md.

  • README 기계 판독 메타데이터 수정: references/readme-format.md.

  • 모듈 및 유지보수 검증: 루트 디렉터리 docs/architecture.md. tests/의 증거는 금주 전달 사항에 포함되지 않습니다.

관련 스킬