Communitygithub.com

motion-render

모션 그래픽 샷을 렌더링, 전달 및 브랜드 변경합니다 — 프리셋, 출력 버전, MG 전달(검증 + 프리즈 + 최종본 복사), MG 리브랜드(전달된 프로젝트에 브랜드 변경 적용).

motion-render란 무엇인가요?

이 스킬은 모션 그래픽 프로젝트의 렌더링, 전달 및 브랜드 변경을 자동화하는 CLI 도구입니다. 사용자는 `pnpm mg render <client>/<project>` 명령어로 개별 샷 또는 전체 프로젝트를 렌더링할 수 있으며, 변경된 픽셀만 새로운 버전으로 저장하고 변경되지 않은 샷은 건너뜁니다. `overlay`, `delivery`, `webm-alpha` 등 다양한 프리셋을 지원하며, 프리셋은 샷별, 프로젝트별, 또는 실행 시점에 설정할 수 있습니다. 전달 단계에서는 `pnpm mg deliver` 명령어로 모든 파일을 검증하고 프로젝트를 프리즈한 후 최종본을 날짜별 폴더에 복사합니다. 브랜드 변경이 필요한 경우 `pnpm mg rebrand` 명령어를 통해 미리보기와 적용이 가능하며, 프리즈된 프로젝트는 자동으로 새 브랜드에 재고정됩니다. 오류 발생 시 `pnpm mg doctor` 명령어로 문제를 진단할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ryodeushii/motion-graphics/tree/HEAD/skills/motion-render

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

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

문서

렌더링 및 전달

pnpm mg check <클라이언트>/<프로젝트>를 먼저 실행하세요. 문제가 없다고 보고될 때만 렌더링하세요.

렌더링

pnpm mg render <클라이언트>/<프로젝트>            모든 샷
pnpm mg render <클라이언트>/<프로젝트> lt-ceo     하나의 샷
pnpm mg render <클라이언트>/<프로젝트> --force    변경 사항이 없어도 다시 렌더링

출력: renders/<샷>_v<NNN>.<확장자>. 픽셀을 변경하는 각 렌더링은 다음 버전을 얻습니다. 이전 버전은 유지됩니다. renders/manifest.json은 픽셀에 영향을 미치는 모든 항목(속성, 확인된 토큰, 글꼴/로고/에셋 내용, 프리셋, 툴킷 버전, 클라이언트 템플릿 코드)의 해시를 기록합니다. 변경되지 않은 샷은 건너뜁니다.

프리셋

프리셋파일용도
overlay (기본값)알파 채널이 있는 ProRes 4444 .movResolve/Premiere/FCP에서 푸티지 위에 올릴 하단 자막, 제목
deliveryH.264 .mp4, 투명 영역은 검은색리뷰 링크, 전체 프레임 그래픽
webm-alpha알파 채널이 있는 VP9 .webm웹 플레이어; 대부분의 편집기는 WebM 알파를 무시함

샷별("preset"), 프로젝트별(project.json), 또는 실행 시(--preset) 설정할 수 있습니다.

전달

사용자가 프로젝트를 인계하거나(또는 그래픽이 최종이라고 말하면):

pnpm mg deliver <클라이언트>/<프로젝트> [샷…]

변경된 항목을 렌더링하고, 모든 파일을 검증하고(overlay/webm-alpha의 알파, 프레임 크기, fps), 프로젝트를 프리즈한 후 최종본을 deliver/<YYYY-MM-DD>/<샷>.<확장자>로 복사합니다. 검증에 실패하면 아무것도 프리즈되거나 복사되지 않습니다. 보고된 문제를 수정하고 다시 실행하세요. 사용자에게 deliver/ 폴더 경로를 알려주세요.

프리즈의 의미: 이후의 내부, 클라이언트 또는 변형 편집이 이 프로젝트의 렌더링을 변경하지 않습니다.

브랜드 변경 적용

사용자가 클라이언트 또는 변형 토큰(새로운 색상, 글꼴, 로고)을 변경한 후:

  1. 미리보기: pnpm mg rebrand <클라이언트> (또는 하나의 프로젝트의 경우 <클라이언트>/<프로젝트>). 아무것도 변경하지 않고, 프로젝트별로 현재 브랜드가 무엇을 변경할지 나열합니다. "extends": "none"인 프로젝트는 건너뜁니다.
  2. 목록을 사용자에게 보여주고 어떤 것을 업데이트할지 물어보세요: 모두, 일부 프로젝트, 또는 없음(새 작업만).
  3. 사용자가 선택한 것을 적용하세요: pnpm mg rebrand <클라이언트> --apply 또는 프로젝트별로 pnpm mg rebrand <클라이언트>/<프로젝트> --apply. 프리즈된 프로젝트는 현재 브랜드로 재고정되며, 나열된 모든 프로젝트는 새 버전으로 다시 렌더링됩니다. 이전 버전은 renders/에 남아있습니다.
  4. 새 렌더링에 대해 motion-qa를 실행하세요. 사용자가 다시 인계하는 프로젝트의 경우 pnpm mg deliver를 실행하여 deliver/를 새로 고치세요.

리브랜드를 실행하지 않는 것도 유효한 답변입니다: 프리즈된 프로젝트는 전달된 모양을 유지하고, 프리즈되지 않은 프로젝트만 다음 렌더링 시 브랜드를 따릅니다.

기타 브랜드 명령어:

  • pnpm mg diff <클라이언트>/<프로젝트>: 하나의 프로젝트가 잠금(프리즈됨) 또는 마지막 렌더링(프리즈되지 않음)과의 차이점.
  • 브랜드가 마지막 렌더링 이후 변경된 프리즈되지 않은 프로젝트의 렌더링은 변경 사항과 함께 경고를 출력합니다.
  • 프리즈된 프로젝트의 프로젝트 전용 토큰 편집: tokens.json을 편집한 후 pnpm mg rebrand <클라이언트>/<프로젝트> --apply.

실패

  • 속성, 토큰, 글꼴 또는 텍스트 너비를 명명하는 오류는 유효성 검사에서 발생합니다. 템플릿이 아닌 JSON을 수정하세요. pnpm mg check가 한 번에 모두 나열합니다.
  • 브라우저 실행, 누락된 라이브러리, 코덱 또는 경로 오류: pnpm mg doctor.

Individual skills in this repo

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

관련 스킬