Communitygithub.com

Parrass/mograf-public

모션 그래픽을 위한 독립적인 평론 및 품질 관문. HyperFrames/GSAP/HTML(또는 Remotion) 작품을 스튜디오 평가 기준 9개 차원으로 점수화하고, 하드 게이트, 12개 항목의 장인 기준, 안티-슬롭 목록을 픽셀 단위로 검사한 후 APPROVE/POLISH/REWORK 중 하나를 정확한 프레임 수준의 수정 사항과 함께 반환합니다.

mograf-public란 무엇인가요?

이 스킬은 모션 그래픽 작품에 대한 '취향'을 코드 수준이 아닌 시각적 결과물 수준에서 평가하는 자동화된 품질 관문(gate)입니다. 일반적인 린터가 구문 오류를 잡는 반면, 이 스킬은 작품의 미적 완성도, 타이밍, 연출, 사운드 싱크 등 스튜디오 수준의 9가지 평가 차원을 1~5점 척도로 채점하고, 12가지 장인 기준(craft bar)과 15가지 안티-슬롭(anti-slop) 항목을 통과해야만 APPROVE를 부여합니다. HyperFrames, GSAP, HTML, Remotion 등 다양한 기술 스택을 지원하며, 특히 프레임 스냅샷, 모션 맵, 코드 분석, 실제 속도 감상 등의 절차를 통해 픽셀 단위의 정확한 피드백을 제공합니다. 'APPROVE', 'POLISH', 'REWORK' 세 가지 평결을 내리며, POLISH나 REWORK의 경우 구체적인 수정 사항과 우선순위를 함께 제시합니다. 이 스킬은 빌더가 자신의 작업을 스스로 평가하지 않도록 새로운 컨텍스트의 서브 에이전트로 실행하는 것이 가장 효과적입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-review

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

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

문서

motion-review: 취향의 관문(gate)

린터는 깨진 코드를 잡습니다. 이 스킬은 취향을 잡습니다. 기본 자세: 먼저 지적하고, 승인은 얻어내는 것. "그냥 괜찮아 보이는" 작품은 3점을 받으며, 3점으로는 출고될 수 없습니다.

실행 방법

  • 가능하면 새로운 서브 에이전트로 실행하세요. 이 파일, 프로젝트 폴더, 그리고 브리프(brief)를 제공합니다. 빌드가 얼마나 어려웠는지는 알려주지 마세요.
  • 리뷰어는 절대 컴포지션을 편집하지 않습니다. 프로젝트 폴더에 review.md를 작성하고 평결을 반환합니다.
  • 코드뿐만 아니라 픽셀도 살펴보세요. 모든 점수는 타임스탬프, 프레임 또는 선택자(selector)를 가리켜야 합니다.
  • 작품당 리뷰어는 한 명입니다. 두 명의 리뷰어가 동시에 실행되면 같은 review.md를 작성하게 되어 평결이 충돌합니다. 각 라운드는 하나의 verdict: 줄로 끝납니다. 호출자는 review.md에서 이를 폴링합니다. 재리뷰는 동일한 리뷰어가 수행합니다. 오랜 시간이 지나도 review.md에 새 라운드가 표시되지 않을 때만 대체 리뷰어를 시작하고, 취소 사유를 review.md에 기록한 후 대체 리뷰어가 먼저 이력을 읽도록 합니다. 라운드가 충돌하는 경우, review.md에 마지막으로 기록된 내용이 우선합니다.

절차

