VS Codeの「chat.agentSkillsLocations」でCopilot ChatのスキルをClaude Code/Codexと共存させる

Posted at 2026-06-16

TL;DR

VS Code の GitHub Copilot Chat は、特定ディレクトリに置いた SKILL.md を「スキル（カスタムコマンド）」として自動で読み込む
読み込み先は chat.agentSkillsLocations 設定で制御できる
デフォルトでは .github/skills / .claude/skills / .copilot/skills あたりがスキャン対象になっており、Claude Code や Codex のスキルと併用すると Copilot Chat にスキルが二重表示される
値には ディレクトリの相対パスを書く。グロブ＋ファイル名（.agents/skills/**/SKILL.md）はNGで Paths must be relative... のリントエラーになる

// .vscode/settings.json
"chat.agentSkillsLocations": {
  ".agents/skills": true,
  ".claude/skills": false
}

最近は1つのリポジトリに対して

…と、複数のAIコーディングエージェントを併用する人が増えてきました。

このとき悩ましいのが 「スキル（SKILL.md）の置き場所」 です。
各エージェントが独自のディレクトリ規約を持っているため、共有しようとすると重複読み込みが起きがちです。

.agents/skills に置いたスキルを Claude Code / Codex 側にも読み込ませるため、.claude/skills にシンボリックリンクを作成しました。

すると、Copilot Chat のスキル一覧に同じスキルが2つずつ表示されるようになりました。

原因はシンプルで、Copilot Chat が

の両方を読み込んでいたためです。同じ実体を2か所から拾っているので、当然ダブります。

.vscode/settings.json（またはユーザー設定）に chat.agentSkillsLocations を書くと、スキルの読み込み先ディレクトリを明示的に指定できます。

値は { "ディレクトリパス": boolean } のマップで、true で有効・false で無効です。

二重表示を解消するには、「使いたい場所だけ true、ダブる原因の場所を false」にします。

// .vscode/settings.json
{
  // ...
  "chat.agentSkillsLocations": {
    ".agents/skills": true,
    ".claude/skills": false,
  },
}

これで .agents/skills 由来のスキルだけが1回ずつ表示されるようになりました。

重複の原因が .claude/skills ではなく .copilot/skills や .github/skills 側だった場合は、false にするキーをそちらに変えてください。

最初、こう書いてリントエラーを食らいました。

// ❌ NG
"chat.agentSkillsLocations": {
  ".agents/skills/**/SKILL.md": true
}

出たエラー

Paths must be relative or start with '~/'.
Absolute paths and '\' separators are not supported.

chat.agentSkillsLocations のキーは 「ディレクトリの相対パス」 を期待しており、

という仕様です。

SKILL.md まで含めてしまうのが間違いで、スキルが入っているディレクトリだけを指定すれば、その配下を再帰的に探してくれます。

// ✅ OK
"chat.agentSkillsLocations": {
  ".agents/skills": true,
  ".claude/skills": false
}

Copilot 拡張は、明示設定がなくても以下のようなディレクトリを既定でスキャンします（環境・バージョンにより差異あり）。

つまり Claude Code 用に .claude/skills を用意しているだけで、Copilot 側も勝手に拾うということです。これが今回の二重表示の正体でした。

「他エージェント用のディレクトリも Copilot に読まれている」と意識しておくと、重複に気づきやすくなります。

"chat.agentSkillsLocations": {
  ".agents/skills": true,
  ".claude/skills": false
}

現場からは以上です。