Communitygithub.com

code-motion-director

개발자, 교육자, 기술 크리에이터를 위한 애니메이션 코드 워크스루, 코드 설명 비디오, 터미널 실행 동영상을 생성합니다. 프로그레시브 타자기 효과, 초점 라인 디밍, 리더 콜아웃, 애니메이션 터미널 stdout을 지원합니다. 사용자가 /code-motion을 실행하거나 코드 애니메이션, 코딩 릴 생성, 구문 워크스루, 코드 실행 시각화를 요청할 때 사용하세요.

code-motion-director란 무엇인가요?

code-motion-director는 개발자, 교육자, 기술 크리에이터가 코드 조각, 터미널 출력 및 설명을 전문적으로 제작된 애니메이션 비주얼로 변환할 수 있도록 설계된 AI 에이전트 기술입니다. JavaScript, TypeScript, Python, Rust, Go 등 다양한 언어를 지원하며, 세로(9:16) 및 가로(16:9) 화면 비율 옵션을 제공하여 TikTok, YouTube Shorts와 같은 소셜 미디어 플랫폼이나 프레젠테이션에 최적화된 콘텐츠를 제작할 수 있습니다. 이 기술은 사용자의 코드 스니펫 또는 설명을 기반으로 JSON 기반 사양 파일(`<name>.code.json`)을 생성한 후, Python 빌드 스크립트(`build.py`)를 사용하여 오프라인에서 완전히 실행되며, 결과물로 HTML 미리보기 또는 정적 스냅샷을 제공합니다. 핵심 기능으로는 코드 줄의 점진적 타이핑, 특정 라인에 집중 및 나머지 영역 디밍, 번호가 매겨진 콜아웃을 통한 주요 로직 설명, 그리고 사실적인 명령어 출력을 재현하는 터미널 드로어가 포함됩니다. 이 도구는 Claude Code, Google Antigravity, ChatGPT와 같은 주요 AI 플랫폼과의 통합을 지원하며, 외부 AI API 키나 유료 클라우드 서비스 없이 헤드리스 HTML5 Canvas/SVG를 사용하여 MP4 비디오 렌더링을 위한 선택적 Playwright/Puppeteer/ffmpeg 지원을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/ishtiyaq8811/code-motion-director/tree/HEAD

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

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

문서

/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를 지원합니다.


에이전트 실행 단계

  1. 코드 및 스토리보드: 사용자에게 코드 스니펫을 요청하거나 요청에서 추출합니다. 핵심 내러티브를 식별합니다.
    • 어떤 언어인가요? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS)
    • 초점은 무엇인가요? (예: async/await 호출, 데코레이터, 에러 throw, 재귀 반환)
    • 어떤 터미널 출력 또는 실행 결과가 작동을 증명하나요?
  2. 사양 생성: 작업 디렉토리에 <name>.code.json (아래 상세 사양 참조)을 작성합니다.
  3. 빌드 및 렌더링: 빌더 스크립트를 실행합니다.
    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.
  4. 품질 검사:
    • 코드 줄이 수평 오버플로 없이 적절하게 맞는지 확인합니다 (9:16 모바일의 경우 줄당 최대 48자 권장, 16:9의 경우 최대 80자).
    • 콜아웃은 간결하고, 01에서 03까지 번호가 매겨져 있으며, 대상 라인을 명확하게 가리켜야 합니다.
    • 터미널 출력은 실제 실행 동작을 정확하게 반영해야 합니다.
  5. 인계: 렌더링된 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 GPTsadapters/chatgpt-instructions.md를 사용한 사용자 정의 지침을 통해 구성됨
Google Geminiadapters/antigravity-gemini.md를 사용한 시스템 지침을 통해 주입됨

취향 및 미적 기준

  • 명확한 시각적 계층 구조: 코드를 깔끔하고 형식에 맞게 가독성 있게 유지하세요. 축소된 코드를 붙여넣지 마십시오.
  • 간결한 콜아웃: 콜아웃 노트는 마케팅 과장이 아닌 기술적 사실이어야 합니다 ("멋진 기능!"이 아닌 "프라미스 대기").
  • 대비 및 가독성: 코드 글꼴이 모바일 스마트폰 화면에서 충분히 큰지 항상 확인하십시오 (1080x1920 캔버스에서 최소 28px).
  • 속도 조절: 타이핑은 자연스러워야 합니다 (문자당 25–40ms). 터미널 출력은 코드 타이핑이 완료된 후에 나타나야 합니다.

관련 스킬