모든 단계를 실행하세요. 명령어는 HyperFrames 프로젝트(npx hyperframes …)를 가정합니다. 다른 스택의 경우 동등한 명령어를 사용하세요(Remotion: 프레임용 npx remotion still, 스트립용 npx remotion render).

  1. 구조. npx hyperframes check . 오류가 하나라도 있으면 Block입니다. 경고도 읽으세요. 대비(contrast) 감사가 대비 게이트입니다. 읽을 의도가 없는 장식용 텍스트(블러 유령, 유령 흔적 클론, 분해 칩, 스크램블 필러)는 각 노드에 data-layout-ignore를 사용하여 제외합니다. 실제 복사본을 숨기는 데는 절대 사용하지 마세요.

  2. 모션 맵. 타임라인 코드(또는 HyperFrames 스킬이 animation-map.mjs를 제공하는 경우 애니메이션 맵)를 읽으세요. 다음을 기록합니다:

    • 1초 이상 움직임이 없는 데드 존;
    • 0.2초 미만(읽기에 너무 빠름) 또는 2초 초과(표류)의 공간 이동;
    • 불규칙하거나 기계적인 스태거(stagger);
    • 프레임을 벗어나거나 우연히 충돌하는 요소.

    사용자 정의 카메라, three.js, 카운터 등 프록시/세터 객체를 통해 구동되는 모션은 트윈 기반 맵에는 보이지 않습니다. 이러한 움직임은 프레임 스트립(5단계)을 사용하세요.

  3. 콘택트 시트. 스토리보드 또는 비트 목록에서 장면 및 경계 시간을 가져옵니다. 스냅샷:

    • 프레임 0, 히어로 순간, 마지막 프레임;
    • 모든 장면의 25% / 50% / 75%;
    • 모든 경계 시간에서 -2프레임, 0, +2프레임.

    npx hyperframes snapshot --at <t1,t2,…>. 정확한 프레임 시간을 전달하세요(t = frame / fps, 예: 30fps에서 프레임 316 → 10.5333). --at은 스냅하지 않으므로, 반올림된 시간은 렌더에 절대 포함되지 않는 중간 포즈를 보여줍니다. snapshot은 이전 실행의 오래된 PNG를 남겨두므로 각 실행 전에 이전 snapshots/ 디렉토리를 따로 옮기세요(예: rm glob으로 삭제하는 대신 node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())"). --at은 요청하지 않은 엉뚱한 프레임을 추가할 수도 있으니 무시하세요. 이미지를 열고 확인하세요. 요소가 보이는 시간에만 활자체를 확대하세요(숨겨진 요소를 확대하면 멈출 수 있음).

  4. 깊이 증명. 카메라 또는 히어로 움직임의 경우 npx hyperframes keyframes --ghost --angle. z축을 따라 분리되는 평면은 실제 깊이를 의미합니다. 모든 것이 함께 크기 조정되면 가짜 깊이입니다. 히어로 움직임에서 유령 간격이 균일하면 선형 이징(easing)을 의미하며, 이는 실패입니다. --ghost를 실행할 수 없으면 스크래치 복사본을 만들고 월드의 부모에 증명 카메라를 제공한 후(뒤로 밀기 + 피치 + 요, 예: translateZ(-900px) rotateX(-28deg) rotateY(64deg); 요만으로는 깊은 장면 내부에 카메라가 들어갑니다), 움직임 전체에 걸쳐 4-6개의 프레임 시간을 스냅샷하고 오버레이합니다(ffmpeg … -filter_complex blend=all_mode=lighten). 중첩된 원근(nested perspective)의 경우 이 양파를 수동으로 빌드하고(snapshot --angle side는 평면화함), JS 프로젝션 카메라(하나의 SVG/캔버스에 3D 프로젝션)의 경우 스크래치 복사본의 프로젝션 함수에 사이드 카메라를 교체하세요.

  5. 실제 속도 감상. 렌더가 존재하는 경우:

    • 스트립 만들기: ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg;
    • ffprobe로 지속 시간과 첫 번째 및 마지막 프레임 확인;
    • 오디오가 있으면 각 히트를 큐 시트와 비교(±1프레임)하고 최종 AAC 파일의 실제 최고峰值가 -1 dBTP 이하인지 확인(ffmpeg -i … -af ebur128=peak=true -f null -);
    • 투명 .webm 오버레이: ffprobe는 VP9-알파를 yuv420p로 표시합니다. -i 전에 -c:v libvpx-vp9로 디코딩하거나 ALPHA_MODE=1 태그를 사용하여 알파를 확인하세요(스트림 읽기는 yuva420p).
  6. 코드 읽기. 컴포지션에서 다음을 grep하세요:

    • ease: (사용된 모든 이즈 나열) 및 지속 시간;
    • 불투명도만 있는 진입과 작은 y: 오프셋(20–40px);
    • Math.random / Date.now (비결정적);
    • back.out|elastic|bounce, yoyo, repeat: -1;
    • 공간 이동에서의 선형 또는 power1; 허용 목록 밖의 이즈(mg.*, power3.out, expo.out, power3.in, power4.out, power2.inOut, none, 내장 스프링);
    • 이즈를 공유하는 동시 트윈(잠긴 그룹인 경우에만 괜찮음: 하나의 다중 대상 트윈 또는 defaults가 있는 하위 타임라인); 세터 구동 프록시는 해당 트윈의 이즈에 따라 한 번 계산;
    • yPercent 130 아래에서 시작하는 블러 라인 마스크 상승(블러가 마스크로 새어 나옴);
    • 금지된 글꼴;
    • 그레인, 비네트, 모션 블러 누락.
  7. 9개 차원 점수화(아래 기준점), 1–5, 각각 시간 또는 프레임과 연결된 한 줄짜리 이유 포함.

  8. 장인 기준(12개 항목, 합격/불합격; 아래 표).

  9. 안티-슬롭 스캔(아래 상위 15개 목록). id 기록.

  10. 라이선스. 모든 비-오리지널 에셋(글꼴, SFX, 음악, 이미지, 타사 코드)에는 출처와 호환 가능한 라이선스가 기록되어 있어야 합니다. 글꼴: OFL 또는 유사. 코드: MIT 또는 Apache(헤더 유지). 알 수 없는 것은 모두 플래그.

