Communitygithub.com

모션 QA

페이퍼컷 릴의 스틸을 스타일 DNA와 스토리보드와 비교하여 검사합니다. 몇 개의 타임스탬프에서 콘택트 시트를 렌더링하고 전체 체크리스트를 실행한 후 전달 요약을 작성합니다. "릴 QA", "내 장면이 종이처럼 보이는지 확인", "이거 게시할 준비가 되었는지" 등에 사용하세요.

모션 QA란 무엇인가요?

이 스킬은 페이퍼컷 애니메이션 릴의 품질 보증(QA)을 자동화하는 전문 도구입니다. 스타일 DNA와 스토리보드를 기준으로 스틸 이미지를 비교하여, 내용이 아닌 스타일이 일관되게 유지되는지 확인합니다. 사용자는 장면별로 또는 전체 릴에 대해 QA를 실행할 수 있으며, 각 검사 단계에서 4~6개의 타임스탬프에서 콘택트 시트를 생성합니다. 이 스킬은 Remotion 및 Python 기반 프로젝트를 지원하며, Kyfram 프로젝트와도 호환됩니다. 체크리스트에는 종이 질감, 카메라 움직임, 배너 위치, 캡션 스타일, 유머 적용 여부 등 15가지 항목이 포함되어 있어, 사용자가 일관된 시각적 품질을 유지하도록 돕습니다. 모든 검사가 완료되면 스튜디오 미리보기와 함께 전달 요약을 제공하고, 발견된 문제는 관련 빌드 또는 보이스 스킬로 연결하여 수정합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-qa

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

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

문서

Papercut QA

스타일 DNA와 스토리보드와 비교하여 스틸의 스타일(내용 아님)을 확인합니다. 제작 중에는 장면별로 실행하고, 최종 렌더링 전에는 전체 릴에 대해 한 번 실행합니다.

사전 점검

  • 설치: 표준 또는 전체. 스틸을 사용하려면 Remotion이 있는 스캐폴딩된 프로젝트가 필요하며, 콘택트 시트에는 Python과 numpy, Pillow가 필요합니다($MOTION_PY). 누락된 부분: ./install.sh --doctor, 이후 motion-setup.
  • kyfram 프로젝트는 Remotion이 필요하지 않습니다: Kyfram 장면 출력을 검사하거나 수정하기 전에 kyfram 스킬을 호출하세요. qa.sh는 캐시된 장면별 세그먼트(core/tools/kyfram_qa.py)에서 스틸을 가져오므로 QA 전에 core/tools/render.sh로 한 번 렌더링하세요. 아래 모든 내용은 동일하게 적용됩니다.
  • 라이브러리: $MOTION_LIB, 그렇지 않으면 ~/.config/motion-explainer/config.env의 MOTION_LIB= 줄, 그렇지 않으면 한 번 묻습니다.
  • 먼저 읽기: $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md 섹션 2의 스타일 DNA, 그리고 배경 시트 style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. 각 이미지는 약 0.7~1.5k 토큰을 사용하므로, 필요한 단계에서만 엽니다.
  • 밀도 관련: $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md("Pacing stats" 참조): 장면 평균 2.8초, 장면당 24개의 개별 시각적 이벤트, 강세 단어마다 0.40.8초 간격, 약 0.6초마다 새 캡션 페이지. 내용이 아닌 밀도를 복사합니다.

1. 스틸 렌더링

프로젝트의 video/ 폴더에서:

$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • 검사당 4~6개의 타임스탬프를 사용합니다. 장면의 경우 NTH는 장면 길이(프레임)를 4로 나눈 값입니다. 전체 릴의 경우 FROM-TO를 생략하고 NTH를 높입니다.
  • 출력은 out/qa/NAME_0.jpg(및 더 긴 범위의 경우 _1, _2)이며, 시트당 최대 45프레임입니다. 시트를 읽고, 작게 유지하세요.
  • 장면당 하나의 QA 명령어를 사용하고, 두 개의 렌더를 동시에 실행하지 마세요. 수정은 장면당 두 라운드로 제한합니다.
  • 스토리보드와 비교: 장면의 프레임 0, 해당 단어의 주요 이벤트, 잘린 부분 없음, 배너나 캡션 밴드를 가리는 부분 없음.

