/code-motion-director
┌──────────────────────────────────────┐
│ 🔴 🟡 🟢 src/auth/session.ts [9:16]│ mac 타이틀 바 + 파일 경로
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02 const decoded = await verify(); │ 활성 라인 포커스
│ 03 if (!decoded.valid) { ┌─────┼─ 01 토큰 검증
│ 04 throw new AuthError(); │ │
│ 05 } │ 비활성 라인 흐리게
│ 06 return decoded.user; │
├──────────────────────────────────────┤
│ > 터미널 실행 │ 슬라이딩 터미널 드로어
│ > POST /api/v1/auth/verify HTTP/1.1 │ 애니메이션 stdout 로깅
│ > 상태: 200 OK (14.2ms) │
└──────────────────────────────────────┘
첫 사용
이 스킬의 디렉토리는 스킬 패키지의 기본 디렉토리입니다.
# Python 3가 설치되어 있는지 확인
python3 --version || python --version
외부 AI API 키, 무거운 종속성 또는 유료 클라우드 API 없이 독립적으로 실행됩니다. 헤드리스 HTML5 Canvas/SVG를 사용하며, 헤드리스 MP4 렌더링을 위해 선택적으로 Playwright, Puppeteer 또는 ffmpeg를 지원합니다.
에이전트 실행 단계
- 코드 및 스토리보드: 사용자에게 코드 스니펫을 요청하거나 요청에서 추출합니다. 핵심 내러티브를 식별합니다.
- 어떤 언어인가요? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS)
- 초점은 무엇인가요? (예: async/await 호출, 데코레이터, 에러 throw, 재귀 반환)
- 어떤 터미널 출력 또는 실행 결과가 작동을 증명하나요?
- 사양 생성: 작업 디렉토리에
<name>.code.json(아래 상세 사양 참조)을 작성합니다. - 빌드 및 렌더링: 빌더 스크립트를 실행합니다.
python build.py <name>.code.json- 즉시 대화형 HTML 재생을 위해 생성된
<name>.motion.html을 엽니다. - 정적 프레임 스냅샷을 보려면:
python build.py <name>.code.json --snap 4.5. - 스키마 구문을 검증하려면:
python build.py <name>.code.json --validate.
- 즉시 대화형 HTML 재생을 위해 생성된
- 품질 검사:
- 코드 줄이 수평 오버플로 없이 적절하게 맞는지 확인합니다 (9:16 모바일의 경우 줄당 최대 48자 권장, 16:9의 경우 최대 80자).
- 콜아웃은 간결하고, 01에서 03까지 번호가 매겨져 있으며, 대상 라인을 명확하게 가리켜야 합니다.
- 터미널 출력은 실제 실행 동작을 정확하게 반영해야 합니다.
- 인계: 렌더링된 HTML/비디오 경로와 사양 요약을 사용자에게 전달합니다.
사양 형식 (<name>.code.json)
{
"title": "src/auth/session.ts",
"language": "typescript",
"aspectRatio": "9:16",
"theme": "obsidian",
"code": [
"async function verifyToken(token: string) {",
" const session = await auth.verify(token);",
" if (!session.isValid) {",
" throw new UnauthorizedError('Expired');",
" }",
" return session.user;",
"}"
],
"focusLines": [2, 3],
"typingSpeed": 35,
"callouts": [
{
"line": 2,
"label": "비동기 검증",
"note": "암호화 서명 대기",
"side": "right"
},
{
"line": 4,
"label": "가드 절",
"note": "만료된 JWT 페이로드 거부",
"side": "right"
}
],
"terminal": {
"enabled": true,
"title": "서버 출력 (Node.js v22)",
"commands": [
"$ curl -X POST https://api.dev/auth/verify",
"> HMAC-SHA256 서명 확인 중...",
"> 토큰 확인됨: user_id=4092 [200 OK]"
]
},
"sound": {
"typewriterClicks": true,
"completionChime": true
},
"durationSeconds": 8.0
}
매개변수 정의
title: 창 헤더 표시줄에 표시될 문자열 (예: 파일명 또는 모듈 경로).language:"javascript","typescript","python","rust","go","sql","bash".aspectRatio:"9:16"(TikTok/Shorts/Instagram용 세로 릴) 또는"16:9"(가로 와이드스크린).theme:"obsidian"(짙은 어두운 보라색),"onedark"(Atom 스타일),"monokai"(클래식 고대비), 또는"cyberpunk"(네온 시안/마젠타).code: 각각 코드 한 줄을 나타내는 문자열 배열.focusLines: 100% 밝기로 유지하고 다른 라인은 흐리게 할 1부터 시작하는 라인 번호 배열.callouts: 선택적 주석 목록. 최대 3개의 콜아웃을 권장합니다.line: 리더 라인을 고정할 1부터 시작하는 라인 번호.label: 짧은 대문자 또는 굵은 제목 (최대 18자).note: 설명 부제목 (최대 28자).
terminal: stdout 명령어와 응답이 있는 선택적 하단 드로어.sound: 선택적 Web Audio API 절차적 합성 설정 (타이핑 클릭 및 차임).durationSeconds: 총 애니메이션 지속 시간 (기본값: 8.0초).
지원 플랫폼
| 플랫폼 | 통합 방법 |
|---|---|
| Claude / Claude Code | ~/.claude/skills/code-motion-director/ 또는 작업 공간 .claude-plugin/에 SKILL.md를 통해 로드됨 |
| Google Antigravity | .gemini/antigravity/skills/code-motion-director/ 아래에 등록됨 |
| ChatGPT / Custom GPTs | adapters/chatgpt-instructions.md를 사용한 사용자 정의 지침을 통해 구성됨 |
| Google Gemini | adapters/antigravity-gemini.md를 사용한 시스템 지침을 통해 주입됨 |
취향 및 미적 기준
- 명확한 시각적 계층 구조: 코드를 깔끔하고 형식에 맞게 가독성 있게 유지하세요. 축소된 코드를 붙여넣지 마십시오.
- 간결한 콜아웃: 콜아웃 노트는 마케팅 과장이 아닌 기술적 사실이어야 합니다 ("멋진 기능!"이 아닌 "프라미스 대기").
- 대비 및 가독성: 코드 글꼴이 모바일 스마트폰 화면에서 충분히 큰지 항상 확인하십시오 (1080x1920 캔버스에서 최소 28px).
- 속도 조절: 타이핑은 자연스러워야 합니다 (문자당 25–40ms). 터미널 출력은 코드 타이핑이 완료된 후에 나타나야 합니다.