평가 기준표 (1–5점)

차원135
컨셉아이디어 없음; 배경 위의 텍스트; 어떤 브랜드로든 대체 가능명확한 한 줄 아이디어; 모션이 일부 장면에서 이를 뒷받침처음부터 끝까지 강력한 하나의 아이디어와 한 문장으로 설명할 수 있는 놀랍고 독창적인 순간
구도모든 것이 중앙 정렬, 균일한 크기, 의도 없이 어수선하거나 비어 있음그리드, 프레임당 하나의 히어로, 적절한 여백모든 스틸이 포스터 수준: 의도적인 크롭, 깊이 레이어, 여백; 레이아웃이 진화함
타이포그래피시스템 또는 일반 글꼴, 기본 자간, 전체 블록 페이드올바른 분할 단위(줄/단어/문자), 마스크된 리빌, 가독성타입 자체가 애니메이션: 가변 축, 운동학적 레이아웃, 크롭/스케일 플레이, 완벽한 리듬
타이밍 & 이징선형 또는 기본 이즈, 균일한 지속 시간, 홀드 없음히어로 움직임에 사용자 정의 이즈, 다양한 지속 시간, 읽을 수 있는 홀드비대칭 속도, 세련된 오버슈트, 프레임별로 필연적으로 느껴지는 홀드
안무모든 것이 함께 움직이거나 균일한 스태거히어로가 이끌고, 서포트가 오프셋으로 따르며, 오버랩 존재지휘됨: 한 동작이 다음 동작으로 흘러가고, 2차 모션이 1차 모션에 반응함
전환크로스페이드 또는 무관한 컷디자인된 마스크/와이프, 비트에 맞춤하나의 연속적인 카메라/아이디어; 기억에 남고, 결코 과장되지 않음
깊이 & 텍스처플랫 또는 블롭 그라디언트 위의 플랫 벡터, 정적 프레임카메라 드리프트/푸시, 2개 이상의 깊이 평면, 약간의 그레인 또는 빛실제 3D 또는 설득력 있는 2.5D, 조명이 이야기를 전달하고, 텍스처가 과시하지 않으면서 통일감을 줌
사운드 싱크무음 또는 관련 없는 오디오주요 컷이 비트에 맞춤화면과 사운드가 함께 구성됨; 침묵을 악센트로 사용; 깔끔한 믹스
마무리버그, 떨림, 팝, 앨리어싱, 로드되지 않은 에셋깔끔하고 일관되며 디자인된 마지막 프레임스튜디오 출고 가능; 모든 프레임 검토됨; 마지막 프레임 유지 및 해결됨

2점과 4점은 기준점 사이에 있습니다. 4점을 받으려면:

  • 타이밍: 역할별 이즈 팔레트, "빠른 출력, 긴 안정" 도착, 가속 출구.
  • 안무: 기대 동작, 후속 동작, 이즈 또는 거리 기반 스태거.
  • 전환: 적어도 하나의 매치 컷 또는 모프, 최고 속도에서 블러가 포함된 컷.
  • 깊이: 3-평면 시차 및 빠른 움직임에 모션 블러.
  • 구도: 적어도 5배의 크기 대비.

