Communitygithub.com

code-motion-director

技術クリエイター、教育者、開発者向けに、アニメーション付きコードウォークスルー、コード説明動画、ターミナル実行リールを生成します。プログレッシブなタイプライター打ち、フォーカス行のディミング、リーダー吹き出し、アニメーション付きターミナル標準出力を特徴とします。ユーザーが /code-motion を実行したり、コードをアニメーション化、コーディングリールの作成、シンタックスウォークスルーの作成、コード実行の可視化を依頼したときに使用します。

code-motion-director とは?

このスキルは、`/code-motion-director` を介して、技術デモや教育コンテンツに最適な、アニメーション化されたコードウォークスルーとターミナル実行リールを生成します。これは、説明用の吹き出し、可変速度のタイプライター打ち、および無関係なコード行を暗くするフォーカス行を備えた、視覚的に魅力的なコードビデオを作成する必要がある開発者、教育者、および技術クリエイター向けに設計されています。このツールは、Claude Code、Google Antigravity、ChatGPT、およびGeminiを含む複数のAIプラットフォームと統合されており、外部のAI APIキー、依存関係、または有料のクラウドサービスを必要とせず、スタンドアロンで実行されます。ユーザーはコードスニペットを提供し、好みのアスペクト比(ソーシャルリール用の9:16またはワイドスクリーン用の16:9)、テーマ(Obsidian、OneDarkなど)、編集用の吹き出しを指定するJSON仕様を作成し、スキルはPlaywrightまたはPuppeteerを使用してインタラクティブなHTMLプレイバックまたはMP4ビデオをレンダリングします。これにより、開発者が共有可能なコード説明やデモを簡単に作成できるようにします。

対応✓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;            │
├──────────────────────────────────────┤
│ > TERMINAL EXECUTION                 │  スライド式ターミナルドロワー
│ > POST /api/v1/auth/verify HTTP/1.1  │  アニメーション化されたstdoutログ
│ > Status: 200 OK (14.2ms)            │
└──────────────────────────────────────┘

初回使用

このスキルのディレクトリは、スキルパッケージのベースディレクトリです。

# Python 3がインストールされていることを確認
python3 --version || python --version

外部のAI APIキー、重い依存関係、または有料のクラウドAPIを必要とせず、スタンドアロンで実行されます。ヘッドレスHTML5 Canvas / SVGを使用し、オプションでPlaywright、Puppeteer、またはffmpegを使用してヘッドレスMP4レンダリングを行います。


エージェント実行手順

  1. コードとストーリーボード: ユーザーにコードスニペットを依頼するか、リクエストから抽出します。核となるナラティブを特定します。
    • どの言語か?(JavaScript、TypeScript、Python、Rust、Go、SQL、Bash、HTML/CSS)。
    • 焦点は何か?(例:async/await呼び出し、デコレータ、エラースロー、再帰的リターン)。
    • それが機能することを証明するターミナル出力や実行結果は何か?
  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モバイル推奨: 1行最大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",
      "> Verifying HMAC-SHA256 signature...",
      "> Token Verified: 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: 各行が1行のコードを表す文字列の配列。
  • 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 / カスタムGPTadapters/chatgpt-instructions.md を使用してカスタム指示で設定
Google Geminiadapters/antigravity-gemini.md を使用してシステム命令で注入

テイストと美的基準

  • 明確な視覚的階層: コードはクリーンで、フォーマットされ、読みやすい状態に保ちます。ミニファイされたコードを貼り付けないでください。
  • 簡潔な吹き出し: 吹き出しの注釈は技術的事実であるべきで、マーケティングの誇大広告ではありません(「スーパークールな機能!」ではなく「プロミスを待機」)。
  • コントラストと可読性: コードフォントはモバイルスマートフォン画面で十分なサイズであることを常に確認します(1080x1920キャンバスで最低28px)。
  • ペーシング: タイピングは自然に感じられるべきです(1文字あたり25~40ミリ秒)。ターミナル出力は、コードのタイピングが完了した後に表示されるべきです。

関連スキル