≈1.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.
VS Code Custom Agents — 配置・アクセス制御リファレンス
Merged from former vscode-custom-agents skill (2026-02-26)
配置ルール（Critical）
.github/agents/ は直下のみスキャンされる
✅ 認識される
.github/agents/
├── orchestrator.agent.md
├── coding.executor.md
└── quality.reviewer.md
❌ 認識されない
.github/agents/
├── executors/
│ └── coding.executor.md ← 無視される
└── reviewers/
└── quality.reviewer.md ← 無視される
根拠: VS Code 公式ドキュメント (2026-02 時点)
"VS Code detects any .md files in the .github/agents folder of your workspace as custom agents."
サブディレクトリの再帰スキャンは非対応（実証テスト済み）。
配置場所の選択肢
| 場所 |
用途 |
.github/agents/ (ワークスペース) |
チーム共有。そのワークスペースでのみ有効 |
| ユーザープロファイル |
個人用。全ワークスペースで有効 |
chat.agentFilesLocations 設定 |
追加パスを指定。サブフォルダ指定にも使える |
ファイル拡張子
| 場所 |
拡張子 |
.github/agents/ |
.agent.md または .md（どちらも認識される） |
.claude/agents/ |
.md（Claude Code 互換） |
アクセス制御（3段階）
frontmatter プロパティ
| プロパティ |
デフォルト |
効果 |
user-invocable |
true |
false → ピッカーに非表示 |
disable-model-invocation |
false |
true → サブエージェントとして呼ばれない |
agents (親側) |
* (全許可) |
特定エージェント名リスト → 許可リスト |
重要: agents リストに明示すると disable-model-invocation: true をオーバーライドできる。
パターン早見表
# 1. ユーザーが直接呼ぶ + サブエージェントとしても呼ばれる（デフォルト）
user-invocable: true # (省略可)
# 2. サブエージェント専用（ピッカー非表示）
user-invocable: false
# 3. ユーザー専用（他エージェントから呼ばれない）
disable-model-invocation: true
# 4. 特定の親からのみ呼ばれるサブエージェント
user-invocable: false
disable-model-invocation: true
# → 親側の agents リストに明示して呼ぶ
⚠️ Deprecated プロパティ
| 旧 |
新 |
移行方法 |
infer: true |
user-invocable: true (デフォルト) |
行を削除するか置換 |
infer: false |
user-invocable: false |
置換 |
target: vscode |
— |
削除（不要） |
Orchestrator + Workers パターン
# orchestrator.agent.md
---
name: orchestrator
user-invocable: true
disable-model-invocation: true
tools: ["codebase", "terminal", "agent"] # "agent" が必須
agents:
- coding-executor
- quality-reviewer
---
# coding.executor.md
---
name: coding-executor
user-invocable: false
tools: ["codebase", "terminal"]
---
ポイント:
- orchestrator に
agent ツールを含めないとサブエージェント呼び出しが機能しない
agents リストで呼び出せるサブエージェントを制限するagents: [] で全サブエージェント利用を禁止agents: '*' で全許可（デフォルト）
トラブルシューティング
| 症状 |
原因 |
対処 |
| ピッカーに出ない |
サブフォルダに配置 |
.github/agents/ 直下に移動 |
| ピッカーに出ない |
user-invocable: false |
意図的なら OK |
runSubagent で "not found" |
認識されていない |
直下に配置されているか確認 |
| サブエージェントが呼ばれない |
親に agent ツールがない |
tools に "agent" を追加 |
| 意図しないエージェントが呼ばれる |
agents リスト未指定 |
親側で agents: [...] を明示 |
デバッグ方法
- Chat Diagnostics: チャットビューで右クリック → Diagnostics で認識エージェント一覧を確認
runSubagent テスト: サブエージェントを直接呼び出して応答確認- セッションコンテキスト確認:
<agents> タグに何が注入されているかで認識状態を判定
