Communitygithub.com

yazzang-homelab/motion-studio

모션 스튜디오 필름 프로젝트를 스캐폴드합니다(seek(t) 렌더러, 스프링, 비트 그리드, 합성 사운드, 비평 도구). 설치, 브라우저 설정, 닥터를 실행합니다. 'set up the motion studio', 'new film project', 'init studio' 등에 사용합니다.

motion-studio란 무엇인가요?

이 스킬은 에이전트가 모션 스튜디오 필름 프로젝트를 생성하고 설정할 수 있게 해줍니다. 사용자가 요청한 제목, 길이, 포맷, FPS, BPM 등의 설정을 바탕으로 `init.mjs` 스크립트를 호출하여 프로젝트를 스캐폴드하고, 필요한 의존성을 설치하며, Playwright 헤드리스 브라우저를 설정하고, `npm run doctor`로 프로젝트 상태를 진단합니다. Windows 환경에서는 계정 잠금 문제를 방지하기 위해 번들된 헤드리스 셸을 사용하며, `--force` 플래그로 기존 프로젝트를 템플릿에 맞게 업데이트할 수 있습니다. 최종적으로 `npm run stills`로 첫 프레임을 생성하고 사용자에게 확인하는 단계까지 포함합니다. Claude Code, Cursor, Codex 등 셸 명령을 실행할 수 있는 모든 AI 어시스턴트와 호환됩니다.

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

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

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

문서

Studio init (코스 스텝 02)

자체 프레임을 렌더링하고, 듣고, 볼 수 있는 필름 프로젝트를 생성합니다. 채팅 앱은 애니메이션을 작성할 수 있지만, 셸을 가진 에이전트만이 렌더링을 닫고, 보고, 루프를 수정할 수 있습니다. 그 루프가 "그냥 그런" 첫 시도와 공유할 가치가 있는 필름을 구분짓는 차이입니다.

요청 인수(비어 있을 수 있음), 한 번 표시:

1. 디렉토리 및 설정 선택

  • 디렉토리: 첫 번째 인수; 작업 디렉토리가 비어 있으면 .; 그 외에는 묻습니다(기본값 ./<제목-슬러그>). 플러그인 디렉토리 안에는 절대 스캐폴드하지 마십시오.
  • 요청의 설정: 제목, 길이, 포맷, fps, bpm, 루프, 브랜드 URL. 나머지는 템플릿 기본값으로 둡니다(studio.json: 12초, 60fps, 4서브프레임, 120BPM, 9x16 기본).

2. 스캐폴드

node "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <dir> --title "<Title>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
플래그효과
<dir>대상; 없으면 생성
--title Tstudio.json 제목 및 전달 파일 슬러그
--duration S, --fps N, --bpm N타이밍
--formats a,b9x16, 1x1, 16x9, 4x5의 하위 집합(또는 all); primaryFormat은 목록에 없어도 유지됨
--loop끊김없는 루프 필름(UI 변형)
--brand-url URL제품 URL을 brand.url에 저장합니다. user:password@ 및 비밀처럼 보이는 매개변수(쿼리, ;matrix, 프래그먼트: token, key, secret, password, auth, sig, session, code ...)는 기록되기 전에 제거됩니다. stderr에 제거된 내용이 이름으로 출력되고 --json은 redacted에 나열합니다. 여전히 일반 공개 URL을 전달하십시오: bare 경로 세그먼트(/reset/<토큰>)인 비밀은 인식할 수 없습니다. 일반 URL은 입력된 그대로 저장됩니다.
--install새 프로젝트에서 npm install을 실행합니다(Windows에서 npm.cmd 처리)
--force기존 프로젝트를 현재 템플릿으로 새로고침합니다(아래 표 참조)
--jsonstdout에 하나의 JSON 결과 줄을 출력합니다

기존 비어 있지 않은 디렉토리는 병합됩니다: 누락된 파일만 추가되고 건너뛴 파일은 나열됩니다. 건너뛴 목록을 사용자에게 보고하십시오. 절대 그들의 파일을 삭제하지 마십시오.

기존 프로젝트에 --force(init.mjs에 대해 확인):

