Communitygithub.com

motion

모션 그래픽 워크스페이스(mg.json)의 진입점입니다. 하단 자막, 제목, 애니메이션 텍스트, 브랜드 변경, 렌더링 등을 처리하며, 먼저 읽은 후 다른 motion-* 스킬로 라우팅합니다.

motion란 무엇인가요?

이 스킬은 Remotion 기반의 모션 그래픽 워크스페이스를 정의합니다. `mg` CLI를 통해 반복 가능한 모션 그래픽을 렌더링하며, 모든 디자인은 코드 템플릿으로 관리되고 작업별 값은 JSON에 저장됩니다. 텍스트, 색상 또는 폰트 변경은 JSON 편집 후 `pnpm mg render`만 실행하면 되며, 코드 변경이 필요 없습니다. 이 워크스페이스는 house 토큰, 클라이언트 토큰, 변형(variant) 및 프로젝트 토큰의 계층적 체인을 사용하여 디자인 속성을 오버라이드하며, 각 값은 가장 구체적인 계층이 우선 적용됩니다. 주요 명령어로는 템플릿 목록 조회, 새 클라이언트/프로젝트/샷 생성, 체크, 렌더링, 스틸 이미지 미리보기, 스튜디오 라이브 프리뷰, 딜리버리, 리브랜드 등이 있습니다. 모든 시각적 값은 샷 props 또는 토큰에서 와야 하며, 프로젝트는 데이터만 저장하고 코드는 저장하지 않습니다. 이 스킬은 복잡한 모션 그래픽 작업을 체계적이고 재사용 가능하게 관리하는 강력한 프레임워크를 제공합니다.

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

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

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

문서

Motion 워크스페이스

이 워크스페이스는 mg CLI(pnpm mg <command>)를 통해 Remotion으로 반복 가능한 모션 그래픽을 렌더링합니다. 디자인은 코드 템플릿으로 이루어지며, 모든 작업별 값은 JSON에 저장됩니다. 텍스트, 색상 또는 폰트 변경은 JSON 편집 후 pnpm mg render만 실행하면 되며, 코드 변경이 필요 없습니다.

레이아웃

mg.json                         워크스페이스 비디오 기본값(fps, 크기)
brand/house.tokens.json         하우스 토큰: 기본 색상, 폰트, 이징, 지속 시간, 안전 영역
brand/fonts/  brand/logos/      하우스 토큰이 참조하는 파일들
clients/<client>/
  client.json                   표시 이름, 선택적 비디오 오버라이드
  brand/tokens.json             클라이언트 오버라이드(하우스 위에 딥 병합)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     여러 프로젝트에서 재사용하는 명명된 대체 룩: tokens.json, fonts/, logos/
  templates/<name>/index.tsx    클라이언트 전용 템플릿, id "<client>/<name>"
  projects/<project>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 프로젝트 전용 오버라이드(선택사항)
    tokens.lock.json            고정 시 존재: 렌더링이 라이브 체인 무시
    fonts/ logos/ assets/       프로젝트 파일; props는 "asset:<경로>"로 자산 참조
    shots/<shot>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    출력물, git 무시; manifest.json이 버전 추적

툴킷 코드(엔진, 하우스 템플릿, 이 스킬들)는 node_modules/motion-toolkit에 있으며, package.json에 의해 고정됩니다. 절대 그곳에서 편집하지 마세요. 하우스 템플릿 변경은 툴킷 저장소로 가야 합니다.

하우스 템플릿

모든 하우스 템플릿에는 look prop이 있습니다: minimal(깔끔함, 가벼운 두께, 블러-라이즈, 패널 없음), bold(굵은 대문자, 단색 블록, 스프링 팝), corporate(패널, 악센트 바, 마스크 리빌). 기본값 "brand"는 look 토큰을 사용하므로, 클라이언트는 brand/tokens.json에서 한 번만 스타일을 설정하면 됩니다("look": "minimal").

