Elastic Agent Skills

Elastic Agent Skills — Elasticを開発したチームによって構築された — は、ネイティブなプラットフォームの専門知識をAIコーディングエージェントに直接提供します。これは公式のAgent Skillsライブラリであり、Cursor、GitHub Copilot、Windsurf、Gemini CLIなどのエージェント型IDEと互換性があります。スキルはAgent Skillsオープン標準に従います。

[!NOTE] テクニカルプレビュー

これらのスキルは初期リリースであり、活発に開発中です。スキルが堅牢な評価とともに体系化され、モデルの状況が進化するにつれて変更が予想されます。最新情報は頻繁に確認してください。

概要

このリポジトリには、Elasticsearch、Kibana、Elastic Observability、Elastic Securityを正しく操作する方法を任意のAIエージェントに教える、厳選されたスキル（指示、コンテキスト、ツールのパッケージ）が含まれています。これらを既存のエージェントランタイムに追加すると、アシスタントは時代遅れのパターンを使うのをやめ、正しい方法で作業を開始します。

スキルとは？

スキルは自己完結型のパッケージであり、AIエージェントに特定のタスクを反復可能な方法で完了するための知識とツールを提供します。各スキルは独自のフォルダに存在し、エージェントが従うメタデータと指示を含むSKILL.mdファイルを持ちます。

Agent Skills標準の詳細については、agentskills.ioを参照してください。

範囲

このリポジトリのスキルは以下に焦点を当てています：

• Elasticsearch APIとの対話（検索、インデックス作成、クラスタ管理）
• アラート、コネクタなどのKibanaコンテンツの構築と管理
• Elastic Observability、Elastic Security、Agent Builderのパターン

利用可能なスキル

セキュリティに関する考慮事項

AIコーディングエージェントは、実際の資格情報、実際のシェルアクセス、そして多くの場合、実行しているユーザーの完全な権限で動作します。それらのエージェントがセキュリティワークフローに向けられると、リスクはより高くなります。開始する前にリスクについて率直な会話をすることが正当化されます。

• 独自の脅威モデリングを実施してください。 エージェントがアクセスできるデータ、実行できるアクション、予期しない動作をした場合に何が起こるかを評価してください。AIシステムを安全にデプロイするためのCISAの共同ガイダンスは良い出発点です。
• エージェントを通過するデータに注意してください。 セキュリティデータには、PII、コマンドラインに埋め込まれた資格情報、その他の規制対象データが含まれる可能性があります。エージェントがアラートやプロセスイベントをクエリすると、そのコンテンツはモデルのコンテキストに入り、サードパーティのAPIに送信される可能性があります。情報セキュリティおよびコンプライアンスチームを早期に関与させてください。
• これらのエージェントは攻撃者が制御する入力を処理します。 アラート、イベントフィールド、ファイルコンテンツには、攻撃者によって作成された文字列が定期的に含まれています。プロンプトインジェクションはここでは理論上のものではなく、動作環境の固有の特性です。Brainwormのような研究は、エージェントのコンテキストファイルだけがプロンプトウェアの永続化メカニズムとして機能できることを示しています。
• 権限を厳密にスコープしてください。 APIキーに必要な最小限の権限のみを付与してください。広範な応答権限は特に危険です。動作を検証するまで、読み取り専用アクセスが良いデフォルトです。
• エージェントのツールアクセスとネットワーク到達範囲を制限してください。 ほとんどのAIコーディングエージェントは広範なデフォルト（シェル実行、ファイルシステム書き込み、インターネットアクセス）を備えています。利用可能なツールサーフェスを減らすことで、侵害された、または誤った方向に導かれたエージェントができることを制限します。
• 非本番環境から開始してください。 Serverlessトライアルプロジェクト、開発クラスタ、または分離されたKibanaスペースを使用して、ライブセキュリティデータを運ぶものに接続する前にスキルを評価してください。

これらのスキルは、実行前に監査できるように正確にオープンソース化されています。実行する前に読むことをお勧めします。

はじめに

Claude Codeネイティブプラグインシステム、npxを使用したskills CLI、またはこのリポジトリをクローンしてバンドルされたインストーラスクリプトを実行することで、Elasticスキルをインストールできます。npxメソッドでは、環境でNode.jsとnpxが利用可能である必要があります。

[!TIP] すべてのスキルをインストールしないでください。 インストールされた各スキルは、エージェントがすべてのリクエストで評価するルーティングコンテキストを追加します。cloudおよびelasticsearch認証スキルをインストールしてください — 他のほとんどのスキルはそれらに依存しています — その後、ワークフローに関連するスキルのみを追加してください。インストールセットを絞り込むことで、コンテキストの肥大化を回避し、エージェントが適切なスキルに確実にルーティングするのに役立ちます。

Claude Codeプラグイン（Claude Codeユーザーに推奨）

