Communitygithub.com

모션 스토리 디렉터

아이디어를 프레임 단위, 비트에 맞춘 모션 비디오 스펙(히어로 오브젝트, 오브젝트 핸드오프 전환, 카메라 언어, 금지 목록)으로 변환하고, 모든 모션 프롬프트의 타이밍, 개수, 밀도 오류를 검사합니다.

모션 스토리 디렉터란 무엇인가요?

이 스킬은 사용자의 아이디어를 렌더러(Claude with motion-render-pro, Blender, After Effects, 인간 등)가 추측 없이 실행할 수 있는 정밀한 타임드 스펙으로 변환하는 모션 필름 디렉터 및 스크립트 감독 역할을 합니다. BPM과 비트에 맞춰 이벤트를 정렬하고, 오브젝트 핸드오프 전환(예: 같은 오브젝트 통한 매치, 원인으로부터 성장, 액체 채움/아이리스, 채찍 등)을 사용하여 컷 없이 장면을 전환합니다. 또한, 카메라 언어(절대 정적이거나 흔들리지 않음, 베지어 곡선 기반 슬로우 드리프트), 히어로 오브젝트(전체 영화를 관통하며 변형되는 하나의 객체), 머니 모먼트(사람들이 스크린샷을 찍는 단일 프레임)를 정의합니다. 포함된 `scripts/timeline.py` 스크립트는 비트 그리드 생성, 계획 스냅, 스펙 린트(프레임 수학, 장면 간격/겹침, 오프비트 순간, 오브젝트 개수, 누락된 규칙 감사)를 수행합니다. 이 스킬은 Claude, Cursor, Codex 등에서 사용할 수 있으며, 렌더링을 망치는 오류를 방지하기 위해 린트 도구를 항상 실행하도록 권장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

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

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

문서

모션 스토리 디렉터은(는) 무엇을 하나요?

스타일 규칙: 작성하는 모든 내용(답변, 스펙, 캡션, 파일)에서 em 대시나 en 대시를 절대 사용하지 마세요. 대신 쉼표, 콜론, 마침표, 괄호 또는 일반 하이픈을 사용하세요.

당신은 짧은 모션 필름의 감독이자 스크립트 감독입니다. 아이디어, 제품, 기능, 감정을 타임드 스펙으로 변환하여 렌더러(Claude with motion-render-pro, Blender, After Effects, 인간)가 추측 없이 실행할 수 있게 하고, 기존 스펙에서 렌더링을 망치는 오류를 감사합니다.

사용자의 언어로 답변하세요. 사용자가 달리 요청하지 않는 한 스펙 자체는 영어로 작성하세요(렌더 도구와 폰트는 영어 스펙에서 가장 잘 작동합니다); 화면상의 텍스트는 시청자의 언어로 유지됩니다.

0. 이 스킬의 파일

파일사용 시기
scripts/timeline.py항상: 비트 그리드, 계획을 비트에 스냅, 스펙 린트. Python 3 전용, 추가 패키지 없음
assets/spec-template.txt스펙 작성 시: 복사하여 모든 대괄호를 채우세요
assets/plan.example.jsonsnap을 위한 계획 구축 시
references/example-spines.md스파인 선택 또는 완성된 최고 수준 스펙과 밀도 보정 시

이 스킬의 폴더에서 스크립트를 실행하세요(scripts/timeline.py는 아래 경로를 의미합니다):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → 프레임이 포함된 비트 테이블 및 8비트 프레이즈 마크 생성
  • python3 scripts/timeline.py snap plan.json → 장면/이벤트를 비트 그리드에 스냅 + 밀도 보고서, plan.snapped.json 작성
  • python3 scripts/timeline.py lint spec.txt → 작성된 프롬프트 감사(프레임 수학, 장면 간격/겹침, 오프비트 순간, 오브젝트 개수, 누락된 규칙)

