エージェントスキルのインストール方法

スキルは SKILL.md ファイルを含むフォルダです。インストールとは、そのフォルダをエージェントが読み込む正しい場所に置くことです。各ツールごとの配置場所を説明します。

共通のアプローチ

すべてのエージェントは特定のディレクトリからスキルを読み込みます。スコープは 2 種類あります：

プロジェクトスキル

リポジトリ内に配置。バージョン管理にコミット済み。そのプロジェクトで作業する全員が利用可能。

個人スキル

ホームディレクトリに配置。すべてのプロジェクトで利用可能。自分だけが使用。

手動でダウンロードして保存

CLI ツール不要のシンプルな方法：

mdskills.ai でスキルを見つけ、詳細ページのダウンロードボタンをクリックする。
プロジェクト内にスキルフォルダを作成する。例えば Claude Code の場合：
mkdir -p .claude/skills/my-skill
そのフォルダ内に SKILL.md という名前でファイルを保存する：
mv ~/Downloads/SKILL.md .claude/skills/my-skill/
エージェントを再起動（または新しいセッションを開始）する。これでスキルが利用可能になります。

フォルダ名がスキル名になります。review-pr というフォルダは、スラッシュコマンドに対応するエージェントでは /review-pr コマンドになります。

保存場所は？ 使用するツールの正確なディレクトリパスは、以下のエージェント別ガイドを参照してください。簡単に言うと、ほとんどのエージェントはプロジェクトルートの .{agent}/skills/{name}/SKILL.md を使用します。

CLI でクイックインストール

GitHub リポジトリからスキルをインストールする最速の方法：

# Install from mdskills.ai

npx mdskills install <skill-name>

# Or use the Vercel CLI

npx skills add <owner>/<repo>

# Or install manually — just clone and copy

git clone https://github.com/owner/skills-repo.git

cp -r skills-repo/my-skill .claude/skills/

CLI ツールはインストール済みのエージェントを自動検出し、正しいディレクトリにスキルを配置します。ただし CLI は必須ではなく、フォルダを手動でコピーするだけでも同様に動作します。

エージェント別セットアップ

Claude Code

ドキュメント

プロジェクト：.claude/skills/<skill-name>/SKILL.md

個人：~/.claude/skills/<skill-name>/SKILL.md

Claude Code はスキルサポートが最も充実しています。スキルはスラッシュコマンドとして表示され、review-pr という名前のスキルは /review-pr になります。また Claude はリクエストがスキルの説明に一致する場合、スキルを自動的に読み込みます。

.claude/commands/ に既存のファイルがある場合、それらは引き続き機能します。スキルはより新しいフォーマットで、バンドルされたスクリプトやフロントマター設定などの追加機能をサポートしています。

Claude Code はプラグインもサポートしており、複数のスキルを MCP サーバーや他の拡張機能と一緒にまとめることができます。プラグインは CLI の /plugins からインストールしてください。

Cursor

ドキュメント

プロジェクト：.cursor/skills/<skill-name>/SKILL.md

個人：~/.cursor/skills/<skill-name>/SKILL.md

Cursor は 2026 年 2 月にマーケットプレイスをローンチし、プラグインシステムの一部としてスキルをサポートするようになりました。スキルは MCP サーバー・サブエージェント・フック・ルールと並ぶ 5 つのプラグインプリミティブのひとつです。

.agents/skills/ にスキルを配置することもできます。このパスは複数のエージェントで認識されるため、チームが異なるツールを使用している場合に適しています。

VS Code (Copilot)

ドキュメント

プロジェクト：.github/skills/<skill-name>/SKILL.md

個人：~/.copilot/skills/<skill-name>/SKILL.md

VS Code は GitHub Copilot を通じてエージェントスキルをサポートします。プロジェクトスキルは .github/skills/ に配置するため、コードと同様にバージョン管理で自動的に追跡されます。

VS Code は .claude/skills/ と .agents/skills/ も認識します。chat.agentSkillsLocations 設定で追加の検索パスを設定できます。

Copilot チャットで / を入力すると、利用可能なスキルが表示され、直接呼び出すことができます。

OpenAI Codex

ドキュメント

プロジェクト：.agents/skills/<skill-name>/SKILL.md

個人：~/.agents/skills/<skill-name>/SKILL.md

Codex はデフォルトで .agents/skills/ ディレクトリを使用します。これは複数のエージェントが認識するベンダー中立のパスで、異なるツールで動作するスキルを公開する場合に安全な選択肢です。

Gemini CLI

ドキュメント

プロジェクト：.gemini/skills/<skill-name>/SKILL.md

個人：~/.gemini/skills/<skill-name>/SKILL.md

Gemini CLI もフォールバックとして .agents/skills/ を読み込みます。Gemini CLI をターゲットとしている場合は .gemini/skills/ パスを使用してください。クロスエージェントの互換性のためには .agents/skills/ を使用してください。

クロスエージェント互換性

スキルを公開してどこでも動作させたい場合は、.agents/skills/ パスを使用してください。ほとんどのエージェントがこのディレクトリをフォールバックとして確認します。チーム全員が同じツールを使うプロジェクト固有のスキルには、ベンダー固有のパスを使用してください。

ヒント：同じスキルを複数のディレクトリに配置することができます。スキルを複数のパスにシンボリックリンクするチームもあり、使用するエージェントに関係なく動作します。ln -s コマンドで簡単に設定できます。

インストールの確認

スキルをインストールしたら、エージェントが認識できているか確認してください：

Claude Code：「利用可能なスキルは何ですか？」と尋ねるか、/ を入力してオートコンプリートメニューでスキルを確認する。
VS Code：Copilot チャットパネルで / を入力する。
どのエージェントでも：「[タスク]のスキルはありますか？」と尋ね、説明を認識するか確認する。

スキルが表示されない場合は、フォルダ構造を確認してください。ディレクトリ名には SKILL.md ファイルが含まれている必要があります（大文字小文字を区別します）。

インストールするスキルを探す →自分のスキルを作成する →ベストプラクティス →