Communitygithub.com

MotionSnip Studio

코드로 모션 그래픽을 만들고 MotionSnip Studio 로컬 플레이어에서 리뷰하세요. 사용자가 렌더링을 시청하고, 텍스트를 제자리에 수정하고, 음악을 교체하고, 프레임 위에 문제를 동그라미 친 후 하나의 프롬프트를 보냅니다.

MotionSnip Studio란 무엇인가요?

MotionSnip Studio는 개발자가 Remotion과 같은 코드 기반 렌더러로 모션 그래픽, 런치 비디오, 설명 영상, 제품 동영상, 애니메이션 프로모션 등을 제작하고, 로컬 플레이어에서 사용자가 시각적으로 피드백을 제공할 수 있게 하는 AI 에이전트 스킬입니다. 이 스킬은 `reel.json` 파일을 중개자로 사용하여, AI가 비디오를 설명하고 사용자가 플레이어에서 편집, 텍스트 수정, 음악 교체, 프레임 내 문제 표시 등을 수행한 후 'Send to Claude' 버튼 하나로 피드백을 제공합니다. 피드백 파일은 정확한 변경 사항(텍스트, 위치, 색상, 사운드 설정), 프레임에 고정된 주석, AI의 자체 검토 결과 등을 포함하며, AI는 이를 기반으로 버전을 올려 재렌더링합니다. 주요 이점은 음악을 별도 파일로 분리하여 사용자가 재렌더링 없이도 트랙을 교체하고 볼륨을 조절할 수 있으며, 자체 검토(findings in `review`)를 통해 품질을 사전에 보강한다는 점입니다. Cursor, Claude Code, Codex 등 모든 AI 코딩 도구와 호환되며, Node.js 18 이상만 있으면 별도 설치 없이 즉시 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jishanpathan7/motionsnip-studio/tree/HEAD

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

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

문서

MotionSnip Studio은(는) 무엇을 하나요?

당신이 비디오를 만듭니다. 사용자가 로컬 플레이어에서 리뷰합니다. 루프는 다음과 같습니다:

  1. 비디오를 빌드하고 렌더링합니다.
  2. reel.json에 설명을 작성합니다.
  3. 플레이어를 엽니다.
  4. 사용자가 리뷰하고 Claude로 보내기를 클릭합니다. 그러면 한 줄을 받게 됩니다: Apply the MotionSnip Studio feedback in <abs path>.
  5. 피드백을 적용하고, 재렌더링하고, version을 올립니다. 플레이어가 자동으로 다시 로드되어 사용자가 변경 사항을 확인할 수 있도록 돕습니다.

이 파일에서 <skill dir>은 이 SKILL.md가 있는 폴더(일반적으로 ~/.claude/skills/motionsnip-studio)를 의미합니다.

1. 프로젝트 설정

비디오당 하나의 폴더를 사용하세요:

<project>/
  reel.json        당신이 작성
  video.mp4        렌더링 (이름은 자유; "reel.json"의 "src"가 이를 가리킴)
  assets/          음악, 이미지, 로고 (사용자가 업로드하는 파일도 여기에)
  public/          선택 사항; Remotion staticFile() 자산
  exports/         플레이어의 Export가 만드는 파일; 절대 편집 금지
  .motionsnip/     플레이어 상태 및 기록; 절대 편집 금지

사용자에게 렌더러가 아직 없다면 Remotion이 좋은 기본값입니다 (npx create-video@latest). mp4, webm 또는 mov를 출력하는 모든 도구가 작동합니다.

2. 수정이 저렴하도록 빌드하세요

  • 복사, 색상, 글꼴 및 타이밍을 컴포넌트 전체에 흩어 놓지 말고 하나의 데이터 객체(Remotion defaultProps 또는 content.ts)에 유지하세요. 그러면 피드백 수정이 한 줄 변경으로 끝납니다.
  • 모든 화면상 요소에 안정적인 id를 부여하고 reel.json에서 동일한 id를 사용하세요.
  • 음악을 별도 파일로 제공하세요. 효과음만 있는 비디오를 렌더링하세요. 트랙을 assets/에 넣고 audio.music이 이를 가리키게 하고, audio.videoAudio를 "effects"로 설정하세요. 플레이어는 비디오 옆에서 음악을 재생하므로, 사용자는 재렌더링 없이 트랙을 교체하고, 시작점을 이동하고, 레벨을 설정할 수 있습니다. Export는 ffmpeg로 이를 혼합합니다.
  • 사용자가 요청할 때만 비디오에 음악을 굽습니다. 그런 다음 videoAudio를 "mix"로 설정하세요.

