機能紹介編
AI コーディングエージェント（Claude Code、Cursor、GitHub Copilot など）は強力ですが、Elasticsearch や Kibana の使い方になると、うまくいかないことがあります。「この構文は合っているのか」「この API の呼び出し方でいいのか」といった疑問です。
Elastic Agent Skills は、この悩みを解決するために Elastic が公開した オープンソースのスキルパッケージ です。エージェントに Elastic の専門知識を直接与えることができます。
では、何ができるのか、どうインストールするのか、見ていきましょう。
Agent Skills とは？
まずシンプルに説明します。
Agent Skills は、AI エージェントに特定の領域の専門知識を教える「説明書」です。
各スキルは、以下を含む自己完結型のフォルダとして提供されます：
- SKILL.md ファイル — スキルの説明と指示が書かれた中心ファイル
- 補助スクリプトやリソース — 必要に応じて追加される
エージェントは起動時にスキルの name と description フィールドを読み込みます。そして、マッチするタスクが検出されたタイミングで、該当スキルの詳細な指示を動的に読み込みます。
この仕組みによって、エージェントは普段は軽量に動作しながら、必要なときだけ深い専門知識にアクセスできます。
Context Engineering というアプローチ
Agent Skills の考え方は「Context Engineering」という概念に基づいています。エージェントに正しい「文脈」を与えることで、より正確な結果を得るという考え方です。
Elastic Labs の記事には、次のように書かれています：
スキルが有効になると、エージェントは適切なタイミングで、適切な文脈（クエリ構文、API パターン、検証ロジック、実例）にアクセスできます。結果として、最初の試みで正しくタスクを完了できます。
なぜ Agent Skills が必要か
Elastic Labs の記事では、AI コーディングエージェントが Elastic のような特定プラットフォームで苦戦する理由を、3 つ挙げています。
課題 1：ES|QL は新しい領域
Elasticsearch 独自のクエリ言語 ES|QL は、LLM にとって馴染みが薄い言語です。
LLM は主に SQL で訓練されていますが、ES|QL はパイプベースのクエリ言語で、構文も関数もセマンティクスも異なります。エージェントは、もっともらしく見えるがパースできないクエリを書くことが多くあります。
Agent Skills はこのギャップを埋めます。
課題 2：API サーフェスが広く深い
Elasticsearch、Kibana、Elastic Security は、数多くの API を公開しています。
Elasticsearch、Kibana、Elastic Security は、検索、取り込み、アラート、検出ルール、ケース管理、ダッシュボードなど、数百の API を公開しています。
一般的な訓練データだけを持つエージェントは、どのエンドポイントを呼び出すべきか、リクエストボディはどう構成すべきかを推測で判断することになります。
課題 3：ベストプラクティスは訓練データにない
semantic_text を使うべきか、カスタム埋め込みパイプラインを使うべきか？ 10GB の CSV にはどんな ingest pipeline を構成すべきか？ 汎用エージェントは、こういった Elastic 固有の知識を、整理された形で持っていません。
Agent Skills でカバーされている領域
Elastic が公開している Agent Skills は、以下の領域をカバーしています（v0.1.0 初回リリース時点）。
- Elasticsearch API との対話（検索、インデックス管理、クラスタ管理）
- Kibana のコンテンツ管理（ダッシュボード、アラート、コネクタなど）
- Elastic Observability のドメイン専門知識
- Elastic Security のドメイン専門知識
- Agent Builder 内で効果的なエージェントを作る知識
スキルは組み合わせ可能（Composable）
スキルは、モノリシックではなく、モジュラーに設計されています。エージェントは、手元のタスクに関連するスキルだけを読み込みます。
ES|QL クエリを書いているとき？ES|QL スキルが有効になります。結果からダッシュボードを作りたい？ダッシュボードスキルが引き継ぎます。セキュリティアラートを調査中？トリアージスキルが、調査の進行に応じてケース管理や応答スキルに連鎖します。
インストール方法
では、実際にインストールしてみましょう。
準備：Node.js が必要
Agent Skills をインストールするには、npx が必要です。まず確認しましょう。
node –version
npm –version
どちらも出力されれば OK です。なければ nodejs.org からインストールしてください。
方法 1：npx を使う（推奨）
最も簡単な方法です。以下のコマンドを実行してください。
npx skills add elastic/agent-skills
このコマンドを実行すると、対話的なプロンプトが表示され、スキルと対象エージェントを選択できます。
オプション：特定のスキルだけをインストール
すべてのスキルが必要ではない場合、個別にインストールできます。
# Elasticsearch ES|QL スキルだけ
npx skills add elastic/agent-skills@elasticsearch-esql
# 複数指定
npx skills add elastic/agent-skills -s elasticsearch-esql -s kibana-dashboards
オプション：特定のエージェントにインストール
複数のエージェントを使っている場合、特定のものだけをターゲットできます。
# Claude Code と Cursor にインストール
npx skills add elastic/agent-skills -a claude-code -a cursor
方法 2：ローカルで管理したい場合
Node.js がない環境、または git で管理したい場合は、リポジトリをクローンできます。
git clone https://github.com/elastic/agent-skills.git
cd agent-skills
./scripts/install-skills.sh add -a <agent-name>
サポートされているエージェント
Agent Skills は、複数の AI コーディングエージェントで動作します。
| エージェント | インストール先 |
|---|---|
| Claude Code | .claude/skills |
| Cursor | .agents/skills |
| GitHub Copilot | .agents/skills |
| Windsurf | .windsurf/skills |
| Codex | .agents/skills |
| OpenCode | .agents/skills |
| Cline | .agents/skills |
| Gemini CLI | .agents/skills |
| Roo | .roo/skills |
スキルを最新に保つ
Elastic Agent Skills は定期的に更新されます。
npx でインストールした場合
最新バージョンをチェック：
npx skills check
アップデート：
npx skills update
ローカルクローンの場合
git pull
./scripts/install-skills.sh add -a <agent-name> –force
–force フラグにより、既存のスキルが上書きされます。
セキュリティに関する重要な注意事項
Elastic Labs の記事には、使用する前の注意として、次のように書かれています。
AI コーディングエージェントは、実際の認証情報、実際のシェルアクセス、そして多くの場合、実行しているユーザーの完全な権限で動作します。エージェントをセキュリティワークフローに向けるとき、リスクは高まります。検出ロジック、応答アクション、機密性の高いテレメトリーへのアクセスを、自動化システムに渡すことになるからです。
特にセキュリティ系のワークフローで使う場合は、以下を評価するよう推奨されています：
- エージェントがアクセスできるデータは何か
- エージェントが取ることのできるアクションは何か
- エージェントが予期せぬ挙動をした場合、何が起こるか
まとめと次のステップ
Agent Skills とは：
- AI コーディングエージェント（Claude Code、Cursor など）に Elastic の専門知識を与えるスキルパッケージ
- オープンソース、Apache 2.0 ライセンス
- Elasticsearch、Kibana、Observability、Security、Agent Builder など複数の領域をカバー
インストール方法：
- npx skills add elastic/agent-skills で簡単インストール
- 複数のエージェントに対応
次のステップ：
Part 2 では、実際に Claude Code で Agent Skills を使いこなす方法 を紹介します。
参考資料
本記事の執筆に使用した参考資料：
Elastic 公式ドキュメント：
Elasticsearch Labs ブログ：
GitHub リポジトリ：
