Agent Skills完全解説（まさお）

著者: まさお@未経験からプロまでAI活用
媒体: note
公開日: 2025-10-18

概要

Anthropic が発表した Claude の新機能「Agent Skills」について、概念・仕組み・MCPとの違い・ベストプラクティス・セキュリティ注意点を解説した記事。「コンテキストエンジニアリング」をスケーラブルにする大きな一歩と位置づけている。

主要トピック

Agent Skills とは

AIエージェントに特定タスクを実行させるための指示書・スクリプト・関連資料を一つのフォルダにまとめた「スキルセット」を、必要なタイミングで動的に読み込ませる仕組み
Anthropic は「新入社員へのオンボーディングガイドを作成するようなもの」と表現
組織の暗黙知を形式知化してClaudeに与えることで「即戦力のエキスパート」として機能させる

従来エージェントの課題

ツールが増えすぎると AI の「注意力」が分散し、どのツールを使うか判断に迷う
多数のツール定義が起動時にコンテキストウィンドウを圧迫する（コンテキストウィンドウの飽和）

Agent Skills vs MCP の違い

観点	MCP	Agent Skills
役割	個別ツールを「直接」追加するプロトコル	MCPツール群を目的ごとに「抽象化・パッケージ化」する上位レイヤー
比喩	職人に個別の道具（ハンマー・ノコギリ）を渡す	職人に「日曜大工セット」という道具箱を渡す
関係	基盤プロトコル	MCPを補完・活用する仕組み

Agent Skills は MCP を置き換えるものではなく、より効率的に活用するための上位概念。

段階的開示（Progressive Disclosure）

Agent Skills の核心的設計思想。情報を一度にすべて見せず、必要なタイミングで段階的に開示することでコンテキストウィンドウを効率化する。

3ステップ:

メタデータ読み込み: 起動時は各スキルの「名前」と「説明」だけをシステムプロンプトに読み込む（目次だけを見る）
SKILL.md 読み込み: タスクに関連するスキルが判断されたとき初めて SKILL.md（詳細手順・ルール）を読み込む
追加ファイル・コードの実行: さらに複雑な処理が必要な場合のみ、参照ファイルや Python スクリプトを追加で読み込む

ベストプラクティス（4つ）

評価駆動のアプローチ: エージェントを実際に動かして「どこでつまずくか」を観察し、課題ベースでスキルを構築
スケールを意識したファイル構造: SKILL.md に全情報を詰め込まず、同時に使われない情報は別ファイルに分割
AIの視点での名前と説明: name/description は「AIがいつ呼び出すかを判断するトリガー」として簡潔・具体的に記述
反復的な改善: Claude自身を開発パートナーとして対話しながらスキルを継続的に改善

セキュリティ注意点

信頼できるソースからのみインストール
Python スクリプト等の実行可能コードを必ず監査
外部ライブラリ・APIへの依存関係も確認

将来展望

スキルをパッケージ化・共有・販売するエコシステムの出現
MCPツール群をより複雑なワークフローの中でインテリジェントに使いこなす「手順書」としての機能
AIエージェント自身が成功・失敗体験から新しいスキルを自動生成・改善する自己進化の可能性

関連ページ

Agent Skills — 概念詳細ページ
Claude Code Skills — Claude Code における Skills 実装
MCP — Model Context Protocol（Agent Skills の基盤）
まさお@未経験からプロまでAI活用 — 著者エンティティ