3. 보여주기 전에 렌더링하고 확인하세요

렌더링한 후 연락처 시트로 자신의 작업을 확인하세요:

ffmpeg -v error -y -i video.mp4 -vf "fps=1,scale=480:-1,tile=4x3" -frames:v 1 /tmp/sheet.png

이미지를 열고 살펴보세요. 플레이어를 열기 전에 잘린 텍스트, 빈 프레임, 잘못된 색상 및 타이밍 간격을 수정하세요. 단일 프레임의 경우:

ffmpeg -v error -y -ss 12.4 -i video.mp4 -frames:v 1 /tmp/frame.png

자체 검토. 그런 다음 까다로운 리뷰어의 눈으로 다시 보고, 여전히 보이는 것을 적어보세요. 다음을 확인하세요:

  • 안전 영역. 각 가장자리에서 10% 안쪽에 있는 중요한 모든 것(제목 안전)?
  • 크기. 본문 텍스트는 프레임 높이의 최소 약 3% 이상이어야 하므로, 휴대폰에서 읽을 수 있습니다.
  • 대비. 텍스트와 주요 형태가 배경과 명확하게 구분되어야 합니다.
  • 오타 및 넘침. 모든 단어의 철자가 정확하고, 아무것도 잘리거나 상자 밖으로 나가지 않아야 합니다.
  • 컷과 타이밍. 컷에 플래시 프레임이 없고, 빈 프레임이 없으며, 읽을 수 있기 전에 사라지는 것이 없어야 합니다.

수정할 수 있는 것은 수정하세요. 남은 것이나 취향의 문제라면, reel.json의 review에 발견 사항을 추가하세요(섹션 4). 플레이어는 각각을 해당 프레임에 C1, C2…로 표시된 파선 파란색 링으로 그리고, 사용자는 이를 자신의 메모로 추가하거나 무시합니다. 프레임 캡처에서 실제로 본 것만 작성하세요: 시간과 위치 또는 요소를 제공하여 링이 거기에 놓이도록 하세요. 할 말이 없으면 review를 비워두세요; 채우지 마세요.

4. reel.json 작성

reel.json은 당신과 플레이어 간의 계약입니다. 일반 JSON을 작성하세요(주석 없음).

{
  "id": "acme-launch",              // 안정적; 사용자의 저장된 편집은 이 키로 연결됨
  "title": "Acme launch",
  "version": 1,                     // 렌더링할 때마다 올림; 변경되면 플레이어가 다시 로드
  "path": "/abs/path/to/project",   // 작업 디렉토리; 프롬프트에 표시됨
  "src": "video.mp4",
  "w": 1920, "h": 1080, "fps": 30, "duration": 32.0,
  "reference": "optional: what the video is modelled on",
  "brand": {
    "colors": [{ "id": "accent", "name": "Accent", "v": "#5B5BF7" }],
    "fonts":  [{ "id": "head", "name": "Headlines", "v": "Inter" }],
    "logo": "assets/logo.svg"       // 또는 null
  },
  "audio": {
    "music": "assets/track.mp3",    // 비디오 옆에서 재생됨, 또는 null
    "videoAudio": "effects",        // "effects" = 비디오에 효과음만 있음; "mix" = 음악이 굽혀짐
    "bpm": 120, "drop": 4.0,        // 선택적 비트 그리드; drop = 드롭이 위치한 초
    "musicVol": 1, "sfxVol": 1,     // 0..1
    "musicOffset": 0,               // 초; +는 음악을 늦게 시작, -는 트랙을 건너뜀
    "musicFade": 0,                 // 끝에서 페이드 아웃 시간(초)
    "note": "free text"
  },
  "assets": [{ "id": "assets/track.mp3", "name": "track.mp3", "type": "audio", "from": "User" }],
  "scenes": [
    { "id": "S1", "name": "Hook", "t": [0, 4.5], "els": [
      { "id": "headline", "label": "Headline", "t": [0.3, 4.3],
        "box": [20, 38, 60, 24],    // 프레임의 %로 x, y, w, h; 보이스오버, 오디오, 전체 프레임 푸티지의 경우 null
        "src": "src/Hook.tsx:12",   // 요소를 그리는 파일(또는 파일:줄)
        "props": {
          "text":   { "type": "text",   "label": "Text",   "v": "Meet Acme" },
          "color":  { "type": "color",  "label": "Color",  "v": "brand.accent" },
          "motion": { "type": "motion", "label": "Motion", "v": "Words blur in one by one" }
        } }
    ] }
  ],
  "notes": [],
  "review": [                       // 선택 사항: 자신의 자체 검토 발견 사항(섹션 3)
    { "id": "v1-1", "t": 1.5, "elId": "headline", "kind": "safe area",
      "title": "Headline runs into the right edge",
      "detail": "At 1.5 s the last word ends 2% from the edge, outside title-safe.",
      "fix": "Narrow the box to 56% or drop the size a step." }
  ],
  "outputs": [                      // 선택 사항: 이 비디오로 만든 다른 형태와 길이(섹션 9)
    { "id": "vertical", "label": "9:16", "kind": "reframe", "src": "out/vertical.mp4", "w": 1080, "h": 1920, "platform": "reels" }
  ],
  "live": "live.js",                // 선택 사항 라이브 렌더러(섹션 7)
  "export": { "cwd": "/abs/build/folder", "props": {}, "cmd": "npx remotion render ... \"$OUT\" --props=\"$PROPS\"" }  // 선택 사항(섹션 8)
}