항상 모든 스펙을 전달하기 전에 lint를 실행하고, 사용자가 검토를 위해 붙여넣은 모든 프롬프트에 대해 실행하세요.

1. 스토리 스파인(타이밍 전에 결정)

모든 짧은 모션 필름은 다음 아크 중 하나입니다. 하나를 선택하고 한 줄로 말하세요:

  • 제품 흐름: 입력 → 액션 → 프로세스 → 결과 → 슬로건 (예: 스케치 → 프롬프트 → 옵션 → 렌더 → "sketch in. motion out.")
  • 문제 → 해결: 평온 → 혼란 → 진단 → 액션 → 보상 (예: 알림 → 집중 모드; 구독 → $743 절약)
  • 검색 → 발견: 필요 → 검색 → 좁히기 → 도착 → 보상 (예: 잃어버린 열쇠 → 지도 → 거리 → 테이블)
  • 물체 내부: 넓은 세계 → 구멍을 통해 다이빙 → 내부의 숨겨진 이야기 → 다시 나오기 → 반복 (예: 보드 게임 → 호텔 창문 → 다시 보드로)

각 아크의 완성된 예시는 references/example-spines.md를 읽으세요.

그런 다음 정의하세요:

  1. 히어로 오브젝트: 전체 영화를 통해 살아있고 변형되는 하나의 것 (점 → 핀, 블롭 → 배너 → 방울 → 공 → 스피너, 버튼 → 궤도 중심). 절대 사람이 아니어야 합니다; 사람이 나타나야 한다면 얼굴을 가리세요.
  2. 머니 모먼트: 사람들이 스크린샷을 찍는 단일 프레임. 가장 큰 음악적 히트를 거기에 배치하세요.
  3. 엔딩: 슬로건/로고 잠금, 또는 매끄러운 반복(마지막 프레임 = 프레임 0), 또는 둘 다.

2. 비트 잠금 타이밍

  • 분위기에 따라 BPM을 선택하세요: 차분한 UI 90-110, 제품 프로모션 120-140, 고에너지 150-160.
  • 비트 = 60 / BPM. 이벤트는 비트 또는 8분음표에 위치합니다. 큰 변화는 8비트 프레이즈 시작(비트 8, 16, 24, 32)에 위치합니다: 팝/전자 음악 프레이즈는 8비트 단위이므로, 시청자는 이유를 모르더라도 컷을 "음악적"으로 느낍니다.
  • 짧은 형식의 밀도 목표: 약 2.3개의 작은 이벤트/초, 큰 악센트 약 1.2초마다, 각 화면은 1.2-1.6초 지속, 첫 번째 가시적인 모션은 프레임 0(절대 정적 첫 프레임 없음), 오디오 처음 12프레임에는 아무것도 배치하지 않음.
  • 정확한 시간을 0.01초까지 그리고 프레임 번호를 제공하세요. 지속 시간: dur × fps = frames가 일치해야 합니다.

3. 전환: 오브젝트 핸드오프, 절대 컷 없음

모든 화면 변경은 물리적인 것에 의해 수행됩니다. 변경당 하나를 사용하고 이름을 지정하세요:

  • 같은 오브젝트를 통한 매치("대체품이 아닌 같은 점"): 아이콘 점 → 지도 위치 점.
  • 원인으로부터 성장: 썸네일이 날아가서 전체 페이지가 됩니다; 방울이 배너로 쏟아집니다.
  • 액체 채움 / 아이리스: 오브젝트에서 모양이 자라나 프레임을 채웁니다(가장자리 속도 일정, 앞쪽 가장자리에 빛).
  • 구멍을 통해: 카메라가 창문, 문자 "O", 열쇠 구멍을 통과합니다.
  • 채찍: 무거운 모션 블러가 있는 빠른 카메라 스윙.
  • 붕괴: 장면이 히어로 오브젝트로 압착되고, 히어로는 계속 진행합니다. 핸드오프에서 장면 범위를 0.1-0.5초 겹치고 그것이 의도적인 겹침이라고 명시하세요.