Id용도
lower-third이름 및 직책 스트랩, 선택적 로고
title-card챕터 또는 섹션 제목, 선택적 킥커 및 부제목; 오버레이 또는 전체 프레임
callout영상의 한 지점(x, y: 프레임 비율)에서 레이블로 이어지는 선
end-card종료 카드: 로고, 헤드라인, CTA, URL, 0~2개의 YouTube 엔드스크린 슬롯
kinetic-text인용구 또는 문장이 단어별로 나타남; *단어*는 강조
logo-sting짧은 애니메이션 로고 리빌(인트로/아웃트로)
counter숫자 카운트업(value, prefix, suffix, decimals)과 레이블
social-handle플랫폼 아이콘 + @핸들을 모서리에 표시(YouTube, Instagram, TikTok, X, LinkedIn 등)
typewriter텍스트가 키별로 타이핑되며 렌더링 오디오에 타자기 또는 키보드 사운드 포함
corner-branding모든 모서리에 지속적인 로고 버그, 선택적 태그(LIVE 등)

pnpm mg new-shot … --template <id>는 모든 prop을 기본값으로 작성합니다. 각 prop의 의미는 node_modules/motion-toolkit/templates/<id>/index.tsx의 .describe() 텍스트에 있습니다.

토큰 체인

toolkit → house → client → variant (project.json "brand"인 경우) → project tokens.json → shot props. 툴킷 계층은 기본값만 제공합니다(look, mono 폰트, 타이핑 sounds). 객체는 키별로 병합되고, null은 상속된 키를 삭제하며, 가장 구체적인 계층이 우선합니다. "extends": "none"은 클라이언트와 변형을 건너뜁니다. 폰트, 로고 및 사운드 파일은 해당 파일을 가진 가장 구체적인 계층의 fonts/, logos/ 또는 sounds/ 폴더에서 찾습니다.

규칙

  1. 모든 시각적 값은 샷 props 또는 토큰에서 와야 합니다. 하드코딩된 색상, 폰트, px 단위 크기(prop 없음) 또는 타이밍이 템플릿에 없어야 합니다.
  2. 프로젝트는 데이터를 보관하고, 코드를 보관하지 않습니다. 새로운 디자인은 템플릿이고, 새로운 작업은 샷 파일이 있는 프로젝트입니다.
  3. 값을 소유한 가장 낮은 계층에 배치합니다: 하나의 샷 → 샷 props; 하나의 프로젝트 → 프로젝트 tokens.json; 클라이언트의 여러 프로젝트 → 변형; 전체 클라이언트 → 클라이언트 토큰.
  4. tokens.lock.json을 수동으로 편집하지 마세요. 전달된 프로젝트는 고정되어 있으며, mg rebrand를 통해서만 변경됩니다(motion-render 참조).
  5. 모든 JSON 또는 템플릿 편집 후, 렌더링 전에 pnpm mg check를 실행하고 보고된 문제를 수정하세요.
  6. 모든 시각적 변경은 완료 보고 전에 motion-qa 절차를 수행하세요.
  7. mg rebrand --apply 전과 고정된 프로젝트에서 사용하는 클라이언트 또는 변형 토큰을 편집하기 전에 사용자에게 질문하세요.
  8. 렌더링 또는 doctor 검사가 실패하면, 코드를 변경하기 전에 pnpm mg doctor를 실행하세요.

라우트

작업읽을 문서
새 클라이언트, 변형, 로고, 폰트, 색상 팔레트motion-brand
브리프로부터 새 프로젝트 또는 샷; 기존 샷의 텍스트/색상 변경motion-project
새 템플릿 또는 템플릿 애니메이션 방식 변경motion-template, 그 다음 motion-style
모션 느낌: 이징, 타이밍, 스태거, 안전 영역motion-style
렌더링, 프리셋, 버전, 전달, 브랜드 변경 적용motion-render
인계 전 출력 확인motion-qa

명령어

pnpm mg templates                                  템플릿 ID 목록
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <id>   모든 prop이 기본값인 샷 파일
pnpm mg new-template <client> <name>               시작 템플릿
pnpm mg check [<client> | <client>/<project>]      렌더링 없이 모든 것 검증
pnpm mg render <client>/<project> [shot…]          변경되지 않은 샷 건너뜀; --force, --preset
pnpm mg still <client>/<project> [shot…]           체커보드 위에 PNG 미리보기(기본값: 모든 샷)
pnpm mg studio <client>/<project>                  라이브 프리뷰; 스튜디오 "저장"이 샷 파일 작성
pnpm mg deliver <client>/<project>                 렌더링, 확인, 고정, 최종본을 deliver/<날짜>/로 복사
pnpm mg rebrand <client | client/project> [--apply]   전달된 작업에 대한 브랜드 변경
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor                                     환경, mg check, 스모크 렌더

Individual skills in this repo

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

관련 스킬