규칙:

  • 속성 유형: text, longtext, number, color (brand.<id>는 팔레트에 연결), media (자산 id), list (행; cols: [{ k, type, options? }]), choice (options: [...]), motion (움직임에 대한 일반 설명; 사용자는 주석만 달 수 있음).
  • 장면은 간격 없이 0..duration을 덮습니다. 시간은 초 단위입니다.
  • 버전 간에 장면 및 요소 id를 안정적으로 유지하세요. 저장된 편집은 id로 일치합니다.
  • box는 요소가 화면에 실제로 있는 위치와 일치해야 하며, 프레임의 %입니다. 확실하지 않으면 프레임 캡처에서 측정하세요. 사용자는 이 상자를 클릭하여 항목을 선택합니다.
  • src는 요소를 그리는 코드를 가리켜야 하므로, 나중에 찾을 수 있습니다.
  • 모든 속성 값은 실제로 렌더링된 것과 같아야 합니다. 플레이어는 새로운 reel.json 값이 요청된 것과 일치할 때 편집을 완료된 것으로 표시합니다.
  • path는 생략 가능; 서버가 프로젝트 폴더를 채웁니다.
  • review 발견 사항: id (이 버전에서 고유, 예: v2-1), t (초), title (한 줄), 선택적 detail, fix 및 kind (safe area, size, contrast, typo, overflow, cut, timing 또는 자신만의 단어). elId (요소 id, 해당 상자에 링 표시됨), box: [x, y, w, h] 또는 프레임의 %로 x, y로 배치하세요. 매 버전마다 새로운 목록을 작성하세요; 사용자가 무시한 것은 반복하지 마세요.
  • outputs: 섹션 9를 참조하세요.
  • 알 수 없는 필드는 무시됩니다. 누락된 선택적 필드는 기본값을 얻습니다.

5. 플레이어 열기

서버를 백그라운드에서 시작한 다음, 사용자에게 출력되는 URL을 알려주세요:

node <skill dir>/player/server.mjs <project> &
# MotionSnip Studio: http://localhost:4321  (project: /abs/path)

옵션: --port 4321 (사용 중이면 증가), --no-open (브라우저 열지 않음), --ffmpeg /path/to/ffmpeg (Export용). Node 18 이상, 설치 단계 없음. 이 프로젝트의 서버가 이미 실행 중이면 다른 서버를 시작하지 마세요; 플레이어는 새 버전을 자동으로 인식합니다.

사용자에게 한두 줄로 무엇을 해야 하는지 알려주세요: 시청하고, 수정하려면 클릭하고, 문제를 동그라미 치려면 마우스 오른쪽 버튼을 클릭한 다음 Claude로 보내기를 하세요.

일반 비디오. 사용자가 reel.json이 없는 비디오 파일(화면 녹화, 휴대폰 클립)을 리뷰하거나 편집하려는 경우, 파일 자체를 전달하세요: node <skill dir>/player/server.mjs path/to/clip.mp4 &. 이에 대한 reel.json을 작성하지 마세요. 플레이어를 통해 사용자가 트리밍, 자르기, 텍스트, 로고 또는 블러 추가, 색상 설정을 할 수 있으며, Export가 이러한 편집을 직접 적용합니다. 그러면 피드백 파일에는 프레임에 고정된 메모만 포함됩니다; 이를 따르고, 메모가 새 컷을 요청하는 경우 동일한 파일 이름으로 내보내 플레이어가 다음 버전으로 간주하도록 하세요.

6. 피드백 파일 적용하기

