エージェントスキル（Agent Skills）
概要
エージェントスキル（Agent Skills）は、AIエージェント の能力を モジュール化された再利用可能なパッケージ として拡張する仕組みです。指示・メタデータ・任意のリソース（スクリプト、テンプレート、参照資料）を1つのまとまりにし、エージェントが関連する場面で自動的に読み込んで使います。汎用的なエージェントを、ワークフロー・文脈・ベストプラクティスを備えた「専門家」へと変えるのが狙いで、AIエージェント の4要素（ナレッジ・スキル・ツール・UI）のうち「スキル」を具体化したものと言えます。Agent_Skills_Overview
仕組み：3階層の段階的ロード
スキルはファイルシステム上のディレクトリとして存在し、必要なものだけを段階的に読み込む（progressive disclosure）設計です。
- メタデータ（常時ロード） — YAML フロントマターが「いつ使うか」の発見情報を提供
- 指示（トリガー時ロード） —
SKILL.md本体に手順知識が入る - リソース・コード（必要時ロード） — 実行可能スクリプトや参照資料
この構造により、コンテキストを浪費せず必要な知識だけを供給できます（エージェントメモリ の文脈管理とも通じる）。Agent_Skills_Overview
設計のベストプラクティス（Claude Code の知見）
Anthropic は数百の内部スキルを運用した知見を公開しています。スキルは9カテゴリ（ライブラリ/API リファレンス、製品検証、データ取得・分析、業務プロセス自動化、コードscaffold、品質・レビュー、CI/CD・デプロイ、Runbook、インフラ運用）に整理されます。Claude_Code_Skills_Lessons
- 自明なことを書かない — 非自明な知識（gotcha・落とし穴）に焦点を当てる
- Gotchas セクション — よくある失敗ポイントを文書化する
- ファイルシステムで構造化 — 段階的開示を可能にする
- 過度に制約しない — Claude の振る舞いを縛りすぎない柔軟性
- モデル中心の説明 — Claude が「いつ使うか」を判断できる記述にする
- 決定論的な設定はスキルではなく
config.json等に持たせる
実践での活用
- 本番運用 — Dinii の社内調査 bot は「version: latest」で即反映される手順書としてスキルを配信（エージェンティックソフトウェア / Claude Code）
- ループエンジニアリング — 自動駆動するエージェントシステムの中核要素としてスキルを位置づける（エージェンティックソフトウェア）
- 知識管理 — Obsidian のスターターキットは数百のスキルで知的作業を自動化（Obsidian / パーソナルナレッジマネジメント）