Claude Codeには、スキルを直接管理するネイティブプラグインシステムがあります。まず、このリポジトリをマーケットプレイスソースとして追加します：```sh claude plugin marketplace add https://github.com/elastic/agent-skills

追加後、個々のプラグインを名前でインストールします:```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install cloud@elastic-agent-skills

[!NOTE] インストール後、/reload-plugins を実行してもスキルがすぐに表示されない場合があります。これは既知の Claude Code の問題です。新しくインストールしたプラグインを反映させるには、Claude Code セッションを再起動してください。

または、任意の Claude Code セッション内の対話型プラグインブラウザを使用します。``` /plugins

This opens a menu to browse available plugins from all configured marketplaces, select what to install, and manage what is already installed.

### GitHub Copilot CLI

GitHub Copilot CLI has a native plugin system. Add this repository as a marketplace source:```sh
copilot plugin marketplace add elastic/agent-skills

追加後、個々のプラグインを名前でインストールします:```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills

またはCopilotセッション内で利用可能なプラグインを対話的に閲覧できます：```
/plugin list

npx（推奨）

スキルをインストールする最も速い方法は、skills CLIを使用することです。このリポジトリをクローンする必要はありません。次のコマンドを実行するだけです：```sh npx skills add elastic/agent-skills

これは、スキルと[対象エージェント](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)を選択するための対話型プロンプトを起動します。CLIは、各スキルフォルダをエージェントが検出できる正しい場所にコピーします。

名前を指定して特定のスキルをインストールするには:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

@ ショートカットを使用して、スキルを直接 repo@skill として指定することもできます（--skill と同等です）：```sh npx skills add elastic/agent-skills@elasticsearch-esql

特定のエージェントにインストールする（[対応エージェント](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)を参照）：```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

利用可能なスキルをインストールせずに一覧表示する:```sh npx skills add elastic/agent-skills --list

すべてのエージェントにすべてのスキルをインストールします（非対話式）：```sh
npx skills add elastic/agent-skills --all

ローカルクローン

ローカルチェックアウトから作業したい場合、または環境に Node.js / npx がない場合は、リポジトリをクローンして同梱の bash インストーラーを使用してください：```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

このスクリプトにはbash 3.2以上と標準のUnixユーティリティ（`awk`、`find`、`cp`、`rm`、`mkdir`）が必要です。

| フラグ              | 説明                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | 対象エージェント（繰り返し指定可能）             |
| `-s, --skill`     | 名前を指定して特定のスキルをインストール       |
| `-f, --force`     | インストール済みのスキルを上書き    |
| `-y, --yes`       | 確認プロンプトをスキップ             |

利用可能なすべてのスキルを一覧表示：```sh
./scripts/install-skills.sh list

対応エージェント

スキルの更新

更新プロセスは、スキルがどのようにインストールされたかによって異なります。

Claude Code プラグイン

インストール済みのすべてのプラグインを最新バージョンに更新します。```sh claude plugin update

特定のプラグインを更新する:```sh
claude plugin update elastic-elasticsearch

プラグインを自動的に最新の状態に保つには、Claude Code内で/pluginsを使用して自動更新を有効にします。

自動更新がオンの場合、Claude Codeは起動時に新しいプラグインバージョンを確認し、バックグラウンドで更新します。

GitHub Copilot CLI

インストールされているすべてのプラグインを最新バージョンに更新します:```sh copilot plugin update

特定のプラグインを更新する:```sh
copilot plugin update elasticsearch

npx

インストール済みのスキルに上流での変更があるかどうかを確認します:```sh npx skills check

インストールされているすべてのスキルの最新バージョンを取得します:```sh
npx skills update

CLIは各スキルのソースリポジトリとコンテンツハッシュをロックファイルで追跡します。checkはローカルのハッシュをGitHubと比較し、updateは差分が生じたものを再ダウンロードします。

ヒント: デフォルトのnpxインストールはシンボリックリンクを使用するため、すべてのエージェントが単一の正規コピーを指します。一度更新すれば、すべてのエージェントが同時に更新されます。

ローカルクローン

--forceを指定してインストーラーを再実行すると、既存のスキルを上書きします。```sh git pull ./scripts/install-skills.sh add -a --force

`--force` を指定しない場合、スクリプトは既にインストールされているスキルをスキップします。

## スキル形式

各スキルフォルダには、YAML フロントマターと Markdown の説明を含む `SKILL.md` が含まれています。```yaml
---
name: elasticsearch-my-skill
description: >
  What the skill does AND when an agent should activate it.
metadata:
  version: 0.1.0
  visibility: public
---

# My Skill

[Instructions that the agent follows when this skill is active]

description フィールドが唯一のトリガーメカニズムです。エージェントランタイムはこれを読み取り、スキルをいつロードするかを決定します。完全なフォーマット仕様については、agentskills.io/specification を参照してください。

問題

問題が見つかった場合や提案がある場合は、イシューを開いて いただければ確認します。

免責事項

これらのスキルは現状のまま提供されます。重要なタスクで使用する前に、必ずご自身の環境でスキルを十分にテストしてください。