경로--force 사용 시
studio.json, film/**, docs/**, assets/fonts/fonts.json유지되고 kept로 나열됨; 누락된 것은 여전히 생성됩니다. --bpm과 같은 플래그는 여전히 studio.json을 패치합니다
package.json병합되며, 절대 대체되지 않음: type: module 설정, private, engines 및 프로젝트에 없는 모든 템플릿 스크립트 또는 종속성을 추가합니다. 명령이 다른 템플릿 스크립트는 템플릿 명령으로 재설정됩니다(init는 각각 was ..., now ...로 출력하고 packageReset에 반환). 종속성 버전은 절대 변경되지 않으며, 템플릿 종속성도 포함됩니다: 기존 범위는 유지되며, 더 새롭거나, 오래되었거나, 고정되어 있어도 마찬가지입니다. 이름, 버전, 다른 스크립트 및 다른 필드는 유지됩니다
.gitignore병합됨: 누락된 템플릿 줄이 # motion-studio 아래에 추가되며, 아무것도 제거되지 않음
그 외 모든 것(CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, 번들 폰트)덮어쓰기되고 overwritten으로 나열됨. 이 파일에 대한 로컬 편집 내용은 손실됩니다: 먼저 커밋하거나 복사하십시오
사용자 자신의 추가 파일건드리지 않음

--force 없이, package.json 및 .gitignore는 동일하게 병합되지만, 다른 스크립트는 사용자의 명령을 유지합니다. Init는 템플릿과 다른 모든 스크립트 및 종속성 버전을 kept your package.json values, which differ from the template 아래에 나열합니다(--json 결과에서 packageKept): 해당 npm run 이름은 사용자의 명령을 실행하며, --force는 템플릿 스크립트를 재설정합니다(종속성 버전은 절대 변경되지 않음). 객체가 아닌 scripts, devDependencies 또는 optionalDependencies 섹션은 경고와 함께 그대로 둡니다. docs/**가 유지되므로, 최신 템플릿 문서는 기존 프로젝트에 도달하지 않습니다: 업데이트 후 플러그인의 template/docs/와 수동으로 비교하십시오.

3. 설치, 브라우저, 닥터

  1. --install 없이, 프로젝트 내에서 npm install을 실행합니다. playwright는 유일한 필수 종속성입니다. ffmpeg-static은 선택 사항이며 프록시 뒤에서 다운로드에 실패할 수 있습니다.
  2. 브라우저(npm run setup:browser는 npx 줄과 동일한 명령):
    • Windows: npx playwright install chromium-headless-shell을 실행합니다(약 115MB 다운로드, 디스크 270MB). studio.json browser: "auto"는 번들된 헤드리스 셸만 시작하며, 설치된 Chrome이나 Edge는 절대 시작하지 않습니다. 이유: 설치된 Chrome이나 Edge를 새 프로필(모든 도구 실행 시)로 시작하면 Chrome이 Windows 계정의 빈 암호를 테스트하여 로그온 실패로 간주합니다. 측정된 랩탑은 10분 내에 10회의 로그온 실패 시 계정을 잠그며 24시간 동안 464회를 기록했습니다. 사용자가 요청하고 위험을 수락하지 않는 한 browser를 chrome 또는 msedge로 전환하지 말고, MOTION_CHROME_PATH를 chrome.exe 또는 msedge.exe로 설정하지 마십시오. 위험을 수락하면 실행 시 경고를 출력하고 10분 내 4번째 실행은 거부되며, 3번은 통과합니다(실행 가드). 셸은 서명되지 않았으므로 실시간 안티바이러스가 모든 도구 실행을 15~25초 느리게 만들 수 있습니다(측정됨): 사용자에게 한 번 알리십시오. %LOCALAPPDATA%\ms-playwright에 대한 안티바이러스 제외는 사용자 또는 IT의 결정입니다.
    • macOS 및 Linux: auto는 설치된 Chrome, 그 다음 Edge, 그 다음 번들 브라우저를 경고 없이 시도합니다. 아무것도 설치되지 않은 경우 npx playwright install chromium-headless-shell을 실행합니다(Linux: npx playwright install --with-deps chromium-headless-shell), 또는 MOTION_CHROME_PATH를 Chromium 계열 실행 파일로 설정합니다.
  3. npm run doctor. 인계하기 전에 모든 FAIL 행을 수정하고, Windows에서는 WARN 브라우저 행도 수정합니다(설치된 Chrome 또는 Edge가 선택된 경우: 지우고 헤드리스 셸 설치); OS별 수정 사항은 references/troubleshooting.md에 있습니다. librosa가 포함된 Python은 선택 사항입니다(JS 비트 엔진이 대체). Node 22+는 경로 B 도구에만 필요합니다.
  4. 증명: npm run stills를 실행한 다음 out/review/9x16/contact.png를 열고(긴 필름은 페이지로 나뉩니다: contact.png는 1페이지, 그 다음 contact-2.png ..., 페이지 높이가 1800px를 넘지 않음; 모든 페이지를 열어보십시오) 확인합니다. 제공된 12초 데모는 0초에 구성된 프레임과 모든 다운비트에서 변경 사항을 보여주어야 합니다. npm run preview는 라이브 미리보기를 엽니다(Space 재생/일시정지, 화살표 프레임 이동, F 포맷 순환, G 안전 영역 가이드).

4. 사용자에게 프로젝트 설명

몇 줄로 요약한 다음 참조를 안내하십시오:

  • 레이아웃 및 편집 주체: references/project-layout.md
  • 모든 명령: references/commands.md
  • 모든 lib/ 서명 및 기본값: 새 프로젝트의 docs/API.md(전체 참조는 플러그인 저장소의 docs/ARCHITECTURE.md)
  • 하우스 룰은 프로젝트의 CLAUDE.md에 있으며, Claude Code가 실행될 때마다 읽습니다.

Init가 ★ 별 줄을 출력한 경우(--json 결과에서 starHint; 머신당 한 번, 첫 번째 새 프로젝트에서 나타남), 그 한 줄을 그대로 요약 끝에 추가하십시오. 저장소에 별표를 주거나 사용자를 위해 gh를 실행하지 마십시오.

명령기능
npm run preview브라우저에서 라이브 미리보기
npm run stills비트당 하나의 스틸 이미지를 연락처 시트로
npm run critique연락처, 스트립, 폰 테스트, 메트릭, 리뷰-로그 블록
npm run gate비평 게이트: 3라운드, 모든 축 >= 8, P0 없음
npm run render:final모든 포맷, 최종 품질(게이트 적용)
npm run sfx / npm run mix큐 SFX 합성 / -14 LUFS로 믹싱 및 먹싱
npm run deliver전달 확인 및 out/deliver/ 패키지
npm run build점수 없으면 생성, sfx, 최종 렌더링, 믹스, 전달

5. 노력 및 경로

작업노력설정 방법
작은 수정, 재렌더링medium/effort medium
새 필름xhigh/effort xhigh(motion-reel 스킬이 자동 설정)
플래그십 첫 3초 런칭max/effort max

/model은 Opus 5.5를 선택할 때 노력 선택도 제공합니다. 경로 A(이 엔진)가 기본값입니다. 사용자가 이름을 지정할 때만 Remotion 또는 HyperFrames를 사용하십시오. /motion-studio:seek-engine에는 Remotion 라이선스 게이트를 포함한 핸드오프가 있습니다.

6. 키

키가 필요할 때만 .env.example을 .env로 복사하십시오(음성: ELEVENLABS_API_KEY; 경로 C 이미지/비디오: FAL_KEY). 사용자에게 값을 .env에 직접 붙여넣도록 안내하십시오. 프롬프트 및 로그에서는 변수 이름만 참조하십시오. .env는 이미 프로젝트 .gitignore에 있습니다.

7. 선택적 동반자

관련이 있을 때만 언급하십시오. 설치 명령 및 주의사항: references/companions.md.

동반자용도참고
claude-animation (buildwithhanif)손그림, 브러시, 스토리북 스타일MIT; 별도의 Node Canvas 렌더러
HyperFrames (heygen-com)HTML + GSAP 구성Apache-2.0; Node 22+
RemotionReact 시리즈 및 템플릿3명 초과 직원의 영리 조직은 회사 라이선스 필요

다음: /motion-studio:showreel로 엔진을 테스트하거나 /motion-studio:motion-reel로 실제 필름을 만드십시오.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

관련 스킬