움직임의 견본책 (Motion Specimen Book)
말로 표현하기 어려운 움직임을 번호로 전달하기 위한 견본책입니다. 사용자는 견본을 눈으로 보고 선택한 후 번호로 지시합니다. 이 스킬은 그 번호로부터 '무엇을 어떻게 움직일지'의 사양을 꺼냅니다.
| 권 | 번호 | 내용 | 꺼낼 수 있는 것 |
|---|---|---|---|
| 01 | AE-001~AE-322 | After Effects에 기본으로 포함된 텍스트 애니메이션 프리셋 | 정식명·카테고리·움직임 설명·단위/순서/변경되는 항목/가속도/길이. 곡선적인 움직임은 참고용 수식 포함 |
| 02 | MG-001~MG-137 | 모션 그래픽스에서 자주 사용하는 움직임 | 이름·해설(구조와 사용처)·견본을 그리고 있는 Canvas 2D 코드 세트 |
| 03 | VT-001~VT-130 | 음성 합성에서 사용하는 오디오 태그 | 태그·효과·예문·출처·사용법 |
도구는 이 파일과 같은 폴더의 scripts/specimen.mjs입니다(아래 <skill-dir>은 이 SKILL.md가 있는 폴더). Node.js 18 이상에서만 작동하며, 통신은 하지 않습니다(pick이 사용자 PC 내에서만 대기합니다).
node <skill-dir>/scripts/specimen.mjs <command>
| 명령어 | 사용처 |
|---|---|
get <번호...> | 번호의 사양을 출력합니다. AE-058, ae58, #MG-011, 견본책 URL 모두 가능합니다. 한 번에 최대 12개까지 |
search <단어...> | 단어로 검색합니다. 일본어나 영어 모두 가능합니다. 예: search 텍스트 바운스, search wipe transition. `--book ae |
list | 3권의 분류와 개수. --book ae를 붙이면 해당 권의 전체 항목을 한 줄씩 |
| `table --book ae | mg |
pick | 견본책을 브라우저에서 열고, 사용자가 선택하여 'AI에게 전달'을 누를 때까지 기다립니다. 선택된 번호의 사양과 메모를 출력하고 종료합니다 |
info | 데이터 버전, 개수, 견본책 위치 |
공통: --lang en으로 영어, 없으면 일본어.
진행 방법
- 번호를 말하면 먼저
get. 사용자가 번호로 지시하면, 그 번호를 그대로get에 전달하고, 출력된 사양을 읽은 후 작업합니다. 이름만 보고 상상하여 만들지 않습니다. - 붙여넣은 내용도 동일하게 처리. 견본책의 '선택한 것을 복사'로 만들어진 문장('움직임의 견본책에서 다음 N개를 선택했습니다'로 시작)에는 이미 사양이 포함되어 있습니다. 그대로 사용하고, 부족하면
get으로 다시 조회합니다. 끝의 '메모:'는 사용자의 지시입니다. - 선택하게 하려면
pick. 사용자가 '보고 선택하고 싶어', '어떤 게 있어?'라고 말하면pick을 실행합니다. 상황을 알면--book으로 권을 한정합니다(텍스트 움직임=ae, 도형이나 전환=mg, 목소리=vo).- 실행하면 URL이 표시되고 브라우저가 열립니다. 사용자에게 '견본을 선택하고 오른쪽 아래의 "AI에게 전달"을 눌러주세요'라고 전달합니다.
- 최대 15분 기다립니다(
--timeout 초로 변경). 쉘 실행 시간에 제한이 있는 환경에서는 백그라운드에서 실행하여 종료를 기다리거나 짧은--timeout을 지정합니다. - 종료 코드 0: 선택된 순서대로 번호의 사양과 메모가 출력됩니다. 종료 코드 4: 시간 초과로 아무것도 선택되지 않았습니다. 대신 선택하지 않고 사용자에게 묻습니다.
- 브라우저가 열리지 않으면 표시된 URL을 사용자에게 전달합니다. 그것도 불가능하면 견본책에서 '선택한 것을 복사'하여 붙여넣도록 합니다.
- 선택된 것만 사용합니다.
pick이나 붙여넣기로 전달된 번호는 확정입니다. 임의로 추가하거나 다른 번호로 바꾸지 않습니다. 상황에 맞지 않는다고 생각되면 이유를 말하고 묻습니다. - 찾을 때는
search. 사용자가 선택하지 않고 '좋은 느낌의 것을 골라줘'라고 맡겼을 때, 또는 견본책을 열 수 없는 환경에서 사용합니다. 이름이 아니라 설명문에서 어떤 일이 일어나는지 읽고 선택합니다.
권별 사용법
AE (After Effects 텍스트 프리셋)
- After Effects에서 만드는 경우, 정식명의 프리셋을 그대로 적용합니다. 위치는 '효과 및 프리셋 > 애니메이션 프리셋 > Text > (카테고리) > (정식명)'. 이것이 가장 정확합니다. 프리셋 파일(확장자
.ffx)은 After Effects 앱 폴더 안의Presets폴더에 있습니다. - After Effects 이외(Web, Canvas, Remotion, 동영상 생성 AI 지시 등)에서 재현하는 경우,
get의 사양으로 만듭니다. '움직이는 단위', '순서', '변경되는 항목', '겹치는 방식', '가속도', '길이'를 그대로 옮깁니다. 참고 수식이 첨부된 것은 수식의 숫자를 변경하지 않고 사용합니다. - 사양은 근사치입니다. 이름과 카테고리는 Adobe 공식 도움말 목록과 동일하지만, 움직임 사양은 After Effects 본체의 프리셋 파일에서 추출한 것이 아니라 견본책 제작자가 브라우저에서 재현한 것입니다. 실제와 다를 가능성이 있음을 사용자에게 보고할 때 한마디 추가합니다.
MG (모션 그래픽스 움직임)
get에서 출력되는 코드는 그 견본을 그리고 있는 것입니다.draw(c, t, s)와 보조 함수가 갖추어져 있어 그대로 동작합니다. 가로 320×세로 180,t는 1주기 내의 위치(0~1)입니다.- 다른 기술(CSS, SVG, Remotion, After Effects 키프레임)로 옮길 때는 코드 안의 초·지연·가속도·오버슈트량·거리·각도를 변경하지 않고 옮깁니다. 변경해도 되는 것은 표시할 텍스트, 색상, 로고나 이미지입니다.
- 해설문에 있는 초나 비율은 참고치입니다. 길이에 맞출 때는 비율을 유지하여 늘리거나 줄입니다.
VT (오디오 태그)
- 태그는 대괄호로 쓰고, 적용하고 싶은 단어 바로 앞에 둡니다. 같은 어조는 다음 태그까지 계속됩니다. 쉼표로 나열하면 중첩 적용할 수 있습니다(예:
[whispering, fearful]). - 대응은 ElevenLabs의 Eleven v4 / v4 Turbo / v3입니다. 태그는 정해진 목록이 아니라 자유로운 단어로 쓸 수 있지만, 반드시 효과가 있는 것은 아닙니다. 효과가 없으면 가까운 단어로 바꾸어 재생성합니다.
- 출처가 'Suno에서 사용되는 노래 태그'인 것은 노래를 만들기 위한 태그입니다. 읽기에서 효과가 있을 거라고 보장할 수 없음을 전달합니다.
- 음성 생성은 요금이 발생합니다. 사용자가 요청하지 않은 생성은 하지 않습니다.
지켜야 할 사항
- 번호가 견본책에 없으면 없다고 알리고
search의 후보를 제시합니다. 번호를 만들지 않습니다. - 한 번에 많이 조회하지 않습니다.
list와search는 후보를 찾기 위한 것이고,get은 실제로 사용할 몇 개를 위한 것입니다.table은 사용자가 번호표 자체를 요구했을 때만 사용합니다. - 작업 마지막에 사용한 번호와 이름, 어디에 사용했는지, 무엇을 변경했는지 보고합니다. 확인할 수 없었던 사항이 있으면 그것도 씁니다.
제대로 작동하지 않을 때
pick이 '견본책 위치를 알 수 없습니다'(종료 코드 3): 견본책 폴더가 있으면--site <폴더>, 공개된 URL을 알면--url <URL>을 지정합니다. 둘 다 없으면 사용자에게 번호를 묻거나 견본책에서 복사하여 붙여넣도록 합니다.- Node.js가 없는 경우:
data/catalog.json은 일반 JSON입니다.items[]의id·name·nameJa·ja·en으로 찾고,prompt.ja(또는prompt.en)가get출력과 동일한 문장입니다.