브리프에서 무음을 선언한 SFX 없는 절제된 작품은 사운드 싱크 점수를 침묵과 시각적 리듬으로 평가합니다. 의도적인 선택을 처벌하지 마세요.

하드 게이트 (하나라도 해당되면 Block)

  • check 실패, 렌더가 비결정적이거나, 시크(seek) 시 글리치 발생.
  • 읽을 수 없는 텍스트:
    • 단어당 0.5초 + 0.3초 미만의 홀드;
    • 4.5:1 미만의 대비;
    • 안전 영역을 넘는 텍스트.
  • 글꼴 플래시, 누락된 에셋, 경계에서 깨지거나 빈 프레임, 첫 번째 또는 마지막 프레임의 팝.
  • 서면 정당성 없이 3개 이상의 안티-슬롭 항목 적중.
  • 히어로 공간 이동에서 선형 또는 기본 이즈.
  • 브리프에 서면 면제 없이 장인 기준 항목 누락.
  • 초당 3회 이상의 플래시.
  • 출처나 라이선스 기록이 없는 타사 에셋.

장인 기준 (12개 항목)

  1. 컨셉. 한 문장 아이디어와 러닝타임의 약 40% 시점에 시그니처 순간.
  2. 히어로 스틸. 디자인된 히어로 프레임(구도 ≥ 4, 최소 3개 깊이 레이어).
  3. 카메라. 유령 또는 사이드 앵글 검사로 증명된 적어도 하나의 실제 카메라 또는 깊이 움직임.
  4. 사용자 정의 이즈. 적어도 3개의 뚜렷한 이즈 특성. 우연히 동일한 이즈를 공유하는 동시 트윈이 없어야 함.
  5. 기본 페이드 업 없음. 어떤 곳에서도 opacity 0→1 + y 20–40→0 없음.
  6. 명명된 경계. 경계는 이름이 지정되고 속도가 일치해야 함. 최대 하나의 일반 크로스페이드.
  7. 모션 블러 1-3개의 빠른 비트에 적용(텍스트를 읽는 중에는 절대 적용 금지).
  8. 텍스처 패스. 그레인, 비네트 및 방사형(빛 동기) 그라디언트.
  9. 빛 이벤트. 적어도 하나: 스위프, 광택, 스캔 밴드, 블룸, 누출.
  10. 사운드. 오디오가 있으면 사운드 싱크. 그렇지 않으면 작품이 무음으로 선언됨.
  11. 리듬.
    • 가장 느린 스토리보드 비트는 가장 빠른 비트의 최소 3배(비트는 스토리보드 행, 서브 트윈 아님).
    • 모든 트윈의 최대/최소 지속 시간은 최소 4.
    • 마지막 스틸은 최소 0.8초 동안 유지.
    • 마지막 프레임이 썸네일로 작동.
  12. 평가 기준 충족(선적 기준 참조).

안티-슬롭 상위 15

id증상수정
S1모든 요소가 페이드 인 및 20–40px 위로 슬라이드역할별 진입: 텍스트는 마스크/분할, 도형은 점으로부터 스케일, 장면은 카메라가 운반
S2동일한 지속 시간(모두 0.5초 / 1초)거리와 질량에 따른 지속 시간; 히어로 도착 0.8–1.5초, 퇴장 약 30% 더 빠름
S3공간 이동에 기본 이즈(power1, CSS ease, ease-in-out) 또는 선형명명된 사용자 정의 이즈; 비대칭 "빠른 출력, 긴 안정"
S4균일한 0.1초 스태거의미 있는 원점(중앙, 초점, 읽기 순서)에서 이즈된 스태거
S5모든 것이 동시에, 같은 속도로 움직임하나의 리드; 서포트가 2-8프레임 후에 더 작은 진폭으로 따라옴
S6홀드 없음: 들어왔다가 바로 나감가독 홀드 ≥ 단어당 0.5초 + 0.3초
S7갑작스러운 정지: 도착하고 멈춤긴 안정, 홀드를 통한 미세 드리프트
S8모든 것에 탄성/백/바운스작품당 최대 하나의 오버슈트, 6% 이하, 트랜스폼에만 적용
S9유휴 "호흡" 펄스(스케일/불투명도 요요)정지, 또는 하나의 동기 있는 앰비언트, 또는 최종 포즈가 있는 카메라 드리프트
S10모션 블러 없는 빠른 움직임1-3개의 가장 빠른 비트에 셔터 스타일 또는 방향 블러
S11중앙 스택: 제목 / 부제목 / 버튼비대칭 그리드, 가장자리 앵커 타입, 30-50% 여백
S12정적 프레임, 카메라 없음푸시, 드리프트, 시차 평면, 비트에 펀치인
S13"슬라이드": 장면이 페이드 아웃되고 다음 장면이 페이드 인동기 있는 경계: 매치 컷, 모멘텀, 마스크, 모프
S14보라색-파랑 / 분홍-주황 블롭, 글래스모피즘, 모든 것에 네온광원처럼 동작하는 그라디언트; 2-3색 + 중성, 악센트 ≤ 10%
S15Inter/Roboto/Poppins regular를 "디자인"으로 사용; 이모지 또는 스톡 아이콘표현적인 디스플레이 서체, 촘촘한 자간, 무게 대비; 사용자 정의 마크 또는 없음

