문서
대부분은 에이전트와 대화하면 에이전트가 알아서 실행합니다. 이 페이지는 어떤 일이 일어나는지 알고 싶거나 직접 단계를 진행하고 싶을 때 참고하는 안내서입니다.
설치 및 로그인
npx -y motionkit-skills@latest setup위 명령어를 Claude Code, Codex 또는 터미널에 붙여넣으세요. 브라우저가 열리면 Google로 로그인하고 승인을 누르세요. 처음 한 번만 해당 페이지에 라이선스 키를 붙여넣으면 계정에 저장됩니다. Mac에서는 키가 키체인에 보관됩니다. 팩은 발견된 모든 에이전트(Claude Code, Codex, Cursor, OpenCode, Antigravity, Kimi)에 설치됩니다.
브라우저가 없는 컴퓨터에서는 키를 직접 전달하세요. setup --key -은 표준 입력에서 키를 읽습니다.
명령어
| 명령어 | 기능 |
|---|---|
setup | 팩을 설치하거나 업데이트하고 이 컴퓨터에 로그인합니다 |
doctor | Node.js, FFmpeg, Chrome, HyperFrames, 구독 상태를 확인합니다 |
voices / credits | 사용 가능한 음성과 이번 달 남은 음성 해설 크레딧을 보여 줍니다 |
voice <project> --script <file> --voice <id> | 모든 장면이나 슬라이드의 내레이션을 생성합니다. --tone "warm teacher" 표현력 있는 음성을 연출합니다 |
music <project> --bed calm|focus|bright|lofi | 포함된 배경 음악 중 하나를 추가합니다 |
share <project> [--deck] [--password …] [--public] | 영상이나 덱을 업로드하고 링크를 받습니다 |
shares / unshare <id> | 링크를 목록으로 보거나 삭제합니다. Studio에서는 조회수와 연습문제 답변도 볼 수 있습니다 |
logout | 이 컴퓨터에서 로그아웃하고 사용 중인 좌석을 반환합니다 |
각 명령어는 npx -y motionkit-skills@latest <command>로 실행합니다.
에이전트가 실행하는 도구
| 도구 | 기능 |
|---|---|
ingest | Word, PowerPoint, PDF, Markdown, 텍스트, 웹 페이지 링크, 공유된 Google Docs 문서를 읽어 챕터, 핵심 내용, 수치, 표로 정리하며, 각 항목에 원문의 해당 줄을 함께 표시합니다 |
panel | 로컬에서 실행되는 4단계 페이지입니다. 스타일 선택, 제작 과정 확인, 타임라인에서 검토 및 편집, 재생 및 공유를 할 수 있습니다 |
start | 하나의 스타일로 프로젝트를 시작하고 해당 스타일을 다운로드합니다 |
images | 장면에서 요청하는 이미지를 스타일에 맞는 느낌으로 그립니다 |
music | 설명을 바탕으로 영상 길이에 맞는 연주곡을 만듭니다 |
compose | video.json를 바탕으로 타이밍, 모션, 내레이션, 음악을 포함한 영상을 만듭니다 |
check | 화면에 표시된 모든 수치를 원문과 대조하고 타이밍과 연습문제 답변을 확인합니다 |
frames | 검토용으로 장면마다 이미지 한 장씩 저장합니다 |
render | HyperFrames로 내 컴퓨터에서 MP4를 렌더링합니다 |
build-deck | 다음에서 내레이션이 포함된 인터랙티브 덱을 만듭니다 deck.json |
deck-to-pptx | 덱을 PowerPoint 파일로 내보냅니다 |
모든 도구는 실행 전에 서버에서 구독 상태를 확인하므로 인터넷 연결이 필요합니다.
장면
영상은 video.json에 장면 목록으로, 덱은 deck.json에 목록으로 구성됩니다. 둘 다 title, section, stat, chart(막대 또는 선), steps, cards, compare, figure, quote, takeaway를 공통으로 사용합니다. 덱에서는 tabs, expand, quiz, match, sort, group, 원형 차트, 호버 팁도 추가로 쓸 수 있습니다.
핵심이 되는 단어는 별표로 감싸세요. 장면에 image를 넣으면 그에 맞는 그림이 만들어지고, narration를 넣으면 음성으로 읽어 줍니다.
요금제별 한도
| Creator | Studio | |
|---|---|---|
| 컴퓨터 | 2 | 10 |
| 월 음성 해설 크레딧 | 80,000 | 240,000 |
| 월 이미지 수 | 60 | 200 |
| 공유 링크 | 10 | 100개, 통계 포함 |
문제가 생겼을 때
- 도구에서 구독이 활성 상태가 아니라고 나옵니다. 요금제 페이지에서 구독을 갱신한 다음 설정을 다시 실행하세요.
- 렌더링에 실패합니다.
doctor을(를) 실행하세요. 빠진 항목과 설치 방법을 알려 줍니다. - 숫자가 거부됩니다. 원본에 없거나 표기가 다른 경우입니다. 검사를 바꾸지 말고 원본이나 장면을 수정하세요.
- 프록시 환경인 경우.
HTTPS_PROXY을(를) 설정하면 도구가 자동으로 적용합니다.
그 외 문의: support@motionforclaude.com.