Elastic Agent Skills

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

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

これらのスキルは早期リリースであり、活発に開発が進められています。スキルが堅牢な 評価とともに成文化され、モデルの状況が進化するにつれて変更が生じることを想定してください。更新については頻繁に確認してください。

概要

このリポジトリには、あらゆる AI エージェントに Elasticsearch、Kibana、Elastic Observability、Elastic Security を正しく扱う方法を教える、指示・コンテキスト・ツールをパッケージ化した厳選されたスキルが含まれています。すでに使用しているエージェントランタイムにこれらを導入すれば、アシスタントは古いパターンを使うのをやめ、正しく動作するようになります。

スキルとは？

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

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

対象範囲

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

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

利用可能なスキル

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

AI コーディングエージェントは、実際の認証情報、実際のシェルアクセス、そして多くの場合それを実行するユーザーの完全な権限で動作します。それらのエージェントがセキュリティワークフローに向けられると、リスクはより高くなります。そのため、始める前にリスクについて率直な議論を行う価値があります。

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

これらのスキルがオープンソースであるのは、まさにその動作を監査できるようにするためです。実行する前に読むことをお勧めします。

はじめに

Elastic スキルは、Claude Code ネイティブのプラグインシステム、npx を使った skills CLI、またはこのリポジトリをクローンして同梱のインストーラスクリプトを実行することでインストールできます。npx の方法では、環境で npx が利用可能な Node.js が必要です。

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

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

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

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

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

または、任意の Claude Code セッション内でインタラクティブなプラグインブラウザを使用します:``` /plugins

これは、設定されたすべてのマーケットプレイスから利用可能なプラグインを閲覧し、インストールするものを選択し、すでにインストールされているものを管理するためのメニューを開きます。

### GitHub Copilot CLI

GitHub Copilot CLI にはネイティブのプラグインシステムがあります。このリポジトリをマーケットプレイスソースとして追加します:```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 を参照してください。

問題

問題を見つけた、または提案がありますか？ issue を作成してください。確認いたします。

免責事項

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