또한 다음을 주시하세요:

  • 전체 아이디어인 타자기 + 커서;
  • 일반적인 카운팅 숫자;
  • 로렘 입숨 같은 복사본("unlock the future of…");
  • 그냥 멈추거나 페이드 아웃되는 엔딩;
  • 클라이맥스가 없는 평평한 에너지 곡선;
  • 어떤 메시지에도 어울리는 모션.

선적 기준

  • APPROVE: 평균 ≥ 4.0, 어떤 차원도 3 미만 없음, 하드 게이트 0개.
  • POLISH: 평균 3.5–3.9, 또는 하나의 차원이 3. 수정 목록 제시 후 재리뷰.
  • REWORK: 평균 3.5 미만. 컨셉과 스타일프레임으로 돌아가세요. 폴리싱으로는 해결되지 않습니다.

review.md 형식

piece: <이름> · reviewed: <날짜> · render: <경로 또는 없음>
concept: N — …            composition: N — …        typography: N — …
timing_easing: N — …      choreography: N — …       transitions: N — …
depth_texture: N — …      sound_sync: N — …         finish: N — …
average: N.N
hard_gates: [ … ]
craft_bar: [1 ✓, 2 ✗ (이유), …]
anti_slop_hits: [S1, S7, …]
verdict: APPROVE | POLISH | REWORK   → route fixes to: concept | composition | motion build
contact_sheet: <path>

그런 다음 Before | After | Why 표를 만듭니다. 영향 ÷ 노력 순으로 정렬하고, 모든 "After"는 정확한 값으로 만듭니다:

#위치 (t / frame / selector)BeforeAfterWhy
13.40–3.90 s #titleopacity + y 30, power2.out 0.5 s줄로 분할, 마스크 리빌, settle ease cubic-bezier(0,.65,.51,.99) 0.9 s, 줄 +4프레임기본 페이드 업 (S1); settle 없음 (S7)

수정 순서: 삭제 → 축소 → 이징 수정 → 구도/원점 수정 → 시간 재조정 → 깊이/블러/텍스처 추가 → 폴리싱. 절대 "더 역동적으로 만드세요"라고 쓰지 말고, 항상 숫자가 포함된 레시피를 제공하세요.

재리뷰

재리뷰는 동일한 리뷰어가 수행합니다. 수정 후 1단계, 3단계(변경된 영역 및 해당 경계) 및 7단계를 다시 실행합니다. 시간 재조정 시 check를 다시 실행합니다. 대비 샘플이 타이밍에 따라 이동합니다. review.md에 이전 점수를 유지하여 개선 사항이 보이도록 하고, 각 라운드를 자체 verdict: 줄로 끝냅니다. 폴리시 루프 후 3회 후에 중단합니다. 평균이 여전히 4.0 미만이면 REWORK를 반환합니다.


무료 mograf 스킬(MIT)의 일부입니다. 전체 스튜디오 파이프라인은 mograf.si에서 확인하세요. 라이브러리의 각 작품은 프롬프트, 스킬, 소스 및 사본과 함께 제공됩니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