2. 체크리스트

  • 모든 오브젝트가 종이처럼 보임: 그레인, 거친 가장자리, 그림자, 겹쳐진 조각 음영, 외곽선이나 그라데이션 없음.
  • 월드 카메라가 부드럽게 움직임. 배너와 레이블만 바둑판식(단계적, 미묘하게) 움직임.
  • 배너가 고정된 위치에 테이프로 붙어 있고, 3~7단어, 각각 하나의 사실, VO를 절대 반복하지 않음. 배너만으로 사실 시트처럼 읽힘.
  • 모든 세트가 VO 라인의 구체적인 단어를 설명하고, 숫자는 실제 소품이며, CTA 전에 하나의 콜백 세트가 있음.
  • 모든 숫자와 UI 레이블이 사실 목록에서 유래함. 스크립트에는 최소 하나의 정직한 한계와 정확히 세 개의 기능 스택이 있음.
  • 캡션: 단어당 하나의 태그, 기울어짐, 시작 시 팝업, 13개의 페이지, 6880% 대역, 얼굴 위에 절대 표시되지 않음.
  • 채도는 캐릭터, 캡션 및 신호에만 사용됨.
  • 모든 강세 단어에 시각적 이벤트가 있고, 앰비언트 모션이 항상 실행됨.
  • 배너 변경 시 컷(투어 및 뉴스에서 세트 1.5~3초, 은유 비트에서 최대 5초), 하단 20%는 깨끗함.
  • HOOK 블록(SAY / WRITE / SHOW / ALIGN)이 정확히 작성된 대로 화면에 표시됨: 프레임 0은 SHOW 순간이 동작 중이고 WRITE 제목이 그 위에 있으며, 첫 번째 VO 라인은 SAY임.
  • 모든 장면에 카메라 이동이 있고, 최대 한 번의 페이지 넘기기 또는 찢기, CTA로의 테이프 당기기 또는 휘둘러치기, 모든 전환에 SFX가 있음.
  • 유머 패스가 화면에 보임: 전체에 걸쳐 하나의 형식, 아이디어당 하나의 의상 소품, 하나의 고군분투 비트, 프레임 0 소품이 CTA 세트에서 변경되어 돌아옴, 모든 개그가 1초 이내에 읽히고 배너, 캡션 또는 주요 숫자를 가리지 않음.
  • VO 및 배너의 어휘가 SERIES.md의 대상 수준과 일치함.
  • 보이스오버, 캡션 및 이벤트가 동기화됨(모든 컷에서 스튜디오를 스크러빙).

실패한 항목이 있으면 장면 파일(또는 라이브러리의 키트, 프로젝트의 src/lib/는 절대 안 됨)을 수정하고 해당 장면을 다시 실행하세요. motion-build로 장면을 다시 빌드하세요.

3. 전달

스튜디오 미리보기를 열고, 타이밍과 함께 장면을 나열하고, 무엇이 플레이스홀더인지 말하세요: 음성, 음악, SFX, 에셋. 음성이 플레이스홀더인 경우, 다시 음성 녹음하는 방법을 말하세요(motion-voice). 게시 후, 숫자는 분석을 위해 motion-strategy로 전달됩니다.

원칙 검사

하나의 장면을 5fps로 스크러빙하고 $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md와 비교하세요: 각 큰 움직임 전에 예상 동작(2), 모든 것이 이징 처리됨(6), 충격 후에 무언가 따라오는 움직임(5), 하나의 초점 소품(3), 하나의 과장된 비트(10), 겹쳐진 음영과 일관된 그림자(11).

인계

수정 사항은 motion-build(장면 또는 사운드) 또는 motion-voice(싱크)로 돌아갑니다. 깔끔한 통과는 릴을 종료합니다: 사용자가 요청할 때 $MOTION_LIB/core/tools/render.sh로 렌더링하세요.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

관련 스킬