Communitygithub.com

motionable

motionable 내부 파이프라인(계획 모드, 승인, 장면, 음악, 비평, 렌더링). /motionable:scratch, :website 또는 :project로 시작하세요.

motionable란 무엇인가요?

motionable 'make' 스킬은 제품에 대한 정보(출처가 포함된 사실, 사용자 답변, 이미지 경로, 색상, 성격 노트)를 바탕으로 완성된 프로모션 영화를 제작하는 Claude Code용 전문 AI 에이전트 스킬입니다. 이 스킬은 계획(plan) 모드로 시작하여, 엄격한 규칙(rules.md)과 체크리스트(checklist.md)에 따라 제품의 고유한 방향성을 설정하고, 사용자의 승인을 받은 후 실제 영화를 빌드합니다. 빌드 단계에서는 장면(scene) 코드 작성, SVG 일러스트레이션 제작, 사운드 큐(sound cue) 설정, 컴파일 오류 수정 등을 자동으로 수행하며, 자체 비평(self-review)과 체크리스트 점수 평가를 통해 품질을 보장합니다. 최종적으로 사용자에게 MP4 파일과 함께 4라인 치료(treatment), 비평 로그, 그리고 컷에 대한 3-4개의 맞춤형 질문을 제공하여 반복적인 피드백을 통해 완성도를 높입니다. 이 스킬은 주로 Claude Code 환경에서 사용되며, 영화가 제품 저장소 내에 위치하지 않도록 하고, 사용자에게 스타일을 선택하도록 요청하지 않는다는 점이 특징입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

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

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

문서

motionable: make

당신은 제품에 대한 사실(각각 출처 포함), 사용자의 답변, 이미지 경로, 색상, 그리고 제품 성격에 대한 메모와 함께 이곳에 도착했습니다. 당신의 임무는 이 제품처럼 느껴지고, 스튜디오의 다른 어떤 영화와도 다른 완성된 영화를 만드는 것입니다.

ROOT는 motionable 루트입니다: ${CLAUDE_PLUGIN_ROOT}. 이것이 확장되지 않은 경우, 이 파일의 실제 경로(realpath)에서 두 수준 위에 있는 폴더(engine/ 및 scripts/를 포함)를 사용하십시오.

계획을 세우기 전에 ROOT/PLAN.md (계획 모드), ROOT/ENGINE.md (구성 요소), ROOT/rules.md (엄격한 규칙) 및 ROOT/checklist.md (비평)를 읽으십시오. ROOT/examples/owly/는 완성된 작업의 예시를 보여줍니다. 그 모양, 사운드 또는 구조를 절대 복사하지 마십시오: 이는 무한한 방향 중 하나일 뿐입니다.

1. 영화 만들기

  • 위치: 영화는 현재 폴더 (일반적으로 사용자의 스튜디오, 하이프 비디오용)에 <slug>/로 저장됩니다.
    • 현재 폴더가 제품 자체의 저장소인 경우, 대신 motionable/<slug>/를 사용하십시오.
    • /motionable:project로 제공된 제품 폴더에는 절대 쓰지 마십시오.
    • <slug>/가 이미 존재하는 경우, 새 버전(<slug>-2/)을 만들지, 해당 영화를 계속 진행할지 물어보십시오.
  • 만들기: bash ROOT/scripts/new.sh <film> "<Product name>"를 실행하십시오. 이 명령은 엔진을 영화 폴더로 복사하고 템플릿을 작성합니다.
  • 에셋: 이미지를 <film>/assets/에 명확한 이름(logo.png, screen-home.png…)으로 복사하십시오. 사용자가 브랜드 폰트 파일을 가지고 있다면 assets/fonts/에 넣으십시오.

2. 계획 모드 (내부 전용: 명령어 없음, 스타일 메뉴 없음)

PLAN.md를 처음부터 끝까지 따르십시오:

  1. 증거 보드 및 성격.
  2. 스토리: 약속, 시그니처 모멘트, 3개의 훅 → 1개.
  3. 모든 다이얼 설정, 각각의 이유 포함.
  4. 스튜디오 내 독창성: 다른 영화들의 DIRECTION.md › 지문(Fingerprint)을 읽으십시오. v0.2 이전에 제작된 영화는 지문이 없습니다. 이를 120 BPM A단조 하우스(좌측 정렬 헤드라인이 카드 위에 있음)로 취급하십시오.
  5. 선택된 템포로 DIRECTION.md 및 SCRIPT.md를 작성하십시오.