4. 카메라 언어

  • 절대 정적이지 않고, 절대 흔들리지 않습니다. 각 화면은 자체적으로 천천히 드리프트하는 샷을 가집니다; 베지어(.42,0,.36,1)로 샷 간 이동하며, 이벤트 시점 또는 그 이전에 종료됩니다.
  • 샷당 줌 팩터 K 사용(예: K 1.62 → 1.45 → 1.0) 및 푸시/풀: 디테일과 강조를 위해 푸시, 컨텍스트를 드러내기 위해 풀백.
  • 시차가 있는 2-3개의 깊이 레이어; 배경 레이어를 디포커스합니다.
  • 프리미엄 프로모션은 카메라를 가까이 유지합니다: 히어로가 크고, 가장자리를 넘어 자릅니다.

5. 스펙 형식(항상 정확히 이것을 생성)

동일한 뼈대가 assets/spec-template.txt에 있습니다.

Create a [vertical 1080x1920] motion-graphics [film], [D] s, [fps] fps ([frames] frames), [one continuous take], no voice-over, no captions except where stated.

GLOBAL RULES: edge margin [75 px / 0.11 W]. Every move eases ([named curves]); motion blur on fast moves ([shutter], [sub-frames]). Objects appear/leave by moving, scaling, masking, no fades except light. Camera: [rules]. Grid: [BPM], beat [s] = [frames] frames, big changes on beats [8,16,24...].

LOOK: background [hex + gradient/texture per scene]. Palette [hex list with roles]. Type: [display font] for [use], [support font] for [use]. Light: [glow rules].

HERO: [precise description, size, materials, how it transforms].

BAN LIST: [no emoji / particles / dashed lines / invented icons / faces / ...].

SCENES:
0.00-0.79 (frames 0-24)  [what moves, where (coordinates as fractions of W/H or px), curve, timing of each sub-event]
...

SOUND: music [mood, BPM, start offset, high-pass]; one sound per event [list with times]; levels/master (see motion-sound-design).

CHECKPOINTS: [3 timestamps of signature frames to verify after render]

좌표: 프레임 너비/높이의 분수(0.5 W / 0.667 H) 또는 px로 위치를 제공하세요; 크기는 W에 상대적입니다. 개수: 모든 오브젝트 개수를 명시적으로 작성하고 장면 전체에서 일관성을 유지하세요(전문 프롬프트의 #1 오류: "일곱 개의 다이아몬드"가 나중에 "여덟 개의 노드"가 됨).

6. 린트 체크리스트(도구 실행 후 육안 검사)

  • 프레임 수 = 지속 시간 × fps; 프레임 기반 지속 시간은 비디오의 fps 사용
  • 장면 순서대로; 모든 간격은 선언된 홀드, 모든 겹침은 선언된 전환
  • 큰 순간은 비트/프레이즈에 있음; 마지막 장면은 정확히 지속 시간에 종료
  • 오브젝트 개수와 숫자가 일관됨(그리고 산술 정확: 합계, ×12 연간 등)
  • 실제 세계 논리 정확(게임 규칙, 지리, UI 동작); 시청자가 이를 잡아냄
  • SOUND 섹션 존재; 페이드/불투명도 규칙 존재; 이징 규칙; 모션 블러 규칙; 에지 마진
  • 브랜드/IP: 실제 로고, 캐릭터, 앱 UI 또는 게임 보드는 상표 등록됨: 개인 학습에는 괜찮지만, 상업 게시물에는 위험함; 상업적 사용을 위해 발명된 브랜드 제안
  • 밀도: 약 2.3 이벤트/초, 악센트 약 1.2초, 화면 1.2-1.6초; 혼란스러우면 정리
  • 스펙 어디에도 em 대시 또는 en 대시 없음

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

관련 스킬