Claude Code v2.1.91バグ: サブエージェントがスキルを読み込まない問題

Claude Codeにおけるマルチエージェントスキル読み込み問題

Claude Code v2.1.91でマルチエージェントシステムを構築している開発者が、重大な制限を発見しました：サブエージェントは.claude/skills/ディレクトリで定義されたスキルにアクセスできず、メインセッションではトリガーキーワード、コンテキスト内の完全なスキル内容、品質ゲートの遵守によりスキルが完璧に読み込まれます。

問題の詳細

subagent_typeを使用してAgentツール経由でサブエージェントを生成すると、そのエージェントはスキルにまったくアクセスできません。開発者は6つのアプローチをテストしました：

エージェントフロントマターのskills: - 「起動時に完全なスキル内容が注入される」と文書化されていますが効果なし
tools:リスト内のSkill - 認識されず、Skillツールはサブエージェントで利用不可
--agent myagent CLIフラグ - 同じ結果、スキルが読み込まれない
Agent Teams（TeamCreate） - 同じ結果
親セッションでネイティブにスキルを読み込んでからエージェントを生成 - エージェントは親のコンテキストを継承しない
ネイティブのClaudeスキル（frontend-design、claude-api）もサブエージェントで利用不可

設定例

エージェントファイルの構造：

---
name: Sales
description: "営業エージェント"
model: opus
skills:
- outreach
- validator
tools:
- Bash
- Read
- Write
- WebSearch
---

スキルは.claude/skills/outreach/SKILL.mdに適切なフロントマターで存在し、メインセッションでは完璧に動作します。

影響

この制限により、開発者によればマルチエージェントアーキテクチャは「ドメイン知識を必要とするあらゆる用途で役に立たない」ものとなっています。エージェントはスキルファイルをReadする（システム指示ではなくチャットコンテンツとして読み込まれる）ことしかできないため、出力の品質が大幅に低下します。メインセッション（スキルがネイティブに読み込まれる）とサブエージェント（スキルがマークダウンとして読み込まれる）の品質の差は「非常に大きい」と表現されています。

開発者はmacOSでClaude Code 2.1.91を実行しており、カスタムエージェントのフロントマターでskills:を正常に使用した人がいるか、これが既知の制限、バグ、または設定エラーなのかを質問しています。

📖 完全なソースを読む： r/ClaudeAI