사용자에게 스타일을 선택하도록 요청하지 마십시오. 방향은 증거에서 나옵니다.

3. 한 번의 승인

4라인 치료(느낌 · 사운드 · 비주얼 · 시그니처 모멘트)와 간결한 비트 그리드(시간 · 화면 · 단어 · 연결)를 보여주십시오. 그런 다음, AskUserQuestion을 사용할 수 있으면 사용하고 (그렇지 않으면 채팅에서) 질문하십시오:

  1. 계획: 승인하거나, 변경할 사항이 있는지.
  2. 일러스트레이션: "이 영화를 위해 일러스트레이션을 그려야 할까요?" 예, 일러스트레이션을 그립니다 / 몇 가지 악센트만 / 아니요, 스크린샷과 타이포그래피만. 이유와 함께 하나를 추천하십시오 (PLAN.md §5).
    • 그리는 것은 무료입니다: Claude가 SVG를 작성합니다.
    • 세션에 이미지 생성 도구가 연결되어 있는 경우에만 이를 옵션으로 추가하고, 비용이 발생할 수 있다고 알리십시오.

승인 전에는 장면 코드를 작성하지 마십시오. 여기서 변경하는 것은 비용이 적게 듭니다.

4. 빌드

  1. 일러스트레이션 (예인 경우): 브랜드 색상과 하나의 선 두께로 SVG를 assets/drawn/에 작성하십시오 (ENGINE.md › 직접 그린 일러스트레이션). 각 일러스트레이션이 시트에서 렌더링된 모습을 보고, 어색한 것은 다시 그리십시오.
  2. scenes/Film.swift: 골격을 완전히 교체하십시오. 모든 값은 DIRECTION.md 및 SCRIPT.md에서 가져옵니다:
    • 시간은 enum T에 넣습니다;
    • 클립과 연결은 Reel에 넣습니다;
    • 화면은 프레이밍 호출을 통해 전달됩니다 (고정된 상자에 잘리지 않음);
    • 시그니처 모멘트는 실제 UI처럼 애니메이션되도록 다시 그려집니다. 먼저 위치를 측정하십시오: bash ROOT/scripts/inspect.sh <screenshot> find <its colour> (또는 row, column, pixel)는 정확한 링, 막대 및 텍스트 가장자리를 제공합니다.
    • 방향에 필요한 사용자 정의 요소는 자체 scenes/*.swift 파일에 넣습니다.
  3. 사운드: 방향의 Recipe + Sections를 s.compose를 통해 사용하고, 모든 그림 이벤트에 대해 시그니처 사운드를 사용하여 s.cue를 추가하십시오.
  4. 빌드 확인: bash ROOT/scripts/run.sh <film> sheet (시간 없음: 전체 영화 및 모든 연결). 컴파일 오류를 수정하십시오 (ENGINE.md › 주의사항).

5. 초안, 수정, 사용자에게 보여주기

초안 작업을 하고, 무한 반복하지 마십시오:

  1. 초안 1은 첫 번째 완전한 빌드입니다: 장면, 음악 및 모든 큐. 영화 자체에서 검토하십시오 (아래 단계); 이를 위해 비디오 파일이 필요하지 않습니다. (run.sh <film> draft는 사용자가 조기에 보고 싶어할 경우 작고 빠른 MP4를 렌더링합니다.)
  2. 자체 검토: 한 번의 패스와 모든 검사.
    • run.sh <film> check: 모든 ✗는 반드시 수정해야 합니다. 라인을 더 길게 유지하고, 더 일찍 시작하고, 단어를 줄이거나, 라인을 삭제하십시오. 입력된 라인에는 입력 시간 더하기 읽기 시간이 필요합니다. ⚠ 조언 (프레임 1, 리듬)도 따르되, DIRECTION.md에서 그 이유를 명시하지 않은 경우에만 따르십시오.
    • run.sh <film> sheet: checklist.md의 모든 범주에 점수를 매기고 8 미만인 것은 수정하십시오. 훅, 시그니처 모멘트 및 엔드 카드의 전체 크기 스틸을 살펴보십시오: UI를 읽을 수 있는지, 충돌하는 것은 없는지, 프레임의 모든 모서리가 어떤 작업을 하고 있거나 의도적으로 비어 있는지 확인하십시오.
    • 시청자가 싫어하는 것 (RESEARCH.md › 커뮤니티 확인): 읽기 너무 작은 UI, 큰 물체의 바운스, 동일한 길이의 샷, 재고 사운드 같은 음악, 느린 로고 모멘트.
    • run.sh <film> audio, 그런 다음 bash ROOT/scripts/compare.sh <film>: 다른 영화와 너무 유사한 경우, 이유를 들어 레시피를 변경하십시오.
    • 전체 영화를 단계별로 실행: run.sh <film> sheet $(seq 0.5 1 <length>) (초당 한 프레임). 단일 스틸이 숨기는 것을 찾으십시오: 비어 있는 장면, 움직임이 없는 비트, 거슬리는 연결, 장면이 사라질 때 나타나는 라인.
  3. 초안 2. 한 번에 발견된 모든 것을 수정한 다음 check와 sheet를 다시 실행하십시오.
    • 여전히 실패하는 것이 있으면, 최대 한 번 더 수정 패스를 허용하십시오.
    • 그 후에도 여전히 실패하면 계속하지 말고: 남은 문제와 그 이유를 사용자에게 알리십시오.
    • SCRIPT.md에 간단한 비평 로그를 유지하십시오: 무엇이 변경되었고 그 이유는 무엇인지.
  4. 실제 파일 렌더링: run.sh <film> video, 30초에 약 45초 소요.
  5. 보여주고 질문하기 (AskUserQuestion 사용 가능한 경우). MP4, 4라인 치료 및 비평 로그를 보낸 다음, 이 컷에 대한 3-4개의 맞춤형 질문을 하십시오. 각 질문에는 추천 옵션이 있어야 하며, "기타"를 통해 사용자가 원하는 것을 말할 수 있어야 합니다:
    • 페이싱: 적절함 / 더 느리게, 더 적은 라인 / 더 빠르게, 더 강력하게.
    • 사운드: 유지 / 더 많은 에너지 / 더 차분하게 / 다른 악기.
    • 훅: 유지, 또는 계획 모드의 다른 두 훅 후보 중 가장 강력한 것 (이름 지정).
    • 엔딩: 유지 / 출시 안전 엔딩 (예: 앱 출시 전 다운로드 배지 없음) / 가격 추가.
  6. 답변 라운드당 한 번 수정하고, check, audio 및 compare를 다시 실행한 다음 새 컷을 보여주십시오. 두 번의 사용자 라운드 후 중단 또는 계속할 것을 제안하십시오. 사용자가 결정합니다.

6. 배지 저장 (제품이 출시된 경우에만)

  • 앱 스토어 출시 및 사용자가 배지를 원하는 경우: Apple의 공식 배지 (약 11KB, 검정색, 영어 SVG; URL은 rules.md에 있음)를 assets/에 다운로드할 수 있는 권한을 요청하십시오.
    • drawAppStoreBadge로 그리고, 정적이며 절대 애니메이션되지 않습니다; 강조는 glowRing에서 옵니다.
    • 사용자가 애니메이션을 고집하는 경우, Apple의 규칙을 한 번 설명하십시오. 여전히 원한다면, 별도의 명확하게 명명된 변형으로 만드십시오.
  • Google Play: 앱이 출시되어 있고 사용자가 다운로드를 승인한 경우에만 배지를 사용하십시오. 그렇지 않으면, 최대한 일반 텍스트 한 줄, 그리고 사실인 경우에만.

7. 전달

보여주는 모든 컷에 다음을 포함하십시오:

  • 몇 줄의 치료;
  • 자체 검토에서 수정된 사항;
  • 비교 결과 및 check 판정;
  • 게시 전에 확인해야 할 주장;
  • 변경 방법: SCRIPT.md 또는 DIRECTION.md를 편집하거나, 그냥 말로 전달.

사용자가 만족한 후, 다음 유용한 항목을 제안하십시오:

  • 15초 컷, 또는 다른 형식 (1:1, 16:9);
  • A/B 테스트를 위한 훅 변형: 계획 모드의 다른 두 훅 후보로 시작하는 동일한 영화;
  • 출시 안전 엔딩 (앱 출시 전 "다운로드" 없음);
  • 이펙트 전용 버전 (run.sh <film> video effects), 플랫폼 사운드 또는 라이선스 트랙과 함께 게시용.

Individual skills in this repo

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

관련 스킬