MotionSnip Studio은(는) 무엇을 하나요?
당신이 비디오를 만듭니다. 사용자가 로컬 플레이어에서 리뷰합니다. 루프는 다음과 같습니다:
- 비디오를 빌드하고 렌더링합니다.
reel.json에 설명을 작성합니다.- 플레이어를 엽니다.
- 사용자가 리뷰하고 Claude로 보내기를 클릭합니다. 그러면 한 줄을 받게 됩니다:
Apply the MotionSnip Studio feedback in <abs path>. - 피드백을 적용하고, 재렌더링하고,
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은 편집이나 메모가 명명하지 않는 한 그대로 두세요.
그런 다음:
- 변경 사항을 적용하세요. id를 안정적으로 유지하세요.
- 동일한
src파일(또는 새 파일로 업데이트하고src를 업데이트)로 재렌더링하세요. - 연락처 시트와 건드린 프레임을 확인하세요.
reel.json에서 변경된 모든 값을 업데이트하고version을 N+1로 설정하세요(파일이 번호를 알려줌). 렌더링이 완료된 후에 version을 마지막으로 올리세요.- 변경된 사항을 한 줄로 사용자에게 알려주세요, 예: "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에 전달됩니다.
마지막 규칙
- 절대 플레이어 파일을 편집하지 마세요.
<skill dir>/player/의 모든 것. Export 출력,.motionsnip/도 마찬가지. - 사용자가 피드백에 넣은 것이 없으면 건드리지 마세요. 사용자가 아무것도 표시하지 않았다면 비디오는 완성된 것입니다. 당신의
review발견 사항을 추가할 수 있지만, 사용자가 명시적으로 보내지 않는 한 내용을 스스로 변경하지 마세요. - 저장된 편집을 덮어쓰지 마세요. 플레이어는
.motionsnip/에 편집 기록을 보관합니다. 절대 건드리지 마세요. - 에셋을 공유하세요.
assets/에 음악과 미디어를 넣으세요. 플레이어는reel.json의assets목록을 읽습니다.
SKILL.md — 플레이어가 버전을 확인합니다. 필요할 때만 업데이트하세요.