사용자가 Apply the MotionSnip Studio feedback in <project>/.motionsnip/feedback-vN.md를 붙여넣습니다. 해당 파일을 읽으세요. 다음 부분이 있습니다:

  • 정확한 변경 사항. [00:01.2 · S1 · Headline] Text (src/Hook.tsx:12): "Meet Acme" -> "Say hi to Acme"와 같은 줄. 코드와 reel.json에서 정확히 그 변경을 수행하세요. 바꿔 말하지 마세요. brand.<id>에 대한 색상 편집은 팔레트 항목을 변경하므로, 이에 연결된 모든 것이 변경됩니다.
  • 크기 및 위치 편집. 프레임의 %로 [x, y, w, h] -> [x, y, w, h] (scale 1.12). 프레임 크기로 픽셀로 변환하고(x% * w / 100), 코드에서 요소를 이동하거나 크기를 조정하고, box를 업데이트하세요.
  • 사운드 설정. 새 트랙(이미 assets/에 저장됨), 시작 오프셋, 페이드, 볼륨. reel.json에서 audio를 업데이트하세요. 비디오에 효과음만 있는 경우 일반적으로 이를 위해 재렌더링할 필요가 없습니다. 음악이 굽혀진 경우(videoAudio: "mix"), 새 설정으로 재렌더링하세요.
  • {label} 버전에 대한 설명. 마스터 대신 컷다운(9:16, 1:1, 범퍼)에 남겨진 동일한 종류의 설명. 시간과 위치는 해당 버전의 자체 프레임과 시계에 있습니다; 범퍼의 섹션은 마스터의 어떤 부분이 잘렸는지 말합니다. 가능하면 마스터에서 원인을 수정하세요(크롭이 볼 수 있는 곳에 중요한 것을 유지). 자신이 해당 버전을 만든 경우(outputs에 있음), 다시 렌더링하고 자체 version도 올리세요.
  • MotionSnip Studio에서 만든 컷다운. 플레이어가 마스터에서 자체 렌더링한 버전으로, 크롭 키 또는 범위가 있음. 파일을 그대로 두세요; 리뷰어가 다음 버전 후에 재렌더링합니다.
  • 프레임에 대한 설명. 시간과 위치(x 23.9% y 81.8%)에 고정된 자유 설명으로, 종종 명명된 요소에 있음. 해당 프레임을 캡처하고 작업을 결정하기 전에 살펴보세요. 메모는 요청이며 정확한 값이 아닙니다; 판단을 사용하고 장면의 나머지 부분을 그대로 유지하세요.
  • vN-1에서 완전히 해결되지 않음. 지난 라운드에서 변경했지만 사용자가 아직 올바르지 않다고 말하는 것과 그 이유. 이것들을 먼저 수정하세요.
  • 자체 검토에서. (from your self-review, v1-2; the reviewer agrees)로 끝나는 설명은 사용자가 수락한 자신의 발견 사항 중 하나입니다. 다른 메모처럼 처리하세요.
  • 자체 검토에서 무시됨. 사용자가 살펴보고 만족하는 발견 사항. 해당 사항은 그대로 두고, 다음 review에서 다시 플래그를 지정하지 마세요.
  • 장면. 각 장면의 상태. 승인된 장Scene은 편집이나 메모가 명명하지 않는 한 그대로 두세요.

그런 다음:

  1. 변경 사항을 적용하세요. id를 안정적으로 유지하세요.
  2. 동일한 src 파일(또는 새 파일로 업데이트하고 src를 업데이트)로 재렌더링하세요.
  3. 연락처 시트와 건드린 프레임을 확인하세요.
  4. reel.json에서 변경된 모든 값을 업데이트하고 version을 N+1로 설정하세요(파일이 번호를 알려줌). 렌더링이 완료된 후에 version을 마지막으로 올리세요.
  5. 변경된 사항을 한 줄로 사용자에게 알려주세요, 예: "v4 is in · 5 changes applied, the outro note needs your eye".

절대 .motionsnip/, exports/ 또는 플레이어의 outputs/에 있는 컷다운(.motionsnip/outputs.json에 나열됨)을 편집하지 마세요; 이들은 플레이어의 것입니다.

7. 선택 사항: 라이브 렌더러

비디오가 브라우저(캔버스, DOM, Remotion Player 번들)에서 실행될 수 있는 경우, live.js를 제공하고 "live": "live.js"를 설정할 수 있습니다. 플레이어가 이를 클래식 스크립트로 로드하고 다음을 호출합니다:

