エージェント・スキルの仕組み:30~50トークンの段階的情報開示システム
anthropicagentstutorialclaudedeveloper-tools
観点
これは、エージェント・スキルがどのように機械的に機能するかに関する公式Anthropicの説明です - 短く、実用的です。
段階的情報開示システム。 スタートアップ時には、インストールされた各スキルの名前と説明のみがシステムプロンプトにロードされます - スキルあたり約30~50トークンです。これにより、Claudeはコンテキストを消費することなくスキルを認識できます。ユーザープロンプトがスキルの説明と一致すると、Claudeはスキル.mdを動的にロードします。そのスキルが他のファイルやスクリプトを参照している場合、それらは必要に応じて段階的にロードされます。その結果:コンテキストを圧迫することなく、複雑なタスク用に多くのスキルをインストールできます。
スキルが他のClaudeの機能とどのように関わるか:
- Claude.md = プロジェクト固有のコンテキスト(技術スタック、コーディング規約、リポジトリ構造)。コードと並んで存在します。「Next.jsとTailwindを使用しています。」
- スキル = あらゆるプロジェクトで機能する移植可能な専門知識。タイポグラフィ標準を教える フロントエンド設計スキルはUI構築時に自動的に起動します。
- MCPサーバー = ClaudeをGitHub、Linear、Postgresなどの外部ソースに接続するユニバーサル統合プロトコル。「MCPはデータに接続します。スキルはClaudeにそのデータで何をするかを教えます。」
- サブエージェント = 固定の役割を持つ、独自のコンテキストウィンドウを持つ、カスタムプロンプトを持つ専門化されたAIアシスタント。スキルはあらゆるエージェントが使用できる移植可能な専門知識を提供します。
シナジー:Claude.mdが基盤を設定 → MCPサーバーがデータに接続 → サブエージェントが特化 → スキルが専門知識をもたらします。
重要なポイント
- スキルあたり30~50トークン - スタートアップ時には名前/説明のみがロードされ、一致時にフルコンテンツがロードされます。
- 段階的ロード - スキル.mdはマッチ時にロードされ、参照されるファイル/スクリプトは必要に応じてロードされます。
- サーフェス全体で移植可能 - Claude Code、API、およびclaude.aiで機能します。
- Claude.md = プロジェクト、スキル = 専門知識 - Claude.mdはレポジトリ固有です。スキルはプロジェクト全体で再利用可能です。
- MCP = データ、スキル = 対応方法 - MCPはアクセスを提供します。スキルはパターン(クエリ最適化など)を教えます。
- サブエージェントはスキルを共有できます - フロントエンドエージェントとレビュアーの両方がアクセシビリティスキルを使用できます。
- ユースケース - 新入社員のオンボーディング、PR セキュリティプラクティス、データ分析方法。
全体像
スキルは段階的情報開示を使用して、数百の機能を各30~50トークンにパック化します - 必要な場合にのみフルコンテンツをロードします。データ用のMCPとプロジェクトコンテキスト用のClaude.mdと組み合わせることで、スキルは一般的なエージェントを専門化されたエージェントに変える専門知識層を形成します。