Motion Skills
← ガイド

Claude Code・Codex・Cursor にスキルをインストールする方法

スキルは、SKILL.md ファイル（エージェントへの指示）とテンプレート、スクリプトが入ったフォルダーです。一度インストールすれば、依頼が合うたびにエージェントが使います。同じフォルダーが Claude Code、Codex、Cursor、Gemini CLI で使え、違うのは置き場所だけです。

フォルダーの場所は、2026年10月29日に各エージェントのドキュメントで確認したものです。

スキルとは

スキルはオープンな Agent Skills 形式に従います。スキルはスキル名を付けた 1 つのフォルダーで、次のものが入っています。

  • SKILL.md： 指示です。短いヘッダーに、スキルの name と、いつ使うかを示す description が書かれています。エージェントはこの説明を読んで依頼が合うかどうかを判断し、合えば残りを読みます。
  • 参考資料： 指示から参照される長めのメモで、必要なときだけ読まれます。
  • テンプレートとスクリプト： エージェントがコピーしたり実行したりするファイルです。動画のテンプレート、ブリーフのファイル、チェックなどがあります。

システム全体に何かがインストールされることはなく、アカウントも作られません。エージェントがフォルダーを読み、スキルのコマンドはあなたのプロジェクト内で実行されます。

いちばん速い方法：エージェントに頼む

スキルのページからインストール用プロンプトをコピーして、エージェントに貼り付けます。

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

エージェントはガイドを読み、npx motion-skills install <slug> というコマンドを 1 つ実行します。初回はブラウザーでページが開くので、Google でログインし、ターミナルに表示されたコードを承認してください。まだ持っていない有料スキルなら同じページで購入でき、インストールは自動で完了します。そのあとエージェントが最初の動画を作ります。（コマンドを実行できない場合、ガイドはブラウザーでのダウンロードに切り替えます。）

手動でインストール

  1. スキルのページから ZIP をダウンロードします。
  2. フォルダー名を保ったまま解凍します（<slug>/SKILL.md）：
    • Claude Code： ~/.claude/skills/<slug>/、またはプロジェクト内の .claude/skills/<slug>/
    • Codex： ~/.agents/skills/<slug>/
    • Cursor： プロジェクト内の .cursor/skills/<slug>/
    • Gemini CLI： ~/.gemini/skills/<slug>/
  3. エージェントの新しいセッションを始めて、スキルを読み込ませます。
mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

パソコンに必要なもの

  • Node.js 22 以降
  • FFmpeg（macOS では brew install ffmpeg）
  • Google Chrome（レンダラーがヘッドレスで操作します）

完全版スキルと無料の Motion Director スキルは、私たちのオープンなエンジン motion-skills（mo）で動き、初めてレンダリングするときに npx で自動的にインストールされます。モーションテンプレートは HyperFrames の CLI を使い、同じように自動でインストールされます。API キーは要りません。

スキルを使う

モーションテンプレートなら、頼むだけです：「Ship faster, sleep better と書かれた 9:16 のタイトルカードを作って」。エージェントがテンプレートをコピーし、brief.json を書き、hyperframes check を実行し、スナップショットのフレームでレイアウトの問題を確認してから MP4 をレンダリングし、保存場所を教えてくれます。

完全版スキルなら、素材を渡して映像の用途を伝えます。スキルは 3 つの方向性を実際のフレームで見せ、リズムシートとオリジナルの音楽を書き、mo のチェックとレビューを行ってから、あなたの Chrome で MP4 をレンダリングします。

実際の作例つきの詳しい手順は、Claude Code で動画を作る方法をご覧ください。Codex、Cursor、Gemini CLI の場合は、それぞれが読み込むすべてのフォルダーとあわせてCodex、Cursor、Gemini CLI で動画を作るで説明しています。

トラブルシューティング

  • エージェントがスキルを使わない。 インストール後に新しいセッションを始めてください。エージェントはセッションの開始時にスキルを読み込みます（Gemini CLI では /skills reload でその場で読み込めます）。そのうえで、スキル名を挙げてもう一度頼みます：「use the changelog-video skill」。フォルダーも確認してください。SKILL.md は <slug>/ の直下にある必要があり、解凍後に 1 階層深い場所にあってはいけません。
  • 「FFmpeg not found」と表示される。 FFmpeg をインストールし（macOS では brew install ffmpeg）、パスが通るように新しいターミナルを開いてください。
  • 「Chrome not found」と表示される。 Google Chrome をインストールしてください。レンダラーがヘッドレスで操作します。完全版スキルは mo doctor で、モーションテンプレートは node kit/doctor.mjs で、最初にこれを確認してくれます。
  • ログインページが開かない。 ターミナルにアドレスとコードが表示されるので、自分でアドレスを開いてコードを入力してください。

よくある質問

Claude Code ではスキルをどこに置きますか？

すべてのプロジェクトで使うなら ~/.claude/skills/<slug>/、1 つのプロジェクトだけなら、そのプロジェクト内の .claude/skills/<slug>/ です。フォルダーはスキルの名前のままにし、その中に SKILL.md を入れます。Claude Code の新しいセッションを始めると、スキルが読み込まれます。

SKILL.md とは何ですか？

エージェントへの指示を書いたファイルで、テンプレートやスクリプトと一緒にスキルのフォルダーに入っています。ヘッダーでスキルの名前といつ使うかを示しており、依頼が合うとエージェントがこのファイルを読みます。

スキルは Codex、Cursor、Gemini CLI でも使えますか？

はい。同じフォルダーがどれでも使え、違うのは場所だけです。Codex は ~/.agents/skills/<slug>/、Cursor はプロジェクト内の .cursor/skills/<slug>/、Gemini CLI は ~/.gemini/skills/<slug>/ です。

API キーは必要ですか？

いいえ。スキルは Node.js、FFmpeg、Chrome を使ってあなたのパソコン上で動き、エンジンは npx で自動的にインストールされます。必要なログインは、ダウンロードのための当サイトでの無料の Google アカウントだけです。