window.MotionSnipLive = (container) => ({
  seek(timeSeconds) {}, play() {}, pause() {}, setRate(rate) {},
  // boxes[id] = [x, y, w, h, nx, ny, nw, nh]: 원본 후 편집, 프레임의 %
  setBoxes(boxes) {},
});

그러면 플레이어가 비디오를 숨기고 렌더러를 구동하므로, 이동되거나 크기 조정된 요소가 실제로 표시됩니다.

8. 선택 사항: 내보내기 훅

사용자가 플레이어에서 최종 결과를 렌더링할 수 있도록 reel.json에 export를 추가하세요:

"export": {
  "cwd": "/abs/path/to/remotion/project",
  "props": { "musicSrc": null },
  "cmd": "npx remotion render src/index.ts Main \"$RAW\" --props=\"$PROPS\""
}

서버는 cwd에서 sh -c로 cmd를 실행하고 다음을 설정합니다:

  • PROPS: export.props와 사용자의 편집 내용이 병합된 JSON 파일의 경로. 편집 내용은 다음과 같이 도착합니다. { "edits": { "<elId>": { "<prop>": value } }, "boxes": { "<elId>": [x, y, w, h] }, "colors": { "<id>": "#hex" }, "fonts": { "<id>": "Name" } } (박스는 프레임의 %). 컴포지션이 이를 읽도록 하여 렌더링에 포함시키세요.
  • OUT: exports/의 최종 파일. 렌더링에 이미 모든 것이 포함된 경우 여기에 쓰세요.
  • RAW: 임시 경로. 대신 여기에 쓰면 서버가 사용자가 선택한 음악과 레벨을 혼합하여 OUT을 만듭니다.
  • PROJECT: 프로젝트 폴더.

진행률은 명령어가 출력하는 마지막 n/m 쌍에서 가져옵니다(Remotion은 이와 같이 프레임 수를 출력합니다).

내보내기 훅이 없어도 Export는 여전히 작동합니다: 비디오를 복사하고 ffmpeg로 음악을 혼합합니다.

9. 선택 사항: 기타 형태와 길이 (outputs)

플레이어가 직접 컷다운을 만듭니다: + Cutdown은 마스터에서 ffmpeg로 9:16, 1:1(또는 수직 마스터에서 16:9) 또는 6초 범퍼를 outputs/<id>.mp4로 렌더링합니다. 리프레임은 리뷰어가 마스터에서 드래그한 크롭 키(또는 요소 상자에서 첫 번째 추측, 따라서 box를 정확하게 유지)를 따르거나, 전체 프레임을 흐릿한 채우기에 맞춥니다. 각 출력에는 자체 탭, Reels, TikTok 및 Shorts용 안전 영역 가이드, 자체 메모가 있습니다. 이에 대해 아무것도 할 필요가 없습니다.

코드로 빌드된 비디오가 잘 정리된 출력보다 더 나을 때, 당신은 reel.json에서 outputs 항목으로 직접 제공할 수 있습니다. kind는 "reframe"(크롭) 또는 "edit"(완전히 다른 비율 또는 길이)입니다. "edit" 출력에는 자체 src, 크기, 장면 및 속성이 포함될 수 있습니다. 플레이어는 이들을 재생하고 메모를 남깁니다. 리뷰어가 컷다운을 편집하고 당신이 그 변경 사항을 마스터에 다시 가져와야 할 때 유용합니다.

10. 설정

<skill dir>/settings.json은 기본값을 저장합니다:

{
  "ffmpeg": "ffmpeg"           // ffmpeg의 경로 또는 이름
}

존재하지 않거나 많은 설정이 필요하지 않습니다. 포트는 server.mjs에 전달됩니다.

마지막 규칙

  1. 절대 플레이어 파일을 편집하지 마세요. <skill dir>/player/의 모든 것. Export 출력, .motionsnip/도 마찬가지.
  2. 사용자가 피드백에 넣은 것이 없으면 건드리지 마세요. 사용자가 아무것도 표시하지 않았다면 비디오는 완성된 것입니다. 당신의 review 발견 사항을 추가할 수 있지만, 사용자가 명시적으로 보내지 않는 한 내용을 스스로 변경하지 마세요.
  3. 저장된 편집을 덮어쓰지 마세요. 플레이어는 .motionsnip/에 편집 기록을 보관합니다. 절대 건드리지 마세요.
  4. 에셋을 공유하세요. assets/에 음악과 미디어를 넣으세요. 플레이어는 reel.json의 assets 목록을 읽습니다.

SKILL.md — 플레이어가 버전을 확인합니다. 필요할 때만 업데이트